Supported tools on Mercury's MCP

Learn what you can do with Mercury's MCP tools.

Mercury MCP lets your AI tool read financial data and perform supported actions. Available tools depend on your account type, Mercury permissions, and the OAuth scopes granted to your connection.

Write actions

Mercury MCP supports the following write tools. Existing connections must reauthorize before they can use a write tool whose scope they were not granted. Budget, receipt, and reimbursement tools are available only for business accounts.

Books tools are available when your organization has an active Books subscription and your Mercury role can manage Books, code transactions, and manage accounting integrations, and can see all accounts. See Books MCP Setup to connect.

ToolRequired OAuth scopeWhat happens
requestSendMoneytransactions:requestCreates a payment request to an existing recipient. Requires approval in Mercury before money is sent.
requestTransferMoneytransfers:requestCreates a transfer request between your own Mercury accounts. Requires approval in Mercury before money moves.
createCategorycategories:createCreates a custom expense category immediately. No separate approval in Mercury.
editCategorycategories:editUpdates a custom expense category immediately. No separate approval in Mercury.
updateTransactiontransactions:updateUpdates or clears an existing transaction's note or category immediately. No separate approval in Mercury.
createBudgetbudgets:manageCreates a budget as a draft. Add members and publish the budget from the Mercury dashboard. Requires approval in Mercury before money movement is possible.
updateBudgetbudgets:manageUpdates a budget's name, description, amount per user, frequency, or dates immediately. A published budget gets a new version.
archiveBudgetbudgets:manageArchives a published budget or deletes a draft budget immediately.
assignTransactionToBudgetbudgets:manageAssigns a transaction to a budget immediately. The transaction moves off any budget it was on before.
createReceiptUploadUrlreceipts:manageCreates a receipt and returns a link to upload the receipt file. The link expires after five minutes.
matchReceiptreceipts:manageReads an uploaded receipt and matches it to one of your organization's transactions. Use getReceipt to check the result.
createReimbursementreimbursements:manageSubmits a reimbursement in your name immediately. Only you can edit or cancel it.
updateReimbursementreimbursements:manageReplaces your reimbursement's fields immediately. Leaving out the notes or category clears them. Only reimbursements still in review can be edited.
cancelReimbursementreimbursements:manageCancels your reimbursement immediately. Only reimbursements still in review can be canceled.
approveReimbursementreimbursements:manageApproves a submitted reimbursement immediately and queues a payout from the reimbursement account. No separate approval in Mercury.
denyReimbursementreimbursements:manageDenies a submitted reimbursement immediately. Mercury records the reason as a reviewer comment.
markReimbursementPaidreimbursements:manageRecords immediately that the submitter was paid outside Mercury, for example by check or payroll. Mercury does not pay the reimbursement.
categorizeBooksTransactionsbooks_transactions:categorizeCategorizes or splits up to 100 bank or card transactions to GL accounts immediately. All or nothing: if any item is invalid, no transaction changes. Replaces the transaction's current categorization, and the last write wins.
createBooksCategorizationRulebooks_categorization_rules:createCreates a rule that automatically categorizes future imported transactions to a GL account. Does not recategorize existing transactions.
deleteBooksCategorizationRulebooks_categorization_rules:deleteDeletes a categorization rule immediately. Transactions it already categorized keep their categories.
bulkCreateBooksJournalEntriesjournal_entries:createCreates one or more journal entries immediately. Each entry is a balanced set of debits and credits to ledgers that are not read-only.
bulkUpdateBooksJournalEntriesjournal_entries:updateUpdates the date, description, or review status of existing journal entries, and adds, edits, or removes their line entries immediately.
bulkDeleteBooksJournalEntriesjournal_entries:deleteDeletes journal entries immediately.
createBooksLedgersledgers:createAdds GL accounts to your chart of accounts. Each account succeeds or fails on its own.
updateBooksLedgersledgers:updateRenames, renumbers, re-parents, or retypes GL accounts. Required accounts allow changes only to name, number, and parent.
deleteBooksLedgersledgers:deleteDeletes GL accounts. GL accounts with activity, child accounts, a linked bank or card, or an integration mapping are skipped with a reason. Never deletes journal entries.
setBooksLedgerOpeningBalancesledgers:updateSets or clears the opening balance of up to 100 GL accounts. A balance of 0 clears it. Each account succeeds or fails on its own. Can’t be set on accounts linked to a Mercury account or card.1
createBooksBillaccrual_sources:createCreates a bill (accounts payable) for a vendor, with a bill date, due date, and one or more lines, and posts the matching journal entry.
updateBooksBillaccrual_sources:updateEdits a bill’s vendor, reference number, dates, notes, or lines. Cancelled bills can’t be edited; paid bills accept only line account changes.
createBooksInvoiceaccrual_sources:createCreates an invoice (accounts receivable) for a Mercury Invoicing customer, with an invoice number, dates, and one or more lines, and posts the matching journal entry.
updateBooksInvoiceaccrual_sources:updateEdits an invoice’s reference number, customer, dates, notes, or lines. Cancelled invoices can’t be edited; paid invoices accept only line account changes.
createBooksPaymentApplicationspayment_applications:createMatches a transaction to the bills or invoices it paid. Replaces the transaction’s current categorization, including any split.
deleteBooksPaymentApplicationspayment_applications:deleteUnmatches a transaction from every bill or invoice it was matched to. The transaction becomes uncategorized, so categorize it again afterward.

Example prompts2

  • Request a payment: “Request a $500 payment to Acme from my checking account.” The recipient must already exist in Mercury.
  • Request an internal transfer: “Request a $1,000 transfer from my Mercury checking account to my Mercury savings account.”
  • Create a category: “Create a custom expense category called Software.”
  • Edit a category: “Rename my Software category to Software subscriptions.”
  • Update a transaction: “Categorize this transaction as Software subscriptions and add the note Annual renewal.”
  • Create a budget: “Create a monthly Team lunches budget of $200 per person, starting December 1.”
  • Update a budget: “Raise the Team lunches budget to $250 per person.”
  • Archive a budget: “Archive the Offsite 2026 budget.”
  • Assign a transaction to a budget: “Add yesterday's Sweetgreen charge to the Team lunches budget.”
  • Upload and match a receipt: “Upload this receipt and match it to the right transaction.”
  • Submit a reimbursement: “Submit a $42.50 reimbursement for lunch at Sweetgreen on November 10.”
  • Approve a reimbursement: “Approve Jordan's reimbursement for the Sweetgreen lunch.”
  • Deny a reimbursement: “Deny the $300 taxi reimbursement and say it needs an itemized receipt.”
  • Mark a reimbursement paid outside Mercury: “Mark Jordan's Sweetgreen reimbursement as paid outside Mercury. We paid it through payroll.”

Review and approve a payment or transfer

  1. Ask your AI tool to prepare the request.
  2. Open Mercury.
  3. Find the request under Needs approval in Tasks or Payments.
  4. Review the recipient or destination account, amount, payment method, and timing.
  5. Approve the request if the details are correct and you are an eligible approver.
  6. Check the request or payment status 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. Your AI tool cannot approve the request, so no money moves until someone approves it in Mercury. A confirmation in chat is not approval in Mercury, and “request created” does not mean “payment sent.”

Use listSendMoneyApprovalRequests or getSendMoneyApprovalRequest to check payment requests. Use listTransferMoneyApprovalRequests or getTransferMoneyApprovalRequest to check internal transfer requests. Check for an existing request before creating another one after an uncertain result.

Upload and match a receipt

  1. Your AI tool calls createReceiptUploadUrl with the file name.
  2. Your AI tool uploads the receipt file to the returned link within five minutes.
  3. Your AI tool calls matchReceipt to read the receipt and find the matching transaction.
  4. Your AI tool calls getReceipt until matching is complete.
  5. Check the matched transaction in Mercury.

Your AI tool must be able to upload a file to a web link. If the link expires, your AI tool can request a new link for the same receipt. Only the person who uploaded a receipt can start matching it.

Manage budgets

createBudget creates a draft. Mercury MCP cannot add budget members or publish a budget. Do these steps in the Mercury dashboard.

After a budget is published, its frequency cannot change. If a budget is linked to an active agent card, you can change only its name and description, and you cannot archive it.

assignTransactionToBudget does not let a transaction exceed the budget unless you ask your AI tool to allow overspending.

Submit and review reimbursements

createReimbursement submits a reimbursement in your name. It needs the amount, currency, the date you spent the money, and the merchant name. You can also add a category and notes. Only you can edit or cancel the reimbursement, and only while it is still in review.

To approve or deny a reimbursement, you need the Reimbursement approval and submission or Policy management and approval permission and access to your organization's reimbursement account. Marking a reimbursement paid outside Mercury needs the same permission but not access to the reimbursement account. You can approve your own reimbursement only if your organization allows it or has only one admin. denyReimbursement requires a reason, which Mercury records as a reviewer comment.

Approving a reimbursement queues a payout. Unlike payments and transfers, it has no separate approval step in Mercury. Mercury pays approved reimbursements from the reimbursement account in a batch each weekday at 1:49 PM Eastern. A payout waits for a later batch when the reimbursement account can't cover it or the submitter has no verified payout account.

markReimbursementPaid records that the submitter was paid outside Mercury, for example by check or payroll. Mercury won't pay the reimbursement, and its payment status reads paidOutsideMercury. You can't mark a reimbursement that is denied or canceled, or one with a Mercury payment in progress or completed. Mercury records the optional note as a reviewer comment. Approving or denying the reimbursement afterward undoes the mark.

Use getReimbursement to check a reimbursement's status. listReimbursements and getReimbursement require permission to see all expenses. The status fields are:

  • reviewStatus is submitted, updatesRequested, approved, denied, or canceled.
  • paymentStatus is pending, initiated, paid, failed, or paidOutsideMercury. An approved reimbursement stays pending until its payout batch starts.

Manage your books

Books changes post to your general ledger immediately and show up in reports as soon as the tool runs, so ask your AI tool to show you what it plans to change before it applies anything, especially for bulk changes.

  • Categorize a transaction: “Categorize last Tuesday's AWS charge as Software & Hosting.”
  • Split a transaction: “Split the $1,200 Delta charge: $900 to Travel and $300 to Meals.”
  • Clean up uncategorized transactions: “Clean up all uncategorized transactions from October.”
  • Create a rule: “Create a rule that categorizes every Gusto debit to Payroll Expenses.”
  • Delete a rule: “Delete the rule that sends Uber charges to Travel.”
  • Record a journal entry: “Record October depreciation of $2,500: debit Depreciation Expense, credit Accumulated Depreciation.”
  • Edit a journal entry: “Move the October rent accrual to October 31 and mark it reviewed.”
  • Delete a journal entry: “Delete the duplicate payroll accrual I posted on November 1.”
  • Add a GL account: “Add an operating expense account called Contractors with account number 6150.”
  • Update a GL account: “Rename 6150 Contractors to Contract Labor and nest it under Professional Services.”
  • Delete a GL account: “Delete every expense account with no activity.”
  • Record a bill: “Add a $4,200 bill from Acme Legal dated November 1, due November 30, to Professional Services.”
  • Match a payment: “Match yesterday’s $4,200 payment to Acme Legal against their open bill.”
  • Check receivables: “Which invoices are overdue?”

Limitations on write actions

These write tools do not create recipients, delete categories, issue or manage cards, send invoices through Mercury Invoicing, add budget members, or publish budgets. They also cannot attach files to a reimbursement, request updates from a submitter, or submit or edit mileage reimbursements. The public API has capabilities that are not exposed as MCP write tools. Category, transaction, budget, receipt, reimbursement, and Books changes can overwrite existing values; they do not wait in Mercury's approval queue.

The Books tools do not close or lock periods, reconcile accounts, match or unmatch transfers between accounts, mark a bill or invoice paid without a matching transaction, create tags, connect or unlink bank and card feeds, or edit an existing rule. Each connection acts on one organization's books, so accounting firms connect once per client organization.

  • Categorizing transactions. Splits must add up to exactly the transaction amount. A transaction matched to a transfer between accounts must be unmatched in Books first; one matched to a bill or invoice must be unmatched with deleteBooksPaymentApplications first. Transactions can’t be categorized to an uncategorized account, an accounts receivable or payable account, the opening balances account, or a bank or card account.
  • Categorization rules. A rule applies only to transactions categorized after it is created. Every condition on a rule must match, so write an “any of” rule as separate rules. To edit a rule, delete it and create a new one.
  • Chart of accounts. Required accounts can’t be deleted and allow changes only to name, number, and parent. Accounts linked to a Mercury bank or card are read-only.
  • Bills and invoices. Invoices use Mercury Invoicing customers; bills use Books vendors or Mercury recipients. Matching a transaction to a bill or invoice replaces its categorization, including any split; unmatching leaves it uncategorized. Paid items accept only line account changes, and a partially paid item can’t drop below what has already been paid.

See Security best practices for access controls and write-action risks.

Read tools

Use prompts such as “What's my balance today?” or “Show my recent transactions.” Business-specific tools are only available for eligible business accounts. Read tools use the read scope.

NameDescriptionSample Prompt
getCurrentDateGet the current date - Retrieve today's date so that your AI tool uses correct date ranges"What did I spend in the last 30 days?"
getAccountGet account by ID - Retrieve details of a specific Mercury account using its account ID"What's the balance in my checking account?" or "Show me details for account abc123-xyz"
getAccountCardsGet cards for account - Retrieve all debit and credit cards associated with a specific account"What cards are linked to my main account?" or "Show me all debit cards for account abc123"
getAccountStatementsGet account statements - Retrieve monthly statements for a specific account. Supports date range filtering"Get my account statements from January through March" or "Show me last quarter's statements"
getTransactionGet transaction by ID - Retrieve details of a specific transaction using account ID and transaction ID"Get more details about transaction txn789" or "Why was I charged $150 on transaction xyz?"
getAccountsGet all accounts - Retrieve a list of all Mercury accounts for the organization"Show all my Mercury accounts" or "What accounts do I have?"
getCashflowSummaryGet cashflow summary - Retrieve monthly money in, money out, and net cashflow for up to 12 months. Excludes transfers between your own Mercury accounts"Chart my cash in and cash out for the last 6 months" or "What was my net burn last quarter?"
listCategoriesList all categories - Retrieve a list of all available custom expense categories for the organization. These are custom categories different from Mercury's built-in categories"What expense categories do I have set up?" or "Show me my custom spending categories"
listCreditList all credit accounts - Retrieve a list of all credit accounts for the organization"How much credit do I have available?" or "Show me my credit card accounts"
getCreditAccountStatementsGet credit account statements - Retrieve monthly statements for a Mercury credit account, including the billing period and the opening and closing balances"Show my credit card statements from this year" or "What was my credit balance at the end of September?"
getOrganizationGet organization information - Retrieve information about your organization including EIN, legal business name, and DBAs"What's my company's EIN?" or "Show me my business information"
getRecipientGet recipient by ID - Retrieve details of a specific recipient by ID"What are the payment details for Acme Corp?" or "Show me recipient rec456"
getRecipientsGet all recipients - Retrieve a list of all recipients"List all my payment recipients" or "Find recipient named Acme Corp"
getRecipientInviteGet recipient invite by ID - Retrieve details of a specific invite that asks a recipient to add their payment details"Has Acme completed the payment details invite I sent?"
listRecipientInvitesList recipient invites - Retrieve a list of all recipient invites for your organization. Supports filtering by status"Which recipient invites are still open?" or "Show me expired recipient invites"
listTransactionsList all transactions - Retrieve transactions with advanced filtering by date ranges, status, categories, and cursor-based pagination. Automatically handles pagination for complete results"Graph my last 6 months of transactions" or "Show pending transactions from last week"
getTreasuryGet all treasury accounts - Retrieve all treasury accounts associated with the authenticated organization. Personal accounts see this tool as getInvest"How much do I have in treasury?" or "Show me my treasury accounts and balances"
getTreasuryTransactionsGet treasury transactions - Retrieve paginated treasury transactions for a specific treasury account. Personal accounts see this tool as getInvestActivity"Show me recent treasury account activity" or "What are my treasury transactions this month?"
getCardGet a card - Retrieve details of a specific card by its ID"Show me details for card card456" or "What's the status of my company card?"
listCardsList cards - Retrieve a paginated list of cards"Show me all the cards on our account" or "List every debit and credit card we have"
listMerchantsList merchants - Retrieve a list of merchants that you can use for card spend controls, such as locking a card to a merchant. Supports search by merchant name"Is AWS a merchant I can lock a card to?" or "Find the merchant entry for 1Password"
getUserGet user by ID - Retrieve details of a specific user using their user ID"Show me details for user usr123" or "What role does user usr123 have on our account?"
getUsersGet all users - Retrieve a list of all users for the organization"List everyone with access to our Mercury account" or "Who are the users on our account?"
getWebhookGet webhook endpoint by ID - Retrieve details of a specific webhook endpoint by ID"Show me details for webhook endpoint wh123" or "What events is this webhook subscribed to?"
getWebhooksGet webhook endpoints - Retrieve a list of all webhook endpoints for your organization. Supports filtering by status"List all my webhook endpoints" or "Which of my webhooks are currently active?"
getTransactionByIdGet a transaction by ID - Retrieve a single transaction by its ID, including attachments, check images, and related metadata"Show me the check image for transaction txn789" or "Get the full details for transaction txn789, including attachments"
listSendMoneyApprovalRequestsList send money approval requests - Retrieve a list of send money approval requests for the organization. Supports filtering by account and status"Show me pending send money approval requests" or "What payments are waiting for approval?"
getSendMoneyApprovalRequestGet send money approval request by ID - Retrieve details of a specific payment request, including its approval progress"Has my $500 payment request to Acme been approved?"
listTransferMoneyApprovalRequestsList transfer approval requests - Retrieve a list of internal transfer approval requests. Supports filtering by source account, destination account, and status"Show me pending transfers between my accounts"
getTransferMoneyApprovalRequestGet transfer approval request by ID - Retrieve details of a specific internal transfer request"What's the status of my transfer request to savings?"
getSafeRequestGet SAFE by ID - Retrieve a specific SAFE request by its ID"Show me the details of SAFE request safe123" or "What are the terms of this SAFE agreement?"
getSafeRequestsGet all SAFEs - Retrieve all SAFE (Simple Agreement for Future Equity) requests for your organization"List all our SAFE agreements" or "How many SAFEs has our company issued?"
listRecipientsAttachmentsList all recipient attachments - Retrieve a list of all recipient tax form attachments across all recipients in the organization"List all the tax form attachments for my recipients" or "Do I have a W-9 on file for any of my recipients?"
getAttachmentGet an attachment - Retrieve attachment details, including a download URL"What's in attachment att123?" or "Show me the download link for this attachment"
getCustomerGet a customer - Retrieve details of a specific customer by their ID"Show me details for customer cust789" or "What's the contact info for Acme Corp as a customer?"
listCustomersList all customers - Retrieve a paginated list of customers. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters"List all my customers" or "Show me the customers I've invoiced"
getInvoiceGet an invoice - Retrieve details of an invoice by its ID"Show me invoice inv001" or "What's the status of the invoice I sent to Acme Corp?"
listInvoicesList all invoices - Retrieve a paginated list of invoices. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters"Show me all my unpaid invoices" or "List the invoices I sent last month"
listInvoiceAttachmentsList invoice attachments - Retrieve a list of all attachments for a specific invoice"What attachments are on invoice inv001?" or "Show me the files attached to this invoice"
listBudgetsList all budgets - Retrieve a list of your organization's budgets"What budgets do we have?" or "Show me all active budgets"
getBudgetGet a budget - Retrieve a budget by its ID, including its status, limit per user, frequency, and start and end dates"What's the limit on the Team lunches budget?"
getBudgetMembersGet budget members - Retrieve the members of a budget and how much each member has spent in the current or final period"Who is over their Team lunches budget this month?"
getBudgetExpendituresGet budget expenditures - Retrieve the transactions assigned to a budget"Show me everything charged to the Offsite 2026 budget"
listReceiptsList receipts - Retrieve uploaded receipts that are still being matched. Requires permission to see all expenses"Which of my uploaded receipts are still being matched?"
getReceiptGet a receipt - Retrieve an uploaded receipt and its matching status by its ID"Did the receipt I just uploaded match a transaction?"
listReimbursementsList reimbursements - Retrieve your organization's reimbursements, including review status, payment status, and attachments. Requires permission to see all expenses"Which reimbursements are waiting for review?"
getReimbursementGet a reimbursement - Retrieve a reimbursement by its ID, including its review and payment status. Requires permission to see all expenses"Has Jordan's Sweetgreen reimbursement been paid?"
getBooksInstancesList accessible Books instances - Retrieve the organization's books your connection can act on. Your AI tool calls this first“Which company's books am I connected to?”
getBooksSourceAccountsList source accounts - Retrieve every bank account, card, and other feed whose transactions flow into Books, including Mercury, Plaid-linked, commerce, and manual accounts“Which accounts feed into my books?”
getBooksTransactionsList a source account's transactions - Retrieve transactions for one source account by date range and review status, including how each was categorized. Add Mercury details such as notes, counterparty, and attachments“Show uncategorized transactions on my Mercury credit card from last month”
getBooksTransactionRetrieve a transaction - Retrieve a single transaction and its current categorization“How is the October 3 Stripe payout categorized?”
getBooksLedgersList the live chart of accounts - Retrieve your GL accounts with type, sub-type, account number, and parent. Shows which accounts can take manual entries or be deleted, and why not“Show my chart of accounts” or “Which expense accounts can I delete?”
getBooksLedgerRetrieve a ledger - Retrieve a single GL account by its ID“Show the details for account 6150”
getBooksLedgerBalancesRetrieve ledger balances over a date range - Retrieve opening balance, closing balance, and net activity for up to 100 GL accounts“What was the balance of Accounts Payable at the end of September?”
getBooksLineEntriesList line entries across ledgers - Retrieve every debit and credit in a date range. Filter by account, by the account on the other side, or by amount“Show every charge to Software & Hosting this quarter” or “Which expenses were paid from my Amex card in October?”
listBooksJournalEntriesList journal entries - Retrieve journal entries filtered by date, account, amount, keyword, tag, source, and categorization or review status“List manual journal entries posted this year” or “Show AI-categorized entries I haven't reviewed”
retrieveBooksJournalEntryRetrieve a journal entry - Retrieve a single journal entry by its ID“Show journal entry je123”
getBooksCategorizationRulesList categorization rules - Retrieve your rules, highest priority first, with status and when each last applied“What categorization rules do I have?” or “Which rules haven't applied in six months?”
getBooksProfitAndLossRetrieve a profit and loss statement - Retrieve a P&L for a date range as one column, or by day, month, quarter, or year. Reports can span up to five years, or one year with daily columns“Pull a monthly P&L for the last three months” or “Compare Q3 revenue to Q2”
getBooksBalanceSheetRetrieve a balance sheet - Retrieve balances as of the end of each period in a date range“Show the balance sheet as of the end of last month”
getBooksCashFlowRetrieve a cash flow report - Retrieve starting balance, ending balance, and net cash flow per account. This is a per-account analysis, not a statement grouped by operating, investing, and financing“How did cash move through my accounts last quarter?”
getBooksBillsList bills (accounts payable) - Retrieve bills with vendor, dates, status, amount remaining, lines, and applied payments“Show my open bills” or “What do we owe Acme Legal?”
getBooksBillRetrieve a bill - Retrieve a single bill by its ID“Show bill b123”
getBooksInvoicesList invoices (accounts receivable) - Retrieve invoices with customer, dates, status, amount remaining, lines, and applied payments“Which invoices are overdue?”
getBooksInvoiceRetrieve an invoice - Retrieve a single invoice by its ID“Show invoice INV-1042”

We'd love your feedback. If there are more tools or data you'd love to see in Mercury's MCP, email us at [email protected]

Footnotes

  1. Mercury is a fintech company, not an FDIC-insured bank. Banking services provided through Choice Financial Group and Column N.A., Members FDIC. The Mercury Debit Cards are issued by Choice Financial Group and Column N.A., Members FDIC, and the IO Card is issued by Patriot Bank, N.A., Member FDIC, pursuant to licenses from Mastercard International Incorporated. ↩

  2. AI-generated responses and suggested actions may vary and are not guaranteed. Please review outputs before taking action. ↩


What’s Next

See how to stay safe while using Mercury's MCP