usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://mercoa.usefulapi.io/mcp
Authenticate with Mercoa when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

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

live19 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 19

Tool	Type	What it does
`mercoa_find_entities`	read	Find entities Search and list entities — buyers, vendors, payors and payees — by name, email, foreign ID or role, with cursor pagination.
`mercoa_get_entity`	read	Get entity Fetch a single entity's full record by its Mercoa entity ID or your own foreign ID.
`mercoa_get_entity_events`	read	Get entity events Retrieve the chronological event and audit log for an entity within an optional date range.
`mercoa_get_entity_invoice_metrics`	read	Get entity invoice metrics Aggregate an entity's payable and receivable invoice totals and counts, grouped by currency, status or date, for AP/AR dashboards and aging reports.
`mercoa_list_entity_payment_methods`	read	List entity payment methods List an entity's payment methods such as bank accounts, cards and checks.
`mercoa_get_payment_method`	read	Get payment method Fetch a single payment method belonging to an entity by its payment-method ID.
`mercoa_list_entity_users`	read	List entity users List the users attached to an entity, including approvers and admins.
`mercoa_find_invoices`	read	Find invoices Search and filter invoices (bills) across payers and vendors by status, entity, date, approver, payment type and more.
`mercoa_get_invoice`	read	Get invoice Fetch a single invoice (bill) with all of its details by invoice ID.
`mercoa_get_invoice_events`	read	Get invoice events Retrieve an invoice's event and audit log covering status changes, approvals and payments.
`mercoa_find_transactions`	read	Find transactions List and search payment transactions filtered by entity, invoice, status, type and date.
`mercoa_get_transaction`	read	Get transaction Fetch a single payment transaction by its transaction ID.
`mercoa_get_organization`	read	Get organization Get the caller's Mercoa organization configuration, including enabled payment methods and settings.
`mercoa_create_entity`	write	Create entity Create a new entity — customer, vendor, payor or payee — with role flags, account type and a nested business or individual profile.
`mercoa_create_invoice`	write	Create invoice Create a new invoice/bill with amount, currency, payer, vendor, dates and line items, staged as a draft or submitted.
`mercoa_update_invoice`	write	Update invoice Update an existing invoice/bill — advance its status or change amounts, dates, payment methods or line items.
`mercoa_add_invoice_comment`	write	Add invoice comment Add a comment to an invoice, recorded in its activity log.
`mercoa_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`mercoa_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Mercoa tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.