Answers
Can an agent try a spend check before it has an API key?
Can an agent try a spend check before it has an API key?
Yes. Call the MCP tool try_check on https://screwtape.ai/mcp. It needs no key and runs one sample check on a fixed demo invoice, so the agent learns the response shape (duplicate.status, checks, next_step.action) before it asks for a key.
Example
curl -s https://screwtape.ai/mcp -H 'Content-Type: application/json' -H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"try_check","arguments":{"scenario":"duplicate"}}}' \
| jq '.result.structuredContent | {duplicate, next_step}'scenario is duplicate (the default: the invoice paid earlier as INV-0042 comes back as INV 42, so the answer is escalate), clean (pass) or bad_total (the line items do not add up, so retry).
Limits
- 5 calls per hour per IP and per MCP session. Over the limit is a JSON-RPC 429 with
retry_after, aRetry-Afterheader andnext_action. - It only checks the fixed demo invoice. Any other argument is rejected. There is no receipt and nothing is stored.
Next step
Get a free key (10 calls per UTC day) with the MCP tool get_api_key or POST https://screwtape.ai/v1/signup, then call check_duplicate_invoice on your own invoices.
FAQ
Does try_check use my free quota?
No. It needs no key, does not read one, and is capped at 5 calls per hour per IP and per MCP session instead.
Can I send my own invoice to try_check?
No. It only checks the fixed demo invoice. Use check_duplicate_invoice with a free key for your own invoices.
Related
Screwtape.ai is an agent validation API. Facts checked against the API source on 2026-11-02.
