MCP server
Mercoa MCP by usefulapi
Query and manage Mercoa AP/AR bill-pay: entities, invoices, transactions and payment…
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Mercoa MCP by usefulapi
Mercoa MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Query and manage Mercoa AP/AR bill-pay: entities, invoices, transactions and payment methods.
Install
Run in a terminal
claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://mercoa.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mercoa": {
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"mercoa": {
"type": "http",
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mercoa": {
"serverUrl": "https://mercoa.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mercoa": {
"type": "http",
"url": "https://mercoa.usefulapi.io/mcp"
}
}
}Tools this server provides (17)
Read directly from the server.
- mercoa_find_entities
- Find/search entities (buyers, vendors, payors, payees). Use to look up counterparties by name/email/foreignId or list all. GET /entity.
- mercoa_get_entity
- Get a single entity by ID (or foreign ID). GET /entity/{entityId}.
- mercoa_get_entity_events
- Get the event/audit log for an entity. GET /entity/{entityId}/events.
- mercoa_get_entity_invoice_metrics
- Get aggregate invoice metrics (totals/counts, grouped by currency) for an entity's payables/receivables — for AP/AR dashboards and aging. GET /entity/{entityId}/invoice-metrics.
- mercoa_list_entity_payment_methods
- List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.
- mercoa_get_payment_method
- Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.
- mercoa_list_entity_users
- List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.
- mercoa_find_invoices
- Find/search invoices (bills) across payers and vendors. Filter by status, entity, date, approver and more. GET /invoices (plural list endpoint).
- mercoa_get_invoice
- Get a single invoice (bill) by ID. GET /invoice/{invoiceId}.
- mercoa_get_invoice_events
- Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events.
- mercoa_find_transactions
- List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.
- mercoa_get_transaction
- Get a single payment transaction by ID. GET /transaction/{transactionId}.
- mercoa_get_organization
- Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.
- mercoa_create_entity
- WRITE — creates a real entity (customer/vendor/payor/payee) in Mercoa. Supply role flags, accountType, and a nested `profile` object (business or individual details). POST /entity.
- mercoa_create_invoice
- WRITE — creates a real invoice/bill in Mercoa. Set status (DRAFT to stage, NEW to submit), amount, currency, payer/vendor, dates and line items. POST /invoice.
- mercoa_update_invoice
- WRITE — updates an existing invoice/bill (all fields optional). Commonly used to advance status (e.g. DRAFT→NEW→SCHEDULED) or change amounts, dates, or payment methods. POST /invoice/{invoiceId}.
- mercoa_add_invoice_comment
- WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.
Mercoa MCP by usefulapi FAQ
How do I add Mercoa MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcp