MCP Radar
Serveur MCP

mercoa

io.usefulapi/mercoa
Entreprise et opérations Finance et investissement Paiements et fintech Public et accessible MCP 2026-07-28

Ce que fait ce MCP

Manages Mercoa accounts payable and receivable entities, invoices, payment methods, transactions, metrics, and audit events.

Capacités

Outils

17 outils
mercoa_add_invoice_comment
Add invoice comment
WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.
Destructif
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['invoiceId', 'text'], 'properties': {'text': {'type': 'string', 'description': 'Comment text.'}, 'userId': {'type': 'string', 'description': 'ID or foreign ID of the user creating the comment.'}, 'invoiceId': {'type': 'string', 'description': 'Invoice ID to comment on.'}}}
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.
Destructif
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'email': {'type': 'string', 'description': 'Primary email for the entity.'}, 'isPayee': {'type': 'boolean', 'description': 'Whether this entity can receive payments (AR / vendor).'}, 'isPayor': {'type': 'boolean', 'description': 'Whether this entity can pay invoices (AP).'}, 'profile': {'type': 'object', 'description': 'Nested profile object, e.g. { "business": { "legalBusinessName": "Acme Inc.", "email": "ap@acme.com", "businessType": "llc" } } or { "individual": { "name": {...}, "email": "..." } }.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'foreignId': {'type': 'string', 'description': "Your system's ID for this entity."}, 'isCustomer': {'type': 'boolean', 'description': 'Whether this entity has a direct relationship with your organization.'}, 'accountType': {'enum': ['business', 'individual'], 'type': 'string', 'description': 'business or individual.'}}}
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.
Destructif
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'amount': {'type': 'number', 'description': 'Total invoice amount.'}, 'status': {'type': 'string', 'description': 'Invoice status, e.g. DRAFT, NEW, APPROVED, SCHEDULED.'}, 'dueDate': {'type': 'string', 'description': 'Due date (ISO 8601).'}, 'payerId': {'type': 'string', 'description': 'Payer entity ID (who owes).'}, 'currency': {'type': 'string', 'description': 'Currency code, e.g. USD.'}, 'metadata': {'type': 'object', 'description': 'Arbitrary key/value metadata.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'vendorId': {'type': 'string', 'description': 'Vendor entity ID (who is paid).'}, 'lineItems': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Line items array, e.g. [{ "amount": 100, "currency": "USD", "description": "Product A", "quantity": 1, "unitPrice": 100 }].'}, 'noteToSelf': {'type': 'string', 'description': 'Internal note.'}, 'invoiceDate': {'type': 'string', 'description': 'Invoice date (ISO 8601).'}, 'creatorUserId': {'type': 'string', 'description': 'User ID creating the invoice.'}, 'deductionDate': {'type': 'string', 'description': 'Scheduled payment/deduction date (ISO 8601).'}, 'invoiceNumber': {'type': 'string', 'description': 'Human-readable invoice number, e.g. INV-123.'}, 'creatorEntityId': {'type': 'string', 'description': 'Entity ID on whose behalf the invoice is created.'}, 'paymentSourceId': {'type': 'string', 'description': "Payment method ID to pay from (payer's)."}, 'paymentDestinationId': {'type': 'string', 'description': "Payment method ID to pay to (vendor's)."}}}
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.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Max entities to return (1-100, default 10).', 'exclusiveMinimum': 0}, 'search': {'type': 'string', 'description': 'Search by name, email, emailTo, entity ID, or foreign ID (partial matches).'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Entity status filter (e.g. verified, pending).'}, 'isPayee': {'type': 'boolean', 'description': 'Filter entities marked as payees.'}, 'isPayor': {'type': 'boolean', 'description': 'Filter entities marked as payors.'}, 'foreignId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': "Your system's ID(s) for the entity."}, 'isCustomer': {'type': 'boolean', 'description': 'If true, only entities with a direct relationship to your organization.'}, 'startingAfter': {'type': 'string', 'description': 'Entity ID cursor for pagination.'}, 'paymentMethods': {'type': 'boolean', 'description': 'If true, include payment methods in the response.'}, 'returnMetadata': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Metadata key(s) to include in the response.'}}}
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).
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Max invoices to return (1-100, default 10).', 'exclusiveMinimum': 0}, 'search': {'type': 'string', 'description': 'Search by vendor name, invoice number, check number, or amount.'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Invoice status filter (e.g. DRAFT, NEW, APPROVED, SCHEDULED, PAID).'}, 'endDate': {'type': 'string', 'description': 'End date filter (ISO 8601).'}, 'orderBy': {'type': 'string', 'description': 'Field to order by (e.g. CREATED_AT, AMOUNT, DUE_DATE).'}, 'payerId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by payer ID(s) or foreign ID(s).'}, 'dateType': {'type': 'string', 'description': 'Date type to filter by (e.g. CREATED_AT, DUE_DATE).'}, 'entityId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by entity (payer or vendor) ID(s) or foreign ID(s).'}, 'vendorId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by vendor ID(s) or foreign ID(s).'}, 'invoiceId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by invoice ID(s) or foreign ID(s).'}, 'startDate': {'type': 'string', 'description': 'Start date filter (ISO 8601).'}, 'approverId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by assigned approver user ID(s).'}, 'paymentType': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by payment type (e.g. recurring).'}, 'creatorUserId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by the user ID(s) that created the invoice.'}, 'entityGroupId': {'type': 'string', 'description': 'Filter by entity group ID.'}, 'startingAfter': {'type': 'string', 'description': 'Invoice ID cursor for pagination.'}, 'approverAction': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by approver action (use with approverId), e.g. APPROVE.'}, 'orderDirection': {'type': 'string', 'description': 'asc or desc.'}, 'invoiceTemplateId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by invoice template ID(s).'}, 'returnPayerMetadata': {'type': 'boolean', 'description': 'Include payer metadata in the response.'}, 'returnPaymentTiming': {'type': 'boolean', 'description': 'Include payment timing in the response.'}, 'returnVendorMetadata': {'type': 'boolean', 'description': 'Include vendor metadata in the response.'}}}
mercoa_find_transactions
Find transactions
List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Max transactions to return (1-100, default 10).', 'exclusiveMinimum': 0}, 'search': {'type': 'string', 'description': 'Search by vendor name, invoice number, check number, or amount.'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Transaction status filter.'}, 'endDate': {'type': 'string', 'description': 'CREATED_AT end date filter (ISO 8601).'}, 'payerId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by payer ID(s).'}, 'entityId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by entity ID(s) or foreign ID(s).'}, 'vendorId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by vendor ID(s).'}, 'invoiceId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by invoice ID(s) or foreign ID(s).'}, 'startDate': {'type': 'string', 'description': 'CREATED_AT start date filter (ISO 8601).'}, 'entityGroupId': {'type': 'string', 'description': 'Filter by entity group ID.'}, 'startingAfter': {'type': 'string', 'description': 'Transaction ID cursor for pagination.'}, 'transactionId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by transaction ID(s).'}, 'transactionType': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by transaction type.'}}}
mercoa_get_entity
Get entity
Get a single entity by ID (or foreign ID). GET /entity/{entityId}.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId'], 'properties': {'entityId': {'type': 'string', 'description': 'Entity ID (e.g. ent_...) or foreign ID.'}}}
mercoa_get_entity_events
Get entity events
Get the event/audit log for an entity. GET /entity/{entityId}/events.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Max events to return (1-100).', 'exclusiveMinimum': 0}, 'endDate': {'type': 'string', 'description': 'End date filter (ISO 8601).'}, 'entityId': {'type': 'string', 'description': 'Entity ID or foreign ID.'}, 'startDate': {'type': 'string', 'description': 'Start date filter (ISO 8601).'}, 'startingAfter': {'type': 'string', 'description': 'Event ID cursor for pagination.'}}}
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.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId'], 'properties': {'search': {'type': 'string', 'description': 'Search by vendor name, invoice number, check number, or amount.'}, 'status': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Invoice status filter (e.g. NEW, SCHEDULED, PAID).'}, 'endDate': {'type': 'string', 'description': 'End date filter (ISO 8601).'}, 'groupBy': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Additional grouping (e.g. by status).'}, 'payerId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by payer ID(s).'}, 'currency': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Currency code(s) to filter on, e.g. USD.'}, 'dateType': {'type': 'string', 'description': 'Date type to filter by (e.g. CREATED_AT, DUE_DATE).'}, 'entityId': {'type': 'string', 'description': 'Entity ID or foreign ID.'}, 'vendorId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by vendor ID(s).'}, 'invoiceId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by invoice ID(s) or foreign ID(s).'}, 'startDate': {'type': 'string', 'description': 'Start date filter (ISO 8601).'}, 'approverId': {'anyOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Filter by assigned approver user ID(s).'}, 'returnByDate': {'type': 'string', 'description': 'Group metrics by date, e.g. CREATION_DATE or DUE_DATE.'}, 'excludePayables': {'type': 'boolean', 'description': 'Only return receivables (exclude payables).'}, 'excludeReceivables': {'type': 'boolean', 'description': 'Only return payables (exclude receivables).'}, 'returnByDateFrequency': {'type': 'string', 'description': 'Frequency for date grouping (e.g. DAILY, MONTHLY).'}}}
mercoa_get_invoice
Get invoice
Get a single invoice (bill) by ID. GET /invoice/{invoiceId}.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['invoiceId'], 'properties': {'invoiceId': {'type': 'string', 'description': 'Invoice ID (e.g. in_...) or foreign ID.'}}}
mercoa_get_invoice_events
Get invoice events
Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['invoiceId'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Max events to return (1-100).', 'exclusiveMinimum': 0}, 'endDate': {'type': 'string', 'description': 'End date filter (ISO 8601).'}, 'invoiceId': {'type': 'string', 'description': 'Invoice ID or foreign ID.'}, 'startDate': {'type': 'string', 'description': 'Start date filter (ISO 8601).'}, 'startingAfter': {'type': 'string', 'description': 'Event ID cursor for pagination.'}}}
mercoa_get_organization
Get organization
Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
mercoa_get_payment_method
Get payment method
Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId', 'paymentMethodId'], 'properties': {'entityId': {'type': 'string', 'description': 'Entity ID or foreign ID.'}, 'paymentMethodId': {'type': 'string', 'description': 'Payment method ID (e.g. pm_...).'}}}
mercoa_get_transaction
Get transaction
Get a single payment transaction by ID. GET /transaction/{transactionId}.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['transactionId'], 'properties': {'transactionId': {'type': 'string', 'description': 'Transaction ID.'}}}
mercoa_list_entity_payment_methods
List entity payment methods
List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId'], 'properties': {'type': {'type': 'string', 'description': 'Filter by payment method type (e.g. bankAccount, card, check).'}, 'entityId': {'type': 'string', 'description': 'Entity ID or foreign ID.'}}}
mercoa_list_entity_users
List entity users
List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.
Lecture seule
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['entityId'], 'properties': {'entityId': {'type': 'string', 'description': 'Entity ID or foreign ID.'}}}
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}.
Destructif
Schéma d’entrée 
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['invoiceId'], 'properties': {'amount': {'type': 'number', 'description': 'Total invoice amount.'}, 'status': {'type': 'string', 'description': 'New invoice status, e.g. NEW, APPROVED, SCHEDULED.'}, 'dueDate': {'type': 'string', 'description': 'Due date (ISO 8601).'}, 'payerId': {'type': 'string', 'description': 'Payer entity ID.'}, 'currency': {'type': 'string', 'description': 'Currency code, e.g. USD.'}, 'metadata': {'type': 'object', 'description': 'Arbitrary key/value metadata.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'vendorId': {'type': 'string', 'description': 'Vendor entity ID.'}, 'invoiceId': {'type': 'string', 'description': 'Invoice ID to update.'}, 'lineItems': {'type': 'array', 'items': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'description': 'Replacement line items array.'}, 'noteToSelf': {'type': 'string', 'description': 'Internal note.'}, 'invoiceDate': {'type': 'string', 'description': 'Invoice date (ISO 8601).'}, 'deductionDate': {'type': 'string', 'description': 'Scheduled payment/deduction date (ISO 8601).'}, 'invoiceNumber': {'type': 'string', 'description': 'Human-readable invoice number.'}, 'paymentSourceId': {'type': 'string', 'description': 'Payment method ID to pay from.'}, 'paymentDestinationId': {'type': 'string', 'description': 'Payment method ID to pay to.'}}}
Historique

Modifications récentes des outils

Modifié
mercoa_add_invoice_comment
1 October 2026 02:43
Modifié
mercoa_update_invoice
1 October 2026 02:43
Modifié
mercoa_create_invoice
1 October 2026 02:43
Modifié
mercoa_create_entity
1 October 2026 02:43
Modifié
mercoa_get_organization
1 October 2026 02:43
Modifié
mercoa_get_transaction
1 October 2026 02:43
Modifié
mercoa_find_transactions
1 October 2026 02:43
Modifié
mercoa_get_invoice_events
1 October 2026 02:43
Modifié
mercoa_get_invoice
1 October 2026 02:43
Modifié
mercoa_find_invoices
1 October 2026 02:43
Modifié
mercoa_list_entity_users
1 October 2026 02:43
Modifié
mercoa_get_payment_method
1 October 2026 02:43
Modifié
mercoa_list_entity_payment_methods
1 October 2026 02:43
Modifié
mercoa_get_entity_invoice_metrics
1 October 2026 02:43
Modifié
mercoa_get_entity_events
1 October 2026 02:43
Modifié
mercoa_get_entity
1 October 2026 02:43
Modifié
mercoa_find_entities
1 October 2026 02:43
Ajouté
mercoa_add_invoice_comment
21 September 2026 02:44
Ajouté
mercoa_update_invoice
21 September 2026 02:44
Ajouté
mercoa_create_invoice
21 September 2026 02:44
Ajouté
mercoa_create_entity
21 September 2026 02:44
Ajouté
mercoa_get_organization
21 September 2026 02:44
Ajouté
mercoa_get_transaction
21 September 2026 02:44
Ajouté
mercoa_find_transactions
21 September 2026 02:44
Ajouté
mercoa_get_invoice_events
21 September 2026 02:44
Ajouté
mercoa_get_invoice
21 September 2026 02:44
Ajouté
mercoa_find_invoices
21 September 2026 02:44
Ajouté
mercoa_list_entity_users
21 September 2026 02:44
Ajouté
mercoa_get_payment_method
21 September 2026 02:44
Ajouté
mercoa_list_entity_payment_methods
21 September 2026 02:44
Découvrir

Serveurs MCP similaires

Lovie Company Formation

co.lovie/company-formation

Supports company formation and business administration with bank accounts, cards, invoicing, bookkeeping, accounting periods, and…

Conta Azul MCP

io.github.douglac/contaazul-mcp

Connects to Conta Azul ERP for managing customers, sales, budgets, contracts, financial accounts, receivables, invoices, settleme…

Conta Simples

io.github.mcp-dir/contasimples-mcp

Manages Conta Simples business banking, balances, statements, invoices, corporate cards, users, categories, suppliers, and cost c…

Stratalize Finance

com.stratalize/finance

Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…

Red by Big Red Cloud

io.github.BigRedCloud/red-mcp-server

Connects to Big Red Cloud accounting for customers, suppliers, products, invoices, purchases, payments, receipts, journals, quote…

AgentLot Marketplace

io.agentlot/marketplace

Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.

GestãoClick

io.github.mcp-dir/gestaoclick-mcp

Connects to the GestãoClick ERP to manage customers, suppliers, products, sales, service orders, budgets, and financial records.

BeeL

es.beel/mcp

Provides Spanish company administration and VeriFactu-compliant invoicing, including customers, products, invoice issuance, corre…