# Mercury MCP MCP Server

> **Mercury MCP MCP Server** is a hosted, multitenant Model Context Protocol (MCP) server run by **MewCP** (https://mewcp.com), giving AI agents managed access to Mercury MCP.
>
> MewCP takes care of all MCP infrastructure for you — credential storage, OAuth flows,
> token refresh, and production-grade auto-scaling — so your AI agents can connect to
> third-party services and run freely without you managing any MCP server yourself.
>
> Server page:  https://mewcp.com/mcp/mercury-mcp
> MewCP docs:   https://docs.mewcp.com
> All servers:  https://mewcp.com/servers (JSON: https://mewcp.com/api/servers)
> About MewCP:  https://mewcp.com/llms.txt

---

## About

Connect AI agents to Mercury business banking — query accounts, balances, transactions, cards, treasury, invoices, and recipients in natural language.

---

## Details

- Server ID: `mercury-mcp`
- Version: 1.0.0
- Tools: 36
- Authentication: OAuth, managed by MewCP
- Transport: http

---

## Access

The gateway URL below serves your **entire MewCP toolset**, not this server on its
own. Pasting a config snippet is not enough — Mercury MCP has to be in the toolset
first. In order:

1. Add Mercury MCP to your toolset at https://mewcp.com/mcp/mercury-mcp
2. Connect your Mercury MCP account (OAuth); MewCP stores the credential and attaches it to each call
3. Add the gateway URL to your client (see Connect below). It signs in with OAuth
   the first time it connects, so there is no key to copy.

Once connected, an agent does **not** see this server's tools as top-level tools.
It sees four meta-tools and reaches everything through them:

- `search(query)` — find tools by keyword across the toolset
- `get_schema(tools)` — full description and arguments for the tools you picked
- `list_accounts(provider)` — only when one app has several connected accounts
- `call_tool(server_maskedId, tool_name, args)` — execute

So the list below is what `search` can return for this server, not a set of
callable tool names on their own.

---

## Tools (36)

Descriptions are truncated to 160 characters; call `get_schema`
for the full text and the argument schema. Where a tool is annotated, its type
is shown — treat `destructive` as irreversible.

- `getAccount` _(read)_ — Get account by ID
- `getAccountCards` _(read)_ — Retrieve all debit and credit cards associated with a specific account.
- `getAccountStatements` _(read)_ — Retrieve a paginated list of monthly statements for a specific account. Supports cursor-based pagination with limit, order, start_after, and end_before query…
- `getTransaction` _(read)_ — Get transaction by ID
- `getAccounts` _(read)_ — Retrieve a paginated list of accounts. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.
- `getAttachment` _(read)_ — Retrieve attachment details including download URL
- `listCustomers` _(read)_ — Retrieve a paginated list of customers. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.
- `getCustomer` _(read)_ — Retrieve details of a specific customer by their ID
- `listInvoices` _(read)_ — Retrieve a paginated list of invoices. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.
- `getInvoice` _(read)_ — Retrieve details of an invoice by its ID
- `listInvoiceAttachments` _(read)_ — Retrieve a list of all attachments for a specific invoice
- `listCards` _(read)_ — Retrieve a paginated list of cards.
- `getCard` _(read)_ — Retrieve details of a specific card by its ID.
- `listCategories` _(read)_ — Retrieve a paginated list of all available custom expense categories for the organization. Supports cursor-based pagination with limit, order, start_after, and…
- `listCredit` _(read)_ — Retrieve a list of all credit accounts for the organization.
- `listMerchants` _(read)_ — Retrieve a paginated list of priority merchants that can be used for spend controls like merchant locking. Supports cursor-based pagination with limit, order,…
- `getOrganization` _(read)_ — Retrieve information about your organization including EIN, legal business name, and DBAs.
- `getRecipient` _(read)_ — Retrieve details of a specific recipient by ID
- `getRecipients` _(read)_ — Retrieve a paginated list of all recipients. Use cursor parameters (start_after, end_before) for pagination.
- `listRecipientsAttachments` _(read)_ — Retrieve a paginated list of all recipient tax form attachments across all recipients in the organization. Use cursor parameters (start_after, end_before) for…
- `listRecipientInvites` _(read)_ — Retrieve a paginated list of all recipient invites for your organization. Supports filtering by status.
- `getRecipientInvite` _(read)_ — Retrieve details of a specific recipient invite by ID.
- `listSendMoneyApprovalRequests` _(read)_ — Retrieve a paginated list of send money approval requests for the authenticated organization. Supports filtering by account and status.
- `listTransferMoneyApprovalRequests` _(read)_ — Retrieve a paginated list of transfer approval requests for the authenticated organization. Supports filtering by source account, destination account, and…
- `getTransferMoneyApprovalRequest` _(read)_ — Retrieve a specific transfer approval request by ID.
- `getSafeRequests` _(read)_ — Retrieve all SAFE (Simple Agreement for Future Equity) requests for your organization.
- `getSafeRequest` _(read)_ — Retrieve a specific SAFE request by its ID.
- `getTransactionById` _(read)_ — Retrieve a single transaction by its ID. Returns full transaction details including attachments, check images, and related metadata.
- `listTransactions` _(read)_ — Retrieve a paginated list of all transactions across all accounts. Supports advanced filtering by date ranges, status, categories, and cursor-based pagination.…
- `getTreasury` _(read)_ — Retrieve a paginated list of all treasury accounts associated with the authenticated organization. Use cursor parameters (start_after, end_before) for…
- `getTreasuryTransactions` _(read)_ — Retrieve paginated treasury transactions for a specific treasury account.
- `getUsers` _(read)_ — Get all users
- `getUser` _(read)_ — Get user by ID
- `getWebhooks` _(read)_ — Retrieve a paginated list of all webhook endpoints for your organization. Supports filtering by status.
- `getWebhook` _(read)_ — Retrieve details of a specific webhook endpoint by ID
- `getCurrentDate` _(read)_ — Get the current date in the format. Example: Fri Oct 31 2025

---

## Connect

- URL: https://gateway.mewcp.com/personal/mcp
- Transport: Streamable HTTP (remote). Nothing to install.
- Sign-in: OAuth. On first connect the client opens a browser window to sign in
  to MewCP and approve access. No API key.
- Headless clients (SDKs, servers without a browser) send an API key instead:
  `Authorization: Bearer <API_KEY>`, key from https://mewcp.com/dashboard/api-keys

Agents setting themselves up: follow https://mewcp.com/SKILL.md

Step-by-step guide per client:

- Claude Desktop: https://mewcp.com/mcp/mercury-mcp/connect/claude
- ChatGPT: https://mewcp.com/mcp/mercury-mcp/connect/chatgpt
- VS Code: https://mewcp.com/mcp/mercury-mcp/connect/vscode
- Cursor: https://mewcp.com/mcp/mercury-mcp/connect/cursor
- Codex: https://mewcp.com/mcp/mercury-mcp/connect/codex
- Claude Code: https://mewcp.com/mcp/mercury-mcp/connect/claude-code
- OpenCode: https://mewcp.com/mcp/mercury-mcp/connect/opencode
- OpenClaw: https://mewcp.com/mcp/mercury-mcp/connect/openclaw
- Antigravity: https://mewcp.com/mcp/mercury-mcp/connect/antigravity
- Hermes: https://mewcp.com/mcp/mercury-mcp/connect/hermes
- DeepSeek Harness: https://mewcp.com/mcp/mercury-mcp/connect/dsh
- Python: https://mewcp.com/mcp/mercury-mcp/connect/python
- TypeScript: https://mewcp.com/mcp/mercury-mcp/connect/typescript