Mercoa MCP by usefulapi

io.usefulapi由 usefulapi.io 发布官方发布者v1.36.5更新于 Nov 8, 2026

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

发布方自己的服务:Ably MCP by usefulapi

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

通过助手查询和管理 Mercoa 应付/应收账单支付:查找实体、发票、交易和支付方式,并可创建或更新发票。

可以做什么
  • 查找并读取实体(买方、供应商、付款方、收款方)及其用户、支付方式和事件日志
  • 按条件搜索和读取发票,查看发票事件历史与用于应付/应收看板的汇总发票指标
  • 搜索和读取支付交易
  • 读取组织配置
  • 创建实体和发票、更新发票(包括推进状态)以及添加发票评论
  • 查看用量、提交功能请求并管理 Pro 订阅
适用场景
当你使用 Mercoa 处理应付或应收业务,希望助手帮你查询交易对手、账单、审批和付款,或在不切换 Mercoa 后台的情况下起草和暂存发票时适用。
运行要求
远程 MCP 端点,无需本地安装。只需填写端点地址,通过 OAuth 使用 Mercoa 凭据登录;首次连接时需粘贴 Mercoa API 密钥,该密钥会被校验并按用户存储。免费方案每月 50 次工具调用。
安装前请注意
写入类工具会在 Mercoa 中创建真实实体和发票、更改发票状态或金额并发布评论,执行前应先确认。服务器会索取你的 Mercoa API 密钥,该密钥可访问组织的账单支付数据。付费方案需付费(Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元),升级会返回 Stripe 结账链接;取消当期不退款。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mercoa MCP by usefulapi,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.usefulapi%2Fmercoa/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "mercoa-by-usefulapi": {
      "type": "http",
      "url": "https://mercoa.usefulapi.io/mcp"
    }
  }
}

README

Mercoa MCP by usefulapi

Query and manage Mercoa AP/AR bill-pay — entities, invoices, transactions and payment methods — from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Mercoa API key.

Live endpoint: https://mercoa.usefulapi.io/mcp · Homepage: https://usefulapi.io/mercoa

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://mercoa.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http mercoa https://mercoa.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "mercoa": {      "url": "https://mercoa.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Mercoa credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/mercoa/

On first connect you'll paste your Mercoa API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
mercoa_find_entitiesreadFind entities
mercoa_get_entityreadGet entity
mercoa_get_entity_eventsreadGet entity events
mercoa_get_entity_invoice_metricsreadGet entity invoice metrics
mercoa_list_entity_payment_methodsreadList entity payment methods
mercoa_get_payment_methodreadGet payment method
mercoa_list_entity_usersreadList entity users
mercoa_find_invoicesreadFind invoices
mercoa_get_invoicereadGet invoice
mercoa_get_invoice_eventsreadGet invoice events
mercoa_find_transactionsreadFind transactions
mercoa_get_transactionreadGet transaction
mercoa_get_organizationreadGet organization
mercoa_create_entitywriteCreate entity
mercoa_create_invoicewriteCreate invoice
mercoa_update_invoicewriteUpdate invoice
mercoa_add_invoice_commentwriteAdd invoice comment
mercoa_usage_statusmetaUsage status (free-tier meter)
mercoa_request_featuremetaRequest a missing feature
mercoa_upgrademetaUpgrade to Pro or Pro+
mercoa_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with mercoa_upgrade (it returns a Stripe Checkout link). Cancel any time with mercoa_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running mercoa_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

来源:servers/mercoa/README.md,提交 4046075

工具

17

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.

输入参数limitsearchstatusisPayeeisPayorforeignIdisCustomerstartingAfterpaymentMethodsreturnMetadata

mercoa_get_entity

Get entity

Get a single entity by ID (or foreign ID). GET /entity/{entityId}.

输入参数entityId必填

mercoa_get_entity_events

Get entity events

Get the event/audit log for an entity. GET /entity/{entityId}/events.

输入参数limitendDateentityId必填startDatestartingAfter

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.

输入参数searchstatusendDategroupBypayerIdcurrencydateTypeentityId必填vendorIdinvoiceIdstartDateapproverId另有 4 个

mercoa_list_entity_payment_methods

List entity payment methods

List an entity's payment methods (bank accounts, cards, check, etc.). GET /entity/{entityId}/paymentMethods.

输入参数typeentityId必填

mercoa_get_payment_method

Get payment method

Get a single payment method for an entity. GET /entity/{entityId}/paymentMethod/{paymentMethodId}.

输入参数entityId必填paymentMethodId必填

mercoa_list_entity_users

List entity users

List the users belonging to an entity (approvers, admins, etc.). GET /entity/{entityId}/users.

输入参数entityId必填

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).

输入参数limitsearchstatusendDateorderBypayerIddateTypeentityIdvendorIdinvoiceIdstartDateapproverId另有 10 个

mercoa_get_invoice

Get invoice

Get a single invoice (bill) by ID. GET /invoice/{invoiceId}.

输入参数invoiceId必填

mercoa_get_invoice_events

Get invoice events

Get the event/audit log for an invoice (status changes, approvals, payments). GET /invoice/{invoiceId}/events.

输入参数limitendDateinvoiceId必填startDatestartingAfter

mercoa_find_transactions

Find transactions

List/search payment transactions. Filter by entity, invoice, status, type and date. GET /transactions.

输入参数limitsearchstatusendDatepayerIdentityIdvendorIdinvoiceIdstartDateentityGroupIdstartingAftertransactionId另有 1 个

mercoa_get_transaction

Get transaction

Get a single payment transaction by ID. GET /transaction/{transactionId}.

输入参数transactionId必填

mercoa_get_organization

Get organization

Get the caller's Mercoa organization configuration (settings, payment methods enabled, etc.). GET /organization.

无需输入参数。

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.

输入参数emailisPayeeisPayorprofileforeignIdisCustomeraccountType

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.

输入参数amountstatusdueDatepayerIdcurrencymetadatavendorIdlineItemsnoteToSelfinvoiceDatecreatorUserIddeductionDate另有 4 个

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}.

输入参数amountstatusdueDatepayerIdcurrencymetadatavendorIdinvoiceId必填lineItemsnoteToSelfinvoiceDatedeductionDate另有 3 个

mercoa_add_invoice_comment

Add invoice comment

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

输入参数text必填userIdinvoiceId必填

版本历史

22
  1. v1.36.5最新Nov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Usefulapi 集成