Agents and Telegram

Photograph receipts into Telegram, and let AI agents query your books through the MCP server.

Telegram capture

Receipts that only exist on paper get photographed. The Receipt Pair Telegram bot turns a phone photo into the same pipeline everything else uses: PDF conversion, deduplication, reading, matching.

1. Open Integrations in the app and generate a link code under Telegram.
2. Send /start YOUR-CODE to the bot. Codes are single-use and expire after 15 minutes.
3. Send the bot any receipt photo or document. It replies with where the file landed — matched to a charge and queued for review, or parked in inbound until the charge appears.

One chat links to one workspace; a workspace can have several chats (you, a partner, an employee who travels).

The MCP server: AI agents read your books

Receipt Pair exposes a Model Context Protocol endpoint at https://app.receiptpair.com/mcp so an AI assistant can answer "what am I missing?" or "what did we spend at airlines this quarter" against live data — read-only, always scoped to your workspace.

Creating an API key

1. Integrations → API keys → create key. Copy it once; only its hash is stored.
2. Keys are workspace-scoped, rate-limited (120 requests/minute), and revocable any time from the same card.

Point any MCP-capable client at the endpoint with the key as a bearer token. Supported methods: initialize, tools/list, tools/call (protocol 2025-03-26).

The six tools

• search_transactions — filter by merchant, status, period.
• get_transaction — one transaction with its receipt facts and VAT fields.
• list_missing_receipts — the current chase list.
• get_books_health — coverage score, aging buckets, VAT at risk, duplicates.
• get_vat_return — the return basis per currency for a period.
• get_spend_summary — totals by merchant or category for a period.

Agents can read, never write: no tool can edit a transaction, send mail, or file to your books.