Orb MCP by usefulapi

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:

{
  "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

Tool	Type	What it does
orb_ping	read	Ping / auth check
orb_list_customers	read	List customers
orb_get_customer	read	Get customer
orb_get_customer_by_external_id	read	Get customer by external id
orb_get_customer_costs	read	Get customer costs
orb_get_customer_credits	read	Get customer credit balances
orb_get_customer_credits_ledger	read	Get customer credit ledger
orb_list_plans	read	List plans
orb_get_plan	read	Get plan
orb_list_subscriptions	read	List subscriptions
orb_get_subscription	read	Get subscription
orb_get_subscription_costs	read	Get subscription costs
orb_get_subscription_usage	read	Get subscription usage
orb_get_subscription_schedule	read	Get subscription schedule
orb_list_invoices	read	List invoices
orb_get_invoice	read	Get invoice
orb_get_upcoming_invoice	read	Get upcoming invoice
orb_list_items	read	List items
orb_get_item	read	Get item
orb_list_prices	read	List prices
orb_get_price	read	Get price
orb_list_metrics	read	List billable metrics
orb_list_coupons	read	List coupons
orb_list_alerts	read	List alerts
orb_create_customer	write	Create customer
orb_update_customer	write	Update customer
orb_usage_status	meta	Usage status (free-tier meter)
orb_request_feature	meta	Request a missing feature
orb_upgrade	meta	Upgrade to Pro (unlimited*)
orb_cancel_subscription	meta	Cancel 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

Plan	Price	Limit
Free	$0	50 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.