API keys & MCP for agents

Connect agents with a workspace API key, search receipts through MCP, and understand which actions still need the app.

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.

Select the workspace the agent should access.
Give the key a label and choose Create key.
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

The shipped MCP tools are read only: search transactions, open transaction details, list missing receipts, check books health, and retrieve VAT or spending summaries. Searches return up to 100 transactions per call.

There are no MCP tools to approve transactions or attach receipts. Use the app to review and approve a match, or attach a parked receipt to a charge. An API key does not grant those app actions.

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.