usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://orb.usefulapi.io/mcp
Authenticate with Orb when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "orb": {
      "url": "https://orb.usefulapi.io/mcp"
    }
  }
}

live28 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 28

Tool	Type	What it does
`orb_ping`	read	Ping / auth check Health and auth check — verifies the API key works. Orb API: GET /ping.
`orb_list_customers`	read	List customers List customers in the Orb account. Orb API: GET /customers.
`orb_get_customer`	read	Get customer Fetch a single customer by Orb customer id. Orb API: GET /customers/{customer_id}.
`orb_get_customer_by_external_id`	read	Get customer by external id Fetch a single customer by your external customer id. Orb API: GET /customers/external_customer_id/{external_customer_id}.
`orb_get_customer_costs`	read	Get customer costs Get costs incurred by a customer over a timeframe. Orb API: GET /customers/{customer_id}/costs.
`orb_get_customer_credits`	read	Get customer credit balances Get a customer's credit balances by currency. Orb API: GET /customers/{customer_id}/credits.
`orb_get_customer_credits_ledger`	read	Get customer credit ledger Get the append-only credit ledger for a customer. Orb API: GET /customers/{customer_id}/credits/ledger.
`orb_list_plans`	read	List plans List plans configured in the Orb account. Orb API: GET /plans.
`orb_get_plan`	read	Get plan Fetch a single plan by id. Orb API: GET /plans/{plan_id}.
`orb_list_subscriptions`	read	List subscriptions List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions.
`orb_get_subscription`	read	Get subscription Fetch a single subscription by id. Orb API: GET /subscriptions/{subscription_id}.
`orb_get_subscription_costs`	read	Get subscription costs Get costs for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/costs.
`orb_get_subscription_usage`	read	Get subscription usage Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage.
`orb_get_subscription_schedule`	read	Get subscription schedule Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule.
`orb_list_invoices`	read	List invoices List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices.
`orb_get_invoice`	read	Get invoice Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}.
`orb_get_upcoming_invoice`	read	Get upcoming invoice Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming.
`orb_list_items`	read	List items List items (the things you bill for). Orb API: GET /items.
`orb_get_item`	read	Get item Fetch a single item by id. Orb API: GET /items/{item_id}.
`orb_list_prices`	read	List prices List prices configured in the Orb account. Orb API: GET /prices.
`orb_get_price`	read	Get price Fetch a single price by id. Orb API: GET /prices/{price_id}.
`orb_list_metrics`	read	List billable metrics List billable metrics configured in the Orb account. Orb API: GET /metrics.
`orb_list_coupons`	read	List coupons List coupons in the Orb account. Orb API: GET /coupons.
`orb_list_alerts`	read	List alerts List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts.
`orb_create_customer`	write	Create customer Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers.
`orb_update_customer`	write	Update customer Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}.
`orb_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`orb_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED Orb tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.