MCP server
Orb MCP by usefulapi
Read Orb customers, subscriptions, invoices, usage and costs; create or update customers.
- Runs
- Remotely
- Version
- 1.40.0
- Listing updated
- 4 days ago
About Orb MCP by usefulapi
Orb MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http orb https://orb.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://orb.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"orb": {
"url": "https://orb.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"orb": {
"type": "http",
"url": "https://orb.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"orb": {
"serverUrl": "https://orb.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"orb": {
"type": "http",
"url": "https://orb.usefulapi.io/mcp"
}
}
}Tools this server provides (26)
Read directly from the server.
- orb_ping
- Health and auth check — verifies the API key works. Orb API: GET /ping.
- orb_list_customers
- List customers in the Orb account. Orb API: GET /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_list_plans
- List plans configured in the Orb account. Orb API: GET /plans.
- orb_get_plan
- Fetch a single plan by id. Orb API: GET /plans/{plan_id}.
- orb_list_subscriptions
- List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions.
- 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_usage
- Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage.
- orb_get_subscription_schedule
- Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule.
- orb_list_invoices
- List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices.
- orb_get_invoice
- Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}.
- orb_get_upcoming_invoice
- Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming.
- orb_list_items
- List items (the things you bill for). Orb API: GET /items.
- orb_get_item
- Fetch a single item by id. Orb API: GET /items/{item_id}.
- orb_list_prices
- List prices configured in the Orb account. Orb API: GET /prices.
- orb_get_price
- Fetch a single price by id. Orb API: GET /prices/{price_id}.
- orb_list_metrics
- List billable metrics configured in the Orb account. Orb API: GET /metrics.
- orb_list_coupons
- List coupons in the Orb account. Orb API: GET /coupons.
- orb_list_alerts
- List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts.
- orb_create_customer
- Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers.
- orb_update_customer
- Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}.
Orb MCP by usefulapi FAQ
How do I add Orb MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http orb https://orb.usefulapi.io/mcp