# mercoa MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-mercoa
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://mercoa.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://mercoa.usefulapi.io/mcp

## Tools
- mercoa_find_entities (Find entities) - Find/search entities (buyers, vendors, payors, payees). Use to look up counterparties by name/email/foreignId or list all. GET /entity. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_entity (Get entity) - Get a single entity by ID (or foreign ID). GET /entity/{entityId}. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_entity_events (Get entity events) - Get the event/audit log for an entity. GET /entity/{entityId}/events. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_entity_invoice_metrics (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. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_list_entity_payment_methods (List entity payment methods) - List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_payment_method (Get payment method) - Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_list_entity_users (List entity users) - List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_find_invoices (Find invoices) - Find/search invoices (bills) across payers and vendors. Filter by status, entity, date, approver and more. GET /invoices (plural list endpoint). Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_invoice (Get invoice) - Get a single invoice (bill) by ID. GET /invoice/{invoiceId}. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_invoice_events (Get invoice events) - Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_find_transactions (Find transactions) - List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_transaction (Get transaction) - Get a single payment transaction by ID. GET /transaction/{transactionId}. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_get_organization (Get organization) - Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_create_entity (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. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_create_invoice (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. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_update_invoice (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}. Endpoint: https://mercoa.usefulapi.io/mcp
- mercoa_add_invoice_comment (Add invoice comment) - WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment. Endpoint: https://mercoa.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io