Recommand MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.0.0更新於 Nov 7, 2026

Read documents and the inbox, verify Peppol recipients and send invoices in Recommand.

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行金融商業與電商

概覽

AI 產生的概覽

面向 Recommand 電子發票的託管 MCP 伺服器:讀取公司、文件與收件匣,驗證 Peppol 收件方,並寄送發票。

可以做什麼
  • 列出並取得公司資訊,含驗證與 Peppol 註冊狀態
  • 列出標籤,並依方向、日期、已讀狀態、標籤或投遞失敗篩選已寄出與已收到的文件
  • 取得單一文件的解析內容與投遞狀態,列出收件匣中未讀的文件
  • 寄送前驗證 Peppol 位址,並將文件標記為已讀或未讀
  • 透過 Peppol、電子郵件或兩者寄送真實發票
  • 查看用量、提出功能需求、升級或取消訂閱
適用情境
當你使用 Recommand 處理電子發票,並希望助理整理收件匣、找出未送達買方的發票、確認某個 Peppol 位址是否已註冊,或直接在對話中寄送發票時適用。
執行需求
遠端端點 recommand.usefulapi.io/mcp,無需本機安裝。透過 OAuth 登入,首次連線時需提供 Recommand 後台中基本 API 金鑰的 key id 與 secret(不接受 JWT 金鑰),金鑰不寫入用戶端設定。需要方案:免費版每月 50 次工具呼叫。
安裝前請注意
recommand_send_invoice 會透過 Peppol 或電子郵件寄送真實發票,無法復原,並計入訂閱用量;寄送前應先驗證買方,逾時後不要重試,而應先列出已寄出的文件。標記已讀會改變收件匣狀態。API 金鑰 secret 於登入時輸入並依使用者儲存。升級工具會回傳 Stripe 結帳付款連結,付費方案需付費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Recommand MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Frecommand/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

README

Recommand MCP by usefulapi

Use your Recommand account from Claude, Cursor, or any MCP client. It reads companies, documents, the inbox and Peppol recipients, and it sends invoices by Peppol or email. Hosted, no local install: connect with your own credentials.

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

Connect

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

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

On first connect you provide your API key id (key_…) and your API key secret (secret_…) of a basic API key from the Recommand dashboard. JWT keys are not accepted. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
recommand_list_companiesreadList companies
recommand_get_companyreadGet a company
recommand_list_labelsreadList labels
recommand_list_documentsreadList documents
recommand_get_documentreadGet a document
recommand_get_inboxreadGet the inbox
recommand_verify_recipientreadVerify a Peppol recipient
recommand_send_invoicewriteSend an invoice
recommand_mark_document_readwriteMark a document as read
recommand_usage_statusmetaUsage status (free-tier meter)
recommand_request_featuremetaRequest a missing feature
recommand_upgrademetaUpgrade to Pro or Pro+
recommand_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)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 recommand_upgrade (it returns a Stripe Checkout link). Cancel any time with recommand_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running recommand_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/recommand/README.md,提交 2450437

工具

9

recommand_list_companies

List companies

List every company registered under the team, with its verification and Peppol registration status. Start here to get company ids. Not paginated. Recommand API: GET /api/v1/companies.

輸入參數vatNumberenterpriseNumber

recommand_get_company

Get a company

Get one company with its verification and Peppol registration status. Recommand API: GET /api/v1/companies/{companyId}.

輸入參數companyId必填

recommand_list_labels

List labels

List every label in the team. Use a label id with recommand_list_documents (labelId). Recommand API: GET /api/v1/labels.

無需輸入參數。

recommand_list_documents

List documents

List sent and received documents, one page at a time. Filter by company, direction, read status, dates, label or failed delivery (deliveryFailed true finds sends that need attention). Recommand API: GET /api/v1/documents.

輸入參數tofrompagelimitsearchlabelIdisUnreadcompanyIddirectiondeliveryFailedexcludeAttachments

recommand_get_document

Get a document

Get one sent or received document with its parsed content and delivery status. Recommand API: GET /api/v1/documents/{documentId}.

輸入參數documentId必填

recommand_get_inbox

Get the inbox

List incoming documents that are not marked as read yet. Process a document, then call recommand_mark_document_read so it leaves the inbox. Not paginated. Recommand API: GET /api/v1/inbox.

輸入參數companyId

recommand_verify_recipient

Verify a Peppol recipient

Look up a Peppol address in the directory before sending. Reports whether it is registered, the company name and the document types it accepts. isValid false means the lookup failed. Recommand API: POST /api/v1/verify.

輸入參數peppolAddress必填includeBusinessCardincludeEndpointDetails

recommand_send_invoice

Send an invoice

SENDS A REAL INVOICE over the Peppol network, by email, or both. This cannot be undone, and each send counts toward the subscription usage. Check the buyer with recommand_verify_recipient first. Do NOT retry after a timeout: list the outgoing documents first, because the invoice may already be sent. If Peppol delivery fails and no email fallback applies, the call returns HTTP 422 and stores nothing. Recommand API: POST /api/v1/{companyId}/send.

輸入參數emailinvoice必填companyId必填recipient必填pdfGeneration

recommand_mark_document_read

Mark a document as read

Mark a document as read, which removes it from the inbox. Pass read false to mark it unread again. Calling it again with the same value does no harm. Recommand API: POST /api/v1/documents/{documentId}/mark-as-read.

輸入參數readdocumentId必填

版本歷史

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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合