# Usefulapi Mercoa MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.usefulapi%2Fmercoa
Registry id: `mcp-registry/io.usefulapi/mercoa`
Status: auth-required (checked 2026-10-27T01:45:00.046Z)

## Verdict

Usefulapi Mercoa MCP server answered 99.53% of Glimind's liveness checks over 30 days, better than 15% of MCP servers, with 61 ms median handshake and 1 outage in 90 days. Its agent-readiness grade is A (96/100) across 17 tools, costing an agent about 4,789 tokens to load. Checked every few minutes; no tool is ever called.

## Measurements (30 days)

| Metric | Value | Better than |
|---|---|---|
| Uptime, 30 days | 99.53% | 15% of MCP servers |
| Median handshake latency | 61 ms | 88% of MCP servers |
| p95 handshake latency | 278 ms | — |
| Checks in 30 days | 213 | — |
| Outages, 90 days | 1 | — |
| Median recovery | 6 min | — |
| Agent-readiness score | 96/100 (A) | 82% of MCP servers |
| Tools | 17 | — |
| Tool-list size for an agent | ~4,789 tokens | 39% of MCP servers |
| Days observed | 28 | — |

## Install

```json
{
  "mcpServers": {
    "usefulapi-mercoa-mcp-server": {
      "type": "http",
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http usefulapi-mercoa-mcp-server https://mercoa.usefulapi.io/mcp
```

## Tools (17)

- `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 det
- `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}
- `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 

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.