# Mercoa MCP by usefulapi

> Mercoa MCP by usefulapi is an MCP server. Query and manage Mercoa AP/AR bill-pay: entities, invoices, transactions and payment methods. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/mercoa/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/mercoa
- **MCP Registry name:** io.usefulapi/mercoa
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mercoa.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mercoa": {
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mercoa": {
      "serverUrl": "https://mercoa.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/mercoa-mcp-by-usefulapi
