Skip to content
MCP server

Mercoa MCP by usefulapi

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

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mercoa.usefulapi.io/mcp
Install 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