# Usefulapi Orb MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.usefulapi%2Forb
Registry id: `mcp-registry/io.usefulapi/orb`
Status: auth-required (checked 2026-10-27T02:35:12.884Z)

## Verdict

Usefulapi Orb MCP server answered 100% of Glimind's liveness checks over 30 days, better than 42% of MCP servers, with 63 ms median handshake and 0 outages in 90 days. Its agent-readiness grade is A (96/100) across 26 tools, costing an agent about 4,028 tokens to load. Checked every few minutes; no tool is ever called.

## Measurements (30 days)

| Metric | Value | Better than |
|---|---|---|
| Uptime, 30 days | 100% | 42% of MCP servers |
| Median handshake latency | 63 ms | 88% of MCP servers |
| p95 handshake latency | 318 ms | — |
| Checks in 30 days | 214 | — |
| Outages, 90 days | 0 | — |
| Median recovery | — | — |
| Agent-readiness score | 96/100 (A) | 82% of MCP servers |
| Tools | 26 | — |
| Tool-list size for an agent | ~4,028 tokens | 41% of MCP servers |
| Days observed | 28 | — |

## Install

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

Claude Code:

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

## Tools (26)

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

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.