# io.usefulapi/orb (remote · orb.usefulapi.io)

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

- Trust score: 18/100 (low)
- Change this week: −51
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `orb.usefulapi.io`: 18/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-orb/orb.md), [page](https://verifymcp.io/servers/io-usefulapi-orb/orb)

## Channel facts

- Endpoint: `https://orb.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 0/100
  - Transport check failed: declared streamable-http, but the endpoint returned HTTP 429.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

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

### Codex

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

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-orb": {
      "type": "remote",
      "url": "https://orb.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-orb --url https://orb.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-orb:
    url: "https://orb.usefulapi.io/mcp"
```

### Other

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

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 18, −55)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [security regression] Transport: pass → fail
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 73, +55)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.20

### 2026-08-01 (score 18, −54)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 72, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, −2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 70, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 69, +57)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (26)

### `orb_ping` (~26 tokens)

Ping / auth check

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

### `orb_list_customers` (~60 tokens)

List customers

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).

### `orb_get_customer` (~39 tokens)

Get customer

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

Input parameters:

- `customer_id` (string, required): Orb customer id.

### `orb_get_customer_by_external_id` (~50 tokens)

Get customer by external id

Fetch a single customer by your external customer id. Orb API: GET /customers/external_customer_id/{external_customer_id}.

Input parameters:

- `external_customer_id` (string, required): Your external customer id.

### `orb_get_customer_costs` (~104 tokens)

Get customer costs

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

Input parameters:

- `customer_id` (string, required): Orb customer id.
- `group_by` (string): Price grouping key to break costs down by.
- `timeframe_end` (string): ISO-8601 datetime, exclusive end.
- `timeframe_start` (string): ISO-8601 datetime, inclusive start.
- `view_mode` (string): periodic or cumulative.

### `orb_get_customer_credits` (~69 tokens)

Get customer credit balances

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

Input parameters:

- `currency` (string): Filter to a single currency.
- `customer_id` (string, required): Orb customer id.
- `include_all_blocks` (boolean): Include expired/depleted blocks too.

### `orb_get_customer_credits_ledger` (~120 tokens)

Get customer credit ledger

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

Input parameters:

- `currency` (string): Filter to a single currency.
- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `customer_id` (string, required): Orb customer id.
- `entry_type` (string): Filter to a ledger entry type (e.g. increment, decrement, expiration_change).
- `limit` (integer): Max items to return (1–100, default 20).

### `orb_list_plans` (~72 tokens)

List plans

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).
- `status` (string): Filter by plan status.

### `orb_get_plan` (~37 tokens)

Get plan

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

Input parameters:

- `plan_id` (string, required): Orb plan id.

### `orb_list_subscriptions` (~103 tokens)

List subscriptions

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `customer_id` (string): Filter to an Orb customer id.
- `external_customer_id` (string): Filter to your external customer id.
- `limit` (integer): Max items to return (1–100, default 20).
- `status` (string): Filter by subscription status.

### `orb_get_subscription` (~37 tokens)

Get subscription

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

Input parameters:

- `subscription_id` (string, required): Orb subscription id.

### `orb_get_subscription_costs` (~103 tokens)

Get subscription costs

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

Input parameters:

- `group_by` (string): Price grouping key to break costs down by.
- `subscription_id` (string, required): Orb subscription id.
- `timeframe_end` (string): ISO-8601 datetime, exclusive end.
- `timeframe_start` (string): ISO-8601 datetime, inclusive start.
- `view_mode` (string): periodic or cumulative.

### `orb_get_subscription_usage` (~107 tokens)

Get subscription usage

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

Input parameters:

- `granularity` (string): Time granularity for buckets (e.g. day).
- `group_by` (string): Property to group usage by.
- `subscription_id` (string, required): Orb subscription id.
- `timeframe_end` (string): ISO-8601 datetime, exclusive end.
- `timeframe_start` (string): ISO-8601 datetime, inclusive start.

### `orb_get_subscription_schedule` (~78 tokens)

Get subscription schedule

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).
- `subscription_id` (string, required): Orb subscription id.

### `orb_list_invoices` (~170 tokens)

List invoices

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `customer_id` (string): Filter to an Orb customer id.
- `date_type` (string): Which date `due_date` filters on (e.g. due_date, invoice_date).
- `due_date` (string): ISO-8601 date filter.
- `external_customer_id` (string): Filter to your external customer id.
- `limit` (integer): Max items to return (1–100, default 20).
- `status` (string): Filter by invoice status (e.g. draft, issued, paid, void).
- `subscription_id` (string): Filter to a subscription id.

### `orb_get_invoice` (~38 tokens)

Get invoice

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

Input parameters:

- `invoice_id` (string, required): Orb invoice id.

### `orb_get_upcoming_invoice` (~43 tokens)

Get upcoming invoice

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

Input parameters:

- `subscription_id` (string, required): Orb subscription id.

### `orb_list_items` (~61 tokens)

List items

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).

### `orb_get_item` (~37 tokens)

Get item

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

Input parameters:

- `item_id` (string, required): Orb item id.

### `orb_list_prices` (~60 tokens)

List prices

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).

### `orb_get_price` (~37 tokens)

Get price

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

Input parameters:

- `price_id` (string, required): Orb price id.

### `orb_list_metrics` (~62 tokens)

List billable metrics

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).

### `orb_list_coupons` (~74 tokens)

List coupons

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `limit` (integer): Max items to return (1–100, default 20).
- `show_archived` (boolean): Include archived coupons.

### `orb_list_alerts` (~108 tokens)

List alerts

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

Input parameters:

- `cursor` (string): Opaque pagination cursor (from pagination_metadata.next_cursor).
- `customer_id` (string): Filter to an Orb customer id.
- `external_customer_id` (string): Filter to your external customer id.
- `limit` (integer): Max items to return (1–100, default 20).
- `subscription_id` (string): Filter to a subscription id.

### `orb_create_customer` (~160 tokens)

Create customer

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

Input parameters:

- `currency` (string): ISO-4217 currency code for this customer.
- `email` (string, required): Customer billing email (required, must be a valid email).
- `external_customer_id` (string): Your external id for this customer.
- `metadata` (object): User-defined key/value metadata (string→string).
- `name` (string, required): Customer display name (required).
- `payment_provider` (string): External payment/invoicing provider.
- `payment_provider_id` (string): Id of this customer in the external payment provider.
- `timezone` (string): IANA timezone (e.g. America/New_York).

### `orb_update_customer` (~156 tokens)

Update customer

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

Input parameters:

- `currency` (string): New ISO-4217 currency code.
- `customer_id` (string, required): Orb customer id (required).
- `email` (string): New billing email (must be a valid email).
- `external_customer_id` (string): New external id.
- `metadata` (object): User-defined key/value metadata (string→string).
- `name` (string): New display name.
- `payment_provider` (string): External payment/invoicing provider.
- `payment_provider_id` (string): New id in the external payment provider.
- `timezone` (string): New IANA timezone.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-orb/orb#diagnostics

## Score history

- 2026-08-03: 18
- 2026-08-02: 73
- 2026-08-01: 18
- 2026-07-31: 72
- 2026-07-30: 69
- 2026-07-29: 71
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 12

## Links

- Remote endpoint: https://orb.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-orb/orb/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-orb/orb/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-orb/orb