Orb MCP Server

io.usefulapi/orb

answering

Orb is answering right now. Last checked 11 min ago. It exposes 26 tools. Last commit 1 Aug 2026.

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

Uptime history 39 hours of history · worst hour 0%

39 hours agonow

26.4%

Uptime 24h

24 of 91 checks

Tools

read from the server

156 ms

Response time

average over 24h

Stars

last commit 1 Aug 2026

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add orb --transport http https://orb.usefulapi.io/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.orb]
url = "https://orb.usefulapi.io/mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 26

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

orb

orb_create_customer

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

orb_get_customer

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

orb_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

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

orb_get_customer_credits

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

orb_get_customer_credits_ledger

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

orb_get_invoice

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

orb_get_item

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

orb_get_plan

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

orb_get_price

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

orb_get_subscription

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

orb_get_subscription_costs

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

orb_get_subscription_schedule

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

orb_get_subscription_usage

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

orb_get_upcoming_invoice

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

orb_list_alerts

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

orb_list_coupons

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

orb_list_customers

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

orb_list_invoices

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

orb_list_items

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

orb_list_metrics

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

orb_list_plans

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

orb_list_prices

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

orb_list_subscriptions

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

orb_ping

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

orb_update_customer

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

Endpoints

URL	Transport	State	Latency	Checked
https://orb.usefulapi.io/mcp	streamable-http	answering	242 ms	11 min ago

Orb — questions

Answers built from our own checks of this server.

What can Orb do?

It exposes 26 tools, read directly from the server on our last check. Among them: orb_create_customer, orb_get_customer, orb_get_customer_by_external_id, orb_get_customer_costs, orb_get_customer_credits, orb_get_customer_credits_ledger and 20 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is Orb working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 24 of 91 checks got a reply (26.4%), average response time 156 ms. The bar chart above shows every period we have measured.

How do I connect Orb?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Orb need an API key?

No. Orb completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 26 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Orb?

It answers our handshake in 156 ms on average, which is faster than 72% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Orb open source?

Yes — it is published under the MIT licence, written in JavaScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.