Connect Mercury to Claude Code
Read bank accounts, balances, transactions, statements, recipients and receivables invoices. Add Toolspoke to Claude Code once and it can use 18 Mercury actions. Your Mercury credential stays in Toolspoke, and you choose which actions Claude Code may call.
Set it up in Claude Code
Three steps, the first one once for every toolkit you will ever add.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
Install Mercury and connect it
Add Mercury to a project in your Toolspoke workspace.
API token. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.
- API token
- Mercury → Settings → Tokens (app.mercury.com/settings/tokens) → Create an API Token, and choose Read Only. Paste the whole value, including the secret-token: prefix. Read Only covers every operation here except update_transaction and cancel_invoice, which need a Read and Write or Custom token.
Choose what Claude Code may do
All 18 actions start on. Switch off any of the 2 actions that change something in Mercury, and Claude Code gets a refusal if it tries.
What you can ask Claude Code for
A few of the Mercury actions that only read, so they are safe to try first.
- List the organization's Mercury deposit accounts with their current and available balances, status and kind
- Retrieve one account by id, with its balances, status and dashboard link
- List the debit and credit cards issued against one account, with cardholder, status and last four digits
- List the monthly statements for one account, optionally inside a date window
What Claude Code can do in Mercury
16 actions read, one writes and one deletes or permanently changes something.
Reads
List accounts
List the organization's Mercury deposit accounts with their current and available balances, status and kind. Takes no arguments, which is why it is the connection test: it proves the token reaches real account data, not only that it exists. The account id it returns is what every per-account operation takes.
Get account
Retrieve one account by id, with its balances, status and dashboard link.
List account cards
List the debit and credit cards issued against one account, with cardholder, status and last four digits.
List account statements
List the monthly statements for one account, optionally inside a date window. Returns statement metadata and ids, not the PDF.
List transactions
List transactions across every account, newest first unless order says otherwise. Narrow it with start and end (creation date) or posted_start and posted_end (posting date) before anything else; a busy organization has thousands a month. Each row names the counterparty, the amount, the status and the category. Page with start_after, passing the last transaction id seen.
List account transactions
List the transactions on one account, filtered by date window, status or a search term. Pages by offset rather than cursor.
Get transaction
Retrieve one transaction by id, with its attachments, check images, category and the counterparty's details.
List categories
List the organization's custom expense categories, whose ids update_transaction takes.
List recipients
List the payment recipients saved on this organization, the people and companies it pays, with their default payment method and when each was last paid.
Get recipient
Retrieve one recipient by id, including its addresses and routing details.
List credit accounts
List the organization's Mercury credit accounts with their balances and limits.
List treasury accounts
List the organization's Mercury Treasury accounts with their balances.
Get organization
Retrieve the organization's legal business name, DBAs and subscription tier. The EIN is masked in the audit log.
List customers
List the accounts-receivable customers this organization invoices, with their names, emails and addresses.
List invoices
List accounts-receivable invoices with their customer, amount, due date and payment status.
Get invoice
Retrieve one accounts-receivable invoice by id, with its line items, recipients and payment state.
Writes
Update transaction
Set or clear a transaction's note and custom category. A write rather than destructive: it changes bookkeeping metadata only, moves no money, and can be set back. Send null to clear a field.
Deletes or permanently changes
Cancel invoice
Cancel an accounts-receivable invoice. Destructive because Mercury documents it as irreversible: the customer can no longer pay it, and a cancelled invoice cannot be reopened.
Mercury in Claude Code: questions
Does Claude Code see my Mercury credential?
No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.
Can I stop Claude Code from changing things in Mercury?
Yes. Each of the 18 actions can be switched off for a project. Turn off the 2 that change something and Claude Code can only read.
Will 18 actions crowd Claude Code's context?
No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Mercury action it needs when it needs it. Adding more toolkits does not add more tools to its list.
Can I add it once for every project?
Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.
What does it cost?
Tool calls are free on every plan, and a Mercury call does not run in a sandbox, so it bills nothing.
Mercury in your other apps
Try Mercury in Claude Code
Free to start, and tool calls cost nothing on any plan.