Skip to main content
Mercury MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 30
  • Triggers: 0
  • Slug: MERCURY_MCP
  • Version: 20260929_00

Tools

Slug: MERCURY_MCP_GET_ACCOUNTGet account by ID

Input Parameters

string
required
ID for a Mercury account.
Slug: MERCURY_MCP_GET_ACCOUNT_CARDSRetrieve all debit and credit cards associated with a specific account.

Input Parameters

string
required
ID for a Mercury account.
Slug: MERCURY_MCP_GET_ACCOUNTSRetrieve a paginated list of accounts. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the account to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the account to start the page after (exclusive). When provided, results will begin with the account immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_GET_ACCOUNT_STATEMENTSRetrieve a paginated list of monthly statements for a specific account. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters, as well as date range filtering with start and end parameters.

Input Parameters

string
Filter statements where the period start date is on or before this date. If the date is in the future, defaults to the current date. Format: YYYY-MM-DD
integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘desc’
string
Filter statements where the period start date is on or after this date. Format: YYYY-MM-DD
string
required
ID for a Mercury account.
string
The ID of the statement to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the statement to start the page after (exclusive). When provided, results will begin with the statement immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_GET_ATTACHMENTRetrieve attachment details including download URL

Input Parameters

string
required
ID for the attachment.
Slug: MERCURY_MCP_GET_CURRENT_DATEGet the current date in the format. Example: Fri Oct 31 2025
Slug: MERCURY_MCP_GET_CUSTOMERRetrieve details of a specific customer by their ID

Input Parameters

string
required
The customer who will receive the invoice. Use the /api/v1/ar/customers endpoint to list your customers and find the corresponding id, or create a new customer first.
Slug: MERCURY_MCP_GET_INVOICERetrieve details of an invoice by its ID

Input Parameters

string
required
ID for the invoice.
Slug: MERCURY_MCP_GET_ORGANIZATIONRetrieve information about your organization including EIN, legal business name, and DBAs.
Slug: MERCURY_MCP_GET_RECIPIENTRetrieve details of a specific recipient by ID

Input Parameters

string
required
ID for a Mercury account.
Slug: MERCURY_MCP_GET_RECIPIENTSRetrieve a paginated list of all recipients. Use cursor parameters (start_after, end_before) for pagination.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the recipient to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the recipient to start the page after (exclusive). When provided, results will begin with the recipient immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_GET_SAFE_REQUESTRetrieve a specific SAFE request by its ID.

Input Parameters

string
required
ID for the SAFE request
Slug: MERCURY_MCP_GET_SAFE_REQUESTSRetrieve all SAFE (Simple Agreement for Future Equity) requests for your organization.
Slug: MERCURY_MCP_GET_TRANSACTIONGet transaction by ID

Input Parameters

string
required
ID for a Mercury account.
string
required
ID for this transaction
Slug: MERCURY_MCP_GET_TRANSACTION_BY_IDRetrieve a single transaction by its ID. Returns full transaction details including attachments, check images, and related metadata.

Input Parameters

string
required
ID for this transaction
Slug: MERCURY_MCP_GET_TREASURYRetrieve a paginated list of all treasury accounts associated with the authenticated organization. Use cursor parameters (start_after, end_before) for pagination.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the account to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the account to start the page after (exclusive). When provided, results will begin with the account immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_GET_TREASURY_STATEMENTSRetrieve a paginated list of statements for a specific treasury account. Supports cursor-based pagination and filtering by document type.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the statement to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
required
ID for a Mercury account.
string
The ID of the statement to start the page after (exclusive). When provided, results will begin with the statement immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
string ("MonthlyStatement" | "TradeConfirmation" | "1099" | "1099R" | "1042S" | "5498" | "5498ESA" | "1099Q" | "FMV" | "SDIRA")
Filter statements by document type.
Slug: MERCURY_MCP_GET_TREASURY_TRANSACTIONSRetrieve paginated treasury transactions for a specific treasury account.

Input Parameters

integer
Maximum number of results to return. Defaults to 100
string ("asc" | "desc")
Sort order for transactions. Can be ‘asc’ or ‘desc’. Defaults to ‘desc’
number
Pagination cursor for retrieving next batch of transactions. Must be an integer >= 0
string
required
ID for a Mercury account.
Slug: MERCURY_MCP_GET_USERGet user by ID

Input Parameters

string
required
ID for the user
Slug: MERCURY_MCP_GET_USERSGet all users

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the user to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the user to start the page after (exclusive). When provided, results will begin with the user immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_GET_WEBHOOKRetrieve details of a specific webhook endpoint by ID

Input Parameters

string
required
ID for the webhook
Slug: MERCURY_MCP_GET_WEBHOOKSRetrieve a paginated list of all webhook endpoints for your organization. Supports filtering by status.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
array
string
The ID of the webhook to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the webhook to start the page after (exclusive). When provided, results will begin with the webhook immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_CATEGORIESRetrieve a paginated list of all available custom expense categories for the organization. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.
  • These categories are custom and different from the values for “mercuryCategory”.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the category to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the category to start the page after (exclusive). When provided, results will begin with the category immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_CREDITRetrieve a list of all credit accounts for the organization.
Slug: MERCURY_MCP_LIST_CUSTOMERSRetrieve a paginated list of customers. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the customer to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the customer to start the page after (exclusive). When provided, results will begin with the customer immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_INVOICE_ATTACHMENTSRetrieve a list of all attachments for a specific invoice

Input Parameters

string
required
ID for the invoice.
Slug: MERCURY_MCP_LIST_INVOICESRetrieve a paginated list of invoices. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the invoice to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the invoice to start the page after (exclusive). When provided, results will begin with the invoice immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_RECIPIENTS_ATTACHMENTSRetrieve a paginated list of all recipient tax form attachments across all recipients in the organization. Use cursor parameters (start_after, end_before) for pagination.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
The ID of the recipient attachment to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the recipient attachment to start the page after (exclusive). When provided, results will begin with the recipient attachment immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_SEND_MONEY_APPROVAL_REQUESTSRetrieve a paginated list of send money approval requests for the authenticated organization. Supports filtering by account and status.

Input Parameters

integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("pendingApproval" | "approved" | "rejected" | "cancelled")
string
ID for a Mercury account.
string
The ID of the send money approval request to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
The ID of the send money approval request to start the page after (exclusive). When provided, results will begin with the send money approval request immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
Slug: MERCURY_MCP_LIST_TRANSACTIONSRetrieve a paginated list of all transactions across all accounts. Supports advanced filtering by date ranges, status, categories, and cursor-based pagination.

CRITICAL TRUNCATION RULE - READ THIS FIRST:

IF YOU SEE “Result too long” IN THE RESPONSE:
  1. IMMEDIATELY STOP - Do not analyze or use the truncated data
  2. The data is INCOMPLETE and any analysis will be WRONG
  3. Start over with a smaller limit (reduce by 50%)
  4. Paginate through ALL pages until you have complete data
  5. NEVER provide answers based on truncated results ================================================================================
MANDATORY PAGINATION FOR COMPLETE RESULTS: When a user asks ANY question requiring complete data (totals, balances, aggregates, “most/least”, “all transactions”, comparisons, or any calculation across transactions):CRITICAL: Incomplete pagination will produce WRONG ANSWERS for questions about totals, spending categories, balances, minimums, maximums, or “most/least”. You must fetch everything before calculating or answering.
  1. Start with a limit of 300 transactions.
  2. You MUST automatically paginate through ALL pages WITHOUT asking the user
  3. Continue calling listTransactions using the page.nextPage value from each response
  4. Keep fetching until page.nextPage is not present
  5. If pagination would take more than 3 tool calls, ask the user to narrow down to a smaller time period
  6. It is a CRITICAL ERROR to answer before having fetched ALL pages
FILTERING:
  • IMPORTANT: WHEN FILTERING BY DATE, ALWAYS CHECK THE CURRENT DATE FIRST and ensure you’re using the current year for current year queries
  • Unless specified otherwise or queried for “all transactions”, ONLY include transactions with “status: sent”
  • To get transactions for a specific account, use the accountId parameter to filter by accountId
PAGINATION MECHANICS:
  • Use the limit parameter to control page size
  • If page.nextPage is returned, use it as the start_after parameter in your next call
  • Keep fetching until page.nextPage is null/undefined
  • The page.nextPage value is a transaction ID to start after (exclusive)
COMPUTATIONAL REQUIREMENTS:
  • For any query requiring:
    • Sums, totals, averages, medians, modes, ranges, most/least, or other aggregations across accounts/transactions
    • Calculations involving currency amounts
    • Comparisons of financial metrics
  • You MUST:
    • Create an artifact that processes the data programmatically
    • Parse the JSON response and use JavaScript/Python to calculate
    • Display intermediate steps for verification
    • Never rely on mental arithmetic for financial calculations
  • Example: “What’s my total balance?”
    • CORRECT: Create artifact that parses accounts, maps to balances, uses reduce() to sum
    • INCORRECT: Manually adding up balance values
For queries about ‘last two months’ or ‘this year’, calculate dates based on the actual current date Use the getCurrentDate tool to get the current date.Use the getTransaction tool to get more details about a specific transaction.

Input Parameters

string
Latest createdAt date to filter for. If it’s not provided, it defaults to current day. Format: YYYY-MM-DD or an ISO 8601 string. Please note that your Mercury transactions on your Dashboard might have their postedAt date displayed, as opposed to createdAt
integer
Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
string ("asc" | "desc")
Sort order. Can be ‘asc’ or ‘desc’. Defaults to ‘asc’
string
Earliest createdAt date to filter for. If not provided, it defaults to the date of your first transaction. Format: YYYY-MM-DD or an ISO 8601 string. Please note that your Mercury transactions on your Dashboard might have their postedAt date displayed, as opposed to createdAt
Search term to look for in transaction descriptions.
array
string
The ID of the resource to start the page at (inclusive). When provided, results will begin with and include the resource with this ID. Use this to retrieve a specific page when you know the exact starting point. Cannot be combined with start_after or end_before.
array
string
Latest postedAt date to filter for. Format: YYYY-MM-DD or an ISO 8601 string
string
UUID of a custom category. Can be returned from /categories endpoint.
string
The ID of the transaction to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.
string
Earliest postedAt date to filter for. Format: YYYY-MM-DD or an ISO 8601 string
string
The ID of the transaction to start the page after (exclusive). When provided, results will begin with the transaction immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
string
Name of mercuryCategory you want to filter on. Merchant Type in the UI.