Mercury Bank API reference for accounts, transactions, and recipients. Use when working with Mercury API integration, transaction queries, or payment operations.
Mercury Bank API reference for the finance_plugins project.
| Type | Permission | Use Case | Auth |
|---|---|---|---|
| Mercury MCP | Read-only | AI tools, monitoring | OAuth2 |
| Mercury API | Read/Write | Payments, transfers | API Token / OAuth2 |
| Environment | Base URL |
|---|
| Production | https://api.mercury.com |
| Sandbox | https://sandbox.mercury.com |
headers = {
"Authorization": f"Bearer {api_token}",
"Accept": "application/json;charset=utf-8"
}
Authorization URL: https://mercury.com/oauth/authorize
Token URL: https://api.mercury.com/oauth/token
Scopes: read, write
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/accounts | List all accounts |
GET | /api/v1/account/{id} | Get account details |
GET | /api/v1/account/{id}/cards | Get account cards |
GET | /api/v1/account/{id}/statements | Get statements |
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/transactions | List all transactions |
GET | /api/v1/account/{id}/transactions | Account transactions |
GET | /api/v1/account/{id}/transaction/{txnId} | Transaction details |
POST | /api/v1/account/{id}/transactions | Create transaction |
PATCH | /api/v1/transaction/{id} | Update transaction |
| Param | Type | Description |
|---|---|---|
limit | integer | Result limit |
offset | integer | Pagination offset |
start | string | Start date (YYYY-MM-DD) |
end | string | End date (YYYY-MM-DD) |
status | string | Status filter |
search | string | Search keyword |
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/recipients | List recipients |
GET | /api/v1/recipient/{id} | Get recipient |
POST | /api/v1/recipients | Create recipient |
DELETE | /api/v1/recipient/{id} | Delete recipient |
| Method | Endpoint | Description |
|---|---|---|
GET | /api/v1/webhooks | List webhooks |
POST | /api/v1/webhooks | Create webhook |
DELETE | /api/v1/webhook/{id} | Delete webhook |
{
"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"
}
{
"id": "uuid",
"amount": -150.00,
"status": "pending | sent | completed | failed",
"counterpartyName": "Vendor Name",
"postedAt": "2025-01-01T00:00:00Z",
"note": "string",
"mercuryCategory": "string"
}
get_accounts - List accountsget_account - Get account detailsget_transactions - Query transactions| Feature | Priority | Endpoint |
|---|---|---|
| Create payment | High | POST /account/{id}/transactions |
| Internal transfer | Medium | POST /transfer |
| Manage recipients | Medium | Recipients CRUD |
| Account cards | Low | GET /account/{id}/cards |
mercury_tools_plugin/docs/Mercury_MCP_API_Reference.md