API keys & MCP for agents

Create a workspace key

API keys start with rp_ and belong to one tenant, or workspace. In the current app, open Integrations and find API access (MCP). Key creation is here, rather than the Settings page.

  1. Select the workspace the agent should access.
  2. Give the key a label and choose Create key.
  3. Copy it once into your client's secure credential setting. Only a hash is stored; the full key is shown once.

Connect your agent to MCP

Use https://app.receiptpair.com/mcp as the endpoint and pass the key as a bearer token. The endpoint accepts MCP requests over HTTP. Each request uses the tenant attached to the key.

What agents can do

Read tools cover search transactions, transaction details, missing receipts, books health, and VAT or spending summaries. Searches return up to 100 transactions per call.

Two write tools exist: approve_transaction files an attached receipt to your accounting system, and attach_inbound_receipt links a parked inbound receipt to a charge by its SHA-256. Both apply the same guards as the app: they act only on eligible transactions, write an audit event, and cannot touch other workspaces.

Limits and revocation

MCP requests are limited to 120 per minute per API key. If a request is rate limited, pause before retrying. Revoke an unused or exposed key from the same API access card and create a replacement if needed.

For phone capture, see Agents and Telegram. For missing documents, see the missing receipt report.

© 2026 Receipt Pair · receiptpair.com