name: mercury-api description: Mercury Bank API reference for accounts, transactions, and recipients. Use when working with Mercury API integration, transaction queries, or payment operations. allowed-tools: Read, Grep, Glob, Edit, Write, Bash

Mercury API Reference

Mercury Bank API reference for the finance_plugins project.

When to Use This Skill

• Creating Mercury tool plugins
• Querying accounts and transactions
• Implementing payment operations
• Setting up Mercury OAuth/API Token auth

API Overview

Environments

Authentication

API Token

headers = {
    "Authorization": f"Bearer {api_token}",
    "Accept": "application/json;charset=utf-8"
}

OAuth2

Authorization URL: https://mercury.com/oauth/authorize
Token URL: https://api.mercury.com/oauth/token
Scopes: read, write

Key Endpoints

Accounts

Transactions

Query Parameters (Transactions)

Recipients

Webhooks

Response Structures

Account

{
  "id": "uuid",
  "accountNumber": "string",
  "routingNumber": "string",
  "name": "string",
  "kind": "string",
  "type": "mercury | external | recipient",
  "status": "active | deleted | pending | archived",
  "currentBalance": 0,
  "availableBalance": 0,
  "createdAt": "2025-01-01T00:00:00Z"
}

Transaction

{
  "id": "uuid",
  "amount": -150.00,
  "status": "pending | sent | completed | failed",
  "counterpartyName": "Vendor Name",
  "postedAt": "2025-01-01T00:00:00Z",
  "note": "string",
  "mercuryCategory": "string"
}

Current Plugin Coverage

mercury_tools_plugin (Implemented)

• get_accounts - List accounts
• get_account - Get account details
• get_transactions - Query transactions

Planned Features

Reference

• Full docs: mercury_tools_plugin/docs/Mercury_MCP_API_Reference.md
• Mercury API Docs
• Sandbox Guide