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.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. 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.
  3. 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.

Try Mercury in Claude Code

Free to start, and tool calls cost nothing on any plan.