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 集成