# Orb MCP by usefulapi

> Orb MCP by usefulapi is an MCP server. Read Orb customers, subscriptions, invoices, usage and costs; create or update customers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/orb/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/orb
- **MCP Registry name:** io.usefulapi/orb
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://orb.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "orb": {
      "type": "http",
      "url": "https://orb.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "orb": {
      "serverUrl": "https://orb.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "orb": {
      "type": "http",
      "url": "https://orb.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `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}.

## 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

---
Source: https://ai-powered.com/mcp/orb-mcp-by-usefulapi
