Orb MCP by usefulapi

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

Read Orb customers, subscriptions, invoices, usage and costs; create or update customers.

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

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

概覽

AI 產生的概覽

託管的 MCP 伺服器,讓助理讀取 Orb 計費資料(客戶、訂閱、發票、用量與成本),並可建立或更新客戶。

可以做什麼
  • 檢查 API 金鑰是否可用,並查看本月工具呼叫額度
  • 列出與查詢客戶(含依外部 ID 查詢),以及客戶成本、信用餘額和信用流水
  • 列出與查詢方案、訂閱、訂閱成本、計量用量與方案變更排程
  • 列出與查詢發票、預覽即將產生的草稿發票,並列出計費項目、價格、指標、優惠券和警示
  • 建立新客戶或更新現有客戶資料
  • 管理此伺服器本身的方案:提出功能請求、升級或取消訂閱
適用情境
適合用自然語言查詢 Orb 依用量計費的情況,例如查看某訂閱某段期間的用量、找出未付款發票及其所屬客戶、預覽下一張發票,而不必開啟 Orb 後台。
執行需求
遠端 streamable HTTP 端點,無需本機安裝。只需填入 URL,透過 OAuth 登入,首次連線時貼上 Orb API 金鑰,金鑰會驗證並依使用者儲存。免費額度為每月 50 次工具呼叫。
安裝前請注意
OAuth 登入時需提供 Orb API 金鑰,不要把它當成標頭寫進用戶端設定。有兩個工具會寫入 Orb:建立客戶和更新客戶資料。付費方案需付費(說明中 Pro 為每月 9 美元,Pro+ 為每月 39 美元),升級會回傳 Stripe 結帳連結,取消當期不退款。你的 Orb 計費資料會經過第三方託管服務。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

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

README

Orb MCP by usefulapi

Query and manage your Orb usage-based billing from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Orb API key.

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

Connect

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

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

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

Tools

ToolTypeWhat it does
orb_pingreadPing / auth check
orb_list_customersreadList customers
orb_get_customerreadGet customer
orb_get_customer_by_external_idreadGet customer by external id
orb_get_customer_costsreadGet customer costs
orb_get_customer_creditsreadGet customer credit balances
orb_get_customer_credits_ledgerreadGet customer credit ledger
orb_list_plansreadList plans
orb_get_planreadGet plan
orb_list_subscriptionsreadList subscriptions
orb_get_subscriptionreadGet subscription
orb_get_subscription_costsreadGet subscription costs
orb_get_subscription_usagereadGet subscription usage
orb_get_subscription_schedulereadGet subscription schedule
orb_list_invoicesreadList invoices
orb_get_invoicereadGet invoice
orb_get_upcoming_invoicereadGet upcoming invoice
orb_list_itemsreadList items
orb_get_itemreadGet item
orb_list_pricesreadList prices
orb_get_pricereadGet price
orb_list_metricsreadList billable metrics
orb_list_couponsreadList coupons
orb_list_alertsreadList alerts
orb_create_customerwriteCreate customer
orb_update_customerwriteUpdate customer
orb_usage_statusmetaUsage status (free-tier meter)
orb_request_featuremetaRequest a missing feature
orb_upgrademetaUpgrade to Pro or Pro+
orb_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 orb_upgrade (it returns a Stripe Checkout link). Cancel any time with orb_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running orb_upgrade before then undoes the cancel. Or write to [email protected].

License

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

來源:servers/orb/README.md,提交 4046075

工具

26

orb_ping

Ping / auth check

Health and auth check — verifies the API key works. Orb API: GET /ping.

無需輸入參數。

orb_list_customers

List customers

List customers in the Orb account. Orb API: GET /customers.

輸入參數limitcursor

orb_get_customer

Get customer

Fetch a single customer by Orb customer id. Orb API: GET /customers/{customer_id}.

輸入參數customer_id必填

orb_get_customer_by_external_id

Get customer by external id

Fetch a single customer by your external customer id. Orb API: GET /customers/external_customer_id/{external_customer_id}.

輸入參數external_customer_id必填

orb_get_customer_costs

Get customer costs

Get costs incurred by a customer over a timeframe. Orb API: GET /customers/{customer_id}/costs.

輸入參數group_byview_modecustomer_id必填timeframe_endtimeframe_start

orb_get_customer_credits

Get customer credit balances

Get a customer's credit balances by currency. Orb API: GET /customers/{customer_id}/credits.

輸入參數currencycustomer_id必填include_all_blocks

orb_get_customer_credits_ledger

Get customer credit ledger

Get the append-only credit ledger for a customer. Orb API: GET /customers/{customer_id}/credits/ledger.

輸入參數limitcursorcurrencyentry_typecustomer_id必填

orb_list_plans

List plans

List plans configured in the Orb account. Orb API: GET /plans.

輸入參數limitcursorstatus

orb_get_plan

Get plan

Fetch a single plan by id. Orb API: GET /plans/{plan_id}.

輸入參數plan_id必填

orb_list_subscriptions

List subscriptions

List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions.

輸入參數limitcursorstatuscustomer_idexternal_customer_id

orb_get_subscription

Get subscription

Fetch a single subscription by id. Orb API: GET /subscriptions/{subscription_id}.

輸入參數subscription_id必填

orb_get_subscription_costs

Get subscription costs

Get costs for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/costs.

輸入參數group_byview_modetimeframe_endsubscription_id必填timeframe_start

orb_get_subscription_usage

Get subscription usage

Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage.

輸入參數group_bygranularitytimeframe_endsubscription_id必填timeframe_start

orb_get_subscription_schedule

Get subscription schedule

Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule.

輸入參數limitcursorsubscription_id必填

orb_list_invoices

List invoices

List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices.

輸入參數limitcursorstatusdue_datedate_typecustomer_idsubscription_idexternal_customer_id

orb_get_invoice

Get invoice

Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}.

輸入參數invoice_id必填

orb_get_upcoming_invoice

Get upcoming invoice

Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming.

輸入參數subscription_id必填

orb_list_items

List items

List items (the things you bill for). Orb API: GET /items.

輸入參數limitcursor

orb_get_item

Get item

Fetch a single item by id. Orb API: GET /items/{item_id}.

輸入參數item_id必填

orb_list_prices

List prices

List prices configured in the Orb account. Orb API: GET /prices.

輸入參數limitcursor

orb_get_price

Get price

Fetch a single price by id. Orb API: GET /prices/{price_id}.

輸入參數price_id必填

orb_list_metrics

List billable metrics

List billable metrics configured in the Orb account. Orb API: GET /metrics.

輸入參數limitcursor

orb_list_coupons

List coupons

List coupons in the Orb account. Orb API: GET /coupons.

輸入參數limitcursorshow_archived

orb_list_alerts

List alerts

List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts.

輸入參數limitcursorcustomer_idsubscription_idexternal_customer_id

orb_create_customer

Create customer

Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers.

輸入參數name必填email必填currencymetadatatimezonepayment_providerpayment_provider_idexternal_customer_id

orb_update_customer

Update customer

Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}.

輸入參數nameemailcurrencymetadatatimezonecustomer_id必填payment_providerpayment_provider_idexternal_customer_id

版本歷史

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