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

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.