Mercoa MCP by usefulapi

Working · 583 ms

io.usefulapi/mercoav1.19.0 Domain verified

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

Finance & Payments

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mercoa.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

mercoa_add_invoice_comment Destructive

WRITE — adds a comment to an invoice (visible in its activity log). POST /invoice/{invoiceId}/comment.

textstring, required

Comment text.

invoiceIdstring, required

Invoice ID to comment on.

userIdstring

ID or foreign ID of the user creating the comment.

The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.

I understand, run it anyway

Argument	Type	Description
email	string	Primary email for the entity.
isPayee	boolean	Whether this entity can receive payments (AR / vendor).
isPayor	boolean	Whether this entity can pay invoices (AP).
profile	object	Nested profile object, e.g. { "business": { "legalBusinessName": "Acme Inc.", "email": "[email protected]", "businessType": "llc" } } or { "individual": { "name": {...}, "email": "..." } }.
foreignId	string	Your system's ID for this entity.
isCustomer	boolean	Whether this entity has a direct relationship with your organization.
accountType	string	business or individual.

Argument	Type	Description
amount	number	Total invoice amount.
status	string	Invoice status, e.g. DRAFT, NEW, APPROVED, SCHEDULED.
dueDate	string	Due date (ISO 8601).
payerId	string	Payer entity ID (who owes).
currency	string	Currency code, e.g. USD.
metadata	object	Arbitrary key/value metadata.
vendorId	string	Vendor entity ID (who is paid).
lineItems	array	Line items array, e.g. [{ "amount": 100, "currency": "USD", "description": "Product A", "quantity": 1, "unitPrice": 100 }].
noteToSelf	string	Internal note.

Argument	Type	Description
limit	integer	Max entities to return (1-100, default 10).
search	string	Search by name, email, emailTo, entity ID, or foreign ID (partial matches).
status	any	Entity status filter (e.g. verified, pending).
isPayee	boolean	Filter entities marked as payees.
isPayor	boolean	Filter entities marked as payors.
foreignId	any	Your system's ID(s) for the entity.
isCustomer	boolean	If true, only entities with a direct relationship to your organization.
startingAfter	string	Entity ID cursor for pagination.
paymentMethods	boolean	If true, include payment methods in the response.

Argument	Type	Description
limit	integer	Max invoices to return (1-100, default 10).
search	string	Search by vendor name, invoice number, check number, or amount.
status	any	Invoice status filter (e.g. DRAFT, NEW, APPROVED, SCHEDULED, PAID).
endDate	string	End date filter (ISO 8601).
orderBy	string	Field to order by (e.g. CREATED_AT, AMOUNT, DUE_DATE).
payerId	any	Filter by payer ID(s) or foreign ID(s).
dateType	string	Date type to filter by (e.g. CREATED_AT, DUE_DATE).
entityId	any	Filter by entity (payer or vendor) ID(s) or foreign ID(s).
vendorId	any	Filter by vendor ID(s) or foreign ID(s).

Argument	Type	Description
limit	integer	Max transactions to return (1-100, default 10).
search	string	Search by vendor name, invoice number, check number, or amount.
status	any	Transaction status filter.
endDate	string	CREATED_AT end date filter (ISO 8601).
payerId	any	Filter by payer ID(s).
entityId	any	Filter by entity ID(s) or foreign ID(s).
vendorId	any	Filter by vendor ID(s).
invoiceId	any	Filter by invoice ID(s) or foreign ID(s).
startDate	string	CREATED_AT start date filter (ISO 8601).
entityGroupId

Argument	Type	Description
text*	string	Comment text.
userId	string	ID or foreign ID of the user creating the comment.
invoiceId*	string	Invoice ID to comment on.

Argument	Type	Description
limit	integer	Max events to return (1-100).
endDate	string	End date filter (ISO 8601).
entityId*	string	Entity ID or foreign ID.
startDate	string	Start date filter (ISO 8601).
startingAfter	string	Event ID cursor for pagination.

Argument	Type	Description
type	string	Filter by payment method type (e.g. bankAccount, card, check).
entityId*	string	Entity ID or foreign ID.

Try it

mercoa_add_invoice_comment Destructive

Try it

mercoa_add_invoice_comment Destructive

Tools (17)