About Mercoa MCP by usefulapi
Mercoa MCP by usefulapi is a hosted server for querying and managing Mercoa accounts through MCP clients. It covers entities, invoices, transactions and payment methods, with read and write tools.
Key features
- 01Find and manage entities
- 02Search and manage invoices
- 03Inspect transactions and events
- 04View payment methods and users
- 05Create entities and invoices
- 06Check invoice metrics
Use cases
- 01Review invoice and transaction records
- 02Create an entity or invoice
- 03Update an invoice or add a comment
MCP support
Exposes Mercoa entity, invoice, transaction and payment-method operations as tools for MCP clients. It is hosted and authenticates users with their Mercoa API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mercoa.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-mercoa https://mercoa.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-mercoa":{"type":"http","url":"https://mercoa.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-mercoa":{"serverUrl":"https://mercoa.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
17| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | Max entities to return (1-100, default 10). |
| search | string | No | Search by name, email, emailTo, entity ID, or foreign ID (partial matches). |
| status | any | No | Entity status filter (e.g. verified, pending). |
| isPayee | boolean | No | Filter entities marked as payees. |
| isPayor | boolean | No | Filter entities marked as payors. |
| foreignId | any | No | Your system's ID(s) for the entity. |
| isCustomer | boolean | No | If true, only entities with a direct relationship to your organization. |
| startingAfter | string | No | Entity ID cursor for pagination. |
| paymentMethods | boolean | No | If true, include payment methods in the response. |
| returnMetadata | any | No | Metadata key(s) to include in the response. |
Details
From the project READMEMercoa MCP by usefulapi
Query and manage Mercoa AP/AR bill-pay — entities, invoices, transactions and payment methods — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Mercoa API key.
Live endpoint: https://mercoa.usefulapi.io/mcp · Homepage: https://usefulapi.io/mercoa
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://mercoa.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"mercoa": {
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Mercoa credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/mercoa/
On first connect you'll paste your Mercoa API key. It's validated, stored per-user, and scoped to you.
Tools
| Tool | Type | What it does |
|---|---|---|
mercoa_find_entities | read | Find entities |
mercoa_get_entity | read | Get entity |
mercoa_get_entity_events | read | Get entity events |
mercoa_get_entity_invoice_metrics | read | Get entity invoice metrics |
mercoa_list_entity_payment_methods | read | List entity payment methods |
mercoa_get_payment_method | read | Get payment method |
mercoa_list_entity_users | read | List entity users |
mercoa_find_invoices | read | Find invoices |
mercoa_get_invoice | read | Get invoice |
mercoa_get_invoice_events | read | Get invoice events |
mercoa_find_transactions | read | Find transactions |
mercoa_get_transaction | read | Get transaction |
mercoa_get_organization | read | Get organization |
mercoa_create_entity | write | Create entity |
mercoa_create_invoice | write | Create invoice |
mercoa_update_invoice | write | Update invoice |
mercoa_add_invoice_comment | write | Add invoice comment |
mercoa_usage_status | meta | Usage status (free-tier meter) |
mercoa_request_feature | meta | Request a missing feature |
mercoa_upgrade | meta | Upgrade to Pro (unlimited*) |
mercoa_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with mercoa_upgrade (it returns a Stripe Checkout link). Cancel any time with mercoa_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running mercoa_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT — see LICENSE. Documentation only; the server is hosted.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.