Marmin MCP by usefulapi

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

Read invoices, credit notes, XML, Peppol status logs and business profiles in Marmin.

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

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

概览

AI 生成的概览

只读访问 Marmin 的阿联酋电子发票数据:发票、贷项通知单、UBL XML、Peppol 状态与业务档案。

可以做什么
  • 列出并读取业务档案,含 TRN、Peppol 端点和入驻状态
  • 列出发票、贷项通知单和形式发票,或按日期列出当天创建的文档 ID
  • 读取单据的交易方、明细行、税额拆分、合计,以及 UBL 2.1 PINT AE 格式的 XML
  • 查询 Peppol 传输状态和按时间排序的状态日志,了解单据被拒的原因
  • 查询登记簿条目和代码表,如税种、计量单位和酋长国代码
  • 查看当月用量并管理订阅方案
适用场景
适合在 Marmin 中处理阿联酋电子发票时使用:让助手查询发票、追踪 Peppol 投递或被拒原因、核对业务档案与登记簿信息,而无需打开后台面板。
运行要求
远程托管端点,无需本地安装。只需填写服务器地址,通过 OAuth 登录,并提供环境(生产或沙箱)、以 org_ 开头的 Client ID 和 Client Secret(来自 Marmin 开发者后台)。需要 Marmin 账户;免费方案每月 50 次工具调用。
安装前请注意
OAuth 登录时需提交 Marmin API 凭据(Client ID 与 Client Secret),服务器按用户保存。付费方案会产生费用:Pro 每月 9 美元或每年 90 美元,Pro+ 每月 39 美元或每年 390 美元,通过 Stripe 结账链接付款;从 Pro 升级到 Pro+ 会立即收取差价,取消当期不退款。所列工具为只读,但元工具可更改订阅。

安装

在 SourceWeft 中

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

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

交给智能体安装

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

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

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

其他 MCP 客户端

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

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

README

Marmin MCP by usefulapi

Use your Marmin account from Claude, Cursor, or any MCP client. Read UAE e-invoices, credit notes, Peppol status and business profiles. Hosted, no local install: connect with your own credentials.

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

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://marmin.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http marmin https://marmin.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": {    "marmin": {      "url": "https://marmin.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 Marmin credentials.

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

On first connect you provide the Environment (production or sandbox), your Client ID (starts with org_) and your Client Secret (shown after an email code). Find them in the Marmin Developer Dashboard, under Settings, then API Configuration. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
marmin_list_business_profilesreadList business profiles
marmin_get_business_profilereadGet a business profile
marmin_list_documentsreadList documents
marmin_list_document_uuidsreadList document ids created on a day
marmin_get_documentreadGet a document
marmin_get_document_xmlreadGet the UBL XML of a document
marmin_get_peppol_statusreadGet the Peppol status of a document
marmin_get_peppol_status_logreadGet the Peppol status log of a document
marmin_get_register_entryreadGet a register entry
marmin_get_codelistreadGet a code list
marmin_usage_statusmetaUsage status (free-tier meter)
marmin_request_featuremetaRequest a missing feature
marmin_upgrademetaUpgrade to Pro or Pro+
marmin_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 (per user)$9/mo or $90/yr (2 months free)10,000 tool calls / month
Pro+ (per user)$39/mo or $390/yr (2 months free)100,000 tool calls / month

Each paid plan covers this server only. Ask your AI to run marmin_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with marmin_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with marmin_upgrade before then undoes the cancel. Or write to [email protected].

License

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

来源:servers/marmin/README.md,提交 6d32263

工具

10

marmin_list_business_profiles

List business profiles

List the Marmin business profiles (legal entities) of this organization, with TRN, TIN, Peppol endpoint and onboarding status. Use profile_id from the result to know which entity a document belongs to. Read-only. Limit: 30 requests/minute.

输入参数namepageemailstatuspage_size

marmin_get_business_profile

Get a business profile

Get one business profile by its profile_id (for example MBP-00001): legal name, TRN, trade license, Peppol endpoint, address and onboarding status. Read-only.

输入参数profile_id必填

marmin_list_documents

List documents

List tax invoices, credit notes or proforma invoices of one kind, newest first as Marmin returns them. Each item has the number, dates, type code (380 invoice, 381 credit note, 389 self-billed, 261 self-billed credit note), parties, amounts and currency. Filter by number, party name, VAT number, status or issue date. Read-only. Limit: 60 requests/minute.

输入参数kind必填pagesizestatusbilled_by_vatbilled_to_vatdocument_datebilled_by_namebilled_to_nameinvoice_numberdocument_number

marmin_list_document_uuids

List document ids created on a day

List the ids (UUIDs) of all documents of one kind that were created on one day. Use it to find new documents day by day, then read each with marmin_get_document. Read-only.

输入参数kind必填pagesizecreated_on必填

marmin_get_document

Get a document

Get one invoice, credit note or proforma invoice by id: parties, lines, tax breakdown, totals (also in AED) and meta_info.peppol_status (overall_status PENDING, APPROVED, REJECTED or VALIDATION_FAILED, with validation_results). Read-only.

输入参数id必填kind必填

marmin_get_document_xml

Get the UBL XML of a document

Get the UAE e-invoicing XML (UBL 2.1, PINT AE) of an invoice or credit note. Long XML is cut by the server's result size limit. Read-only.

输入参数id必填kind必填

marmin_get_peppol_status

Get the Peppol status of a document

Get the current Peppol transmission snapshot of an invoice or credit note: the billing leg (toC3, to the buyer's access point) and the tax-reporting leg (toC5, to the FTA), each with status and transmission errors, plus validation results. The XML copies are left out. Needs Phase 2 in the Marmin subscription (else HTTP 404). Read-only.

输入参数id必填kind必填

marmin_get_peppol_status_log

Get the Peppol status log of a document

Get the time-ordered Peppol events of a sales invoice, sales credit note or purchase credit note (DOCUMENT_CREATED, DOCUMENT_SUBMITTED, VALIDATION_SUCCESS and so on) with a message each. Use it to see why a document was rejected. The XML copies are left out. Read-only.

输入参数id必填kind必填

marmin_get_register_entry

Get a register entry

Get one document register entry (the sales or purchase register of a business profile) by its id, including the linked document_id for e-invoices. Read-only.

输入参数id必填

marmin_get_codelist

Get a code list

Get a Marmin code list: valid values for invoice fields, for example tax-categories, unit-of-measure-codes, uae-subdivisions (emirate codes), currencies, credit-note-reason-codes, payment-means-modes, tax-exemption-reason-codes. Read-only.

输入参数list必填

版本历史

1
  1. v1.0.0最新Nov 14, 2026

评分

已满足适用检查项的 100%

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

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

其他 Usefulapi 集成