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 整合