mcpbeat

Mercoa MCP Server

io.usefulapi/mercoa
not responding

Mercoa is listed as active in the registry but did not answer our last check. It exposes 17 tools. Last commit 1 Aug 2026.

Query and manage Mercoa AP/AR bill-pay: entities, invoices, transactions and payment methods.

Uptime history 41 hours of history · worst hour 0%
41 hours agonow
35.2%
Uptime 24h
32 of 91 checks
17
Tools
read from the server
169 ms
Response time
average over 24h
0
Stars
last commit 1 Aug 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 6 min ago.

run in your terminal
claude mcp add mercoa --transport http https://mercoa.usefulapi.io/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mercoa": {
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mercoa]
url = "https://mercoa.usefulapi.io/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "mercoa": {
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mercoa": {
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}

Available tools 17

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

mercoa
mercoa_add_invoice_comment
WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.
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_find_entities
Find/search entities (buyers, vendors, payors, payees). Use to look up counterparties by name/email/foreignId or list all. GET /entity.
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_find_transactions
List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.
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_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_get_organization
Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.
mercoa_get_payment_method
Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.
mercoa_get_transaction
Get a single payment transaction by ID. GET /transaction/{transactionId}.
mercoa_list_entity_payment_methods
List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.
mercoa_list_entity_users
List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.
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}.

Endpoints

URLTransportStateLatencyChecked
https://mercoa.usefulapi.io/mcp streamable-http answering 45 ms 6 min ago

Mercoa — questions

Answers built from our own checks of this server.

What can Mercoa do?
It exposes 17 tools, read directly from the server on our last check. Among them: mercoa_add_invoice_comment, mercoa_create_entity, mercoa_create_invoice, mercoa_find_entities, mercoa_find_invoices, mercoa_find_transactions and 11 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Mercoa working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 32 of 91 checks got a reply (35.2%), average response time 169 ms. The bar chart above shows every period we have measured.
The registry lists Mercoa as active — why does it not respond?
The official MCP registry stores what the author submitted; it does not verify that the server still runs. We check the endpoint ourselves, and this one does not answer. Catalogues that copy the registry without checking will show it as working.
How do I connect Mercoa?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Mercoa need an API key?
No. Mercoa completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 17 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Mercoa?
It answers our handshake in 169 ms on average, which is faster than 69% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
Is Mercoa open source?
Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.