What is Mercury MCP?
Learn how to connect AI agents to your Mercury accounts.
The Mercury MCP is currently in Beta as we understand the limitations of chat models. Double check any responses from the LLM with your Mercury account for any important decisions.
Connect your AI tools to Mercury accounts using the Model Context Protocol , an open standard that lets AI assistants interact with your accounts, transactions, recipients, cards and more.
What is Mercury MCP?
Mercury MCP is a hosted server that connects AI tools such as ChatGPT and Claude to your Mercury account through OAuth. You can ask questions about your finances and authorize supported actions: request payments and internal transfers, create or edit custom expense categories, update transaction notes and categories, manage budgets, upload and match receipts, and submit, approve, and deny reimbursements. Available tools depend on your account type and the permissions you grant.

Mercury MCP connects your AI tools to Mercury's public API through OAuth. Supported write actions require explicit permissions; payment and transfer requests require approval in Mercury.
Why use Mercury MCP?
- Easy setup — Connect through OAuth, with safe and secure one-click installation for supported AI tools
- Optimized for AI — Built specifically for AI agents with efficient data formatting
- Powerful data - Detailed transaction reporting on categories, merchants, users, cards and more available to query
What can you do with Mercury MCP?
- Understand your spend - we built transactions reporting to give you the ability to quickly access and understand spend across your business, with fast responses and detailed metadata.
- Track your balance - access account balances and statement information
- Quick access to card and recipient details - grab the details of who you are paying and what cards are currently active
- Prepare payments - request a payment to an existing recipient, then review and approve it in Mercury
- Prepare internal transfers - request a transfer between your own Mercury accounts, then review and approve it in Mercury
- Organize your transactions - create or edit custom expense categories, update transaction notes and categories, manage budgets, and upload and match receipts
- Handle reimbursements - submit a reimbursement, then approve, deny, or mark it paid outside Mercury
How actions work
Payments and transfers require approval in Mercury. Your AI tool creates a payment or transfer request but cannot approve it, so no money moves until someone approves it in Mercury. Your organization's approval policies still apply. If those policies would otherwise allow the action without approval, the requester must approve it in Mercury.
Category, note, budget, receipt, and reimbursement changes apply immediately. With the required permissions, your AI tool can create or edit custom categories, update transaction notes and categories, manage budgets, and match receipts. It can also submit, deny, or mark reimbursements paid outside Mercury. None of these needs a separate approval in Mercury.
Approving a reimbursement queues a payout. If you can approve reimbursements in Mercury, your AI tool can approve one. Mercury then pays it from the reimbursement account with no separate approval step.
For example, ask “Request a $500 payment to Acme from my checking account,” then review the request in Mercury. Or ask “Categorize this transaction as Software” to update its category directly.
See Supported tools for the actions, required permissions, and example prompts.
Get started
Follow Connecting Mercury MCP to connect your AI tool. If you already have a read-only connection, reauthorize it through your AI tool's connection settings and review the write permissions on Mercury's consent screen. Existing connections do not gain write access automatically.
Read Security best practices before granting access.
Updated 3 days ago

