io.usefulapi/orb

REMOTE · ORB.USEFULAPI.IO · SCANNED AUG 3

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

Available components

−51 this week 18 18 Trust /100

Trust breakdown (6 categories)

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. How we score →

Endpoint Security46

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail

Transport & Reachability0

Transport check failed: declared streamable-http, but the endpoint returned HTTP 429. See how to fix → View diagnostics → Fail

Schema Quality & AI Usability0

Schema not yet verified: we couldn't read the endpoint's schema.Unverified

Stability & Change Management0

Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified

Tool Coverage0

Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified

Capabilities0

Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified

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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · orb.usefulapi.io

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

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

# ~/.codex/config.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
    }
  }
}

# add to OpenClaw

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

# ~/.hermes/config.yaml

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

// mcp.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 we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

3 Aug 26 −55
- Endpoint reachability: reachable → not serving MCP ▼ security
- Authorization: pass → unverified ▼ security
- Stability: 0.20 → unverified ▼ security
- Transport: pass → fail ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
2 Aug 26 +55
- Authorization: unverified → pass ▲ security
- Transport: fail → pass ▲ security
- MCP protocol: unverified → fail ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.20 ▲ functional
1 Aug 26 −54
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +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.
28 Jul 26 +1
- Stability: unverified → 0.03 ▲ functional
27 Jul 26 +57
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://orb.usefulapi.io/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=usefulapi.io	CN=WE1,O=Google Trust Services,C=US	17 Jul 2026	15 Oct 2026	ECDSA 256	ECDSA-SHA256	534f9fe8504c7bdb0e109ffecae581b1
SANs: usefulapi.io, orb.usefulapi.io, *.orb.usefulapi.io
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC insecure

Validation of orb.usefulapi.io. — Not signed

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
io.	present	57355	8	Verified
usefulapi.io.	absent			Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	429

Header	Value
x-frame-options	SAMEORIGIN
referrer-policy	same-origin

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://orb.usefulapi.io/mcp	HTTP error	429
http (plaintext)	http://orb.usefulapi.io/mcp	Inconclusive	429

MCP tools — 26 exposed · ~2,011 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

orb_create_customer Create customer ~160

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

Input Output Examples

Name	Type	Req	Description
currency	string	—	ISO-4217 currency code for this customer.
email	string	yes	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	yes	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).

No output schema declared.

No examples provided.

orb_get_customer Get customer ~39

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

Input Output Examples

Name	Type	Req	Description
customer_id	string	yes	Orb customer id.

No output schema declared.

No examples provided.

orb_get_customer_by_external_id Get customer by external id ~50

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

Input Output Examples

Name	Type	Req	Description
external_customer_id	string	yes	Your external customer id.

No output schema declared.

No examples provided.

orb_get_customer_costs Get customer costs ~104

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

Input Output Examples

Name	Type	Req	Description
customer_id	string	yes	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.

No output schema declared.

No examples provided.

orb_get_customer_credits Get customer credit balances ~69

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

Input Output Examples

Name	Type	Req	Description
currency	string	—	Filter to a single currency.
customer_id	string	yes	Orb customer id.
include_all_blocks	boolean	—	Include expired/depleted blocks too.

No output schema declared.

No examples provided.

orb_get_customer_credits_ledger Get customer credit ledger ~120

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

Input Output Examples

Name	Type	Req	Description
currency	string	—	Filter to a single currency.
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
customer_id	string	yes	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).

No output schema declared.

No examples provided.

orb_get_invoice Get invoice ~38

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

Input Output Examples

Name	Type	Req	Description
invoice_id	string	yes	Orb invoice id.

No output schema declared.

No examples provided.

orb_get_item Get item ~37

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

Input Output Examples

Name	Type	Req	Description
item_id	string	yes	Orb item id.

No output schema declared.

No examples provided.

orb_get_plan Get plan ~37

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

Input Output Examples

Name	Type	Req	Description
plan_id	string	yes	Orb plan id.

No output schema declared.

No examples provided.

orb_get_price Get price ~37

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

Input Output Examples

Name	Type	Req	Description
price_id	string	yes	Orb price id.

No output schema declared.

No examples provided.

orb_get_subscription Get subscription ~37

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

Input Output Examples

Name	Type	Req	Description
subscription_id	string	yes	Orb subscription id.

No output schema declared.

No examples provided.

orb_get_subscription_costs Get subscription costs ~103

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

Input Output Examples

Name	Type	Req	Description
group_by	string	—	Price grouping key to break costs down by.
subscription_id	string	yes	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.

No output schema declared.

No examples provided.

orb_get_subscription_schedule Get subscription schedule ~78

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

Input Output Examples

Name	Type	Req	Description
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
limit	integer	—	Max items to return (1–100, default 20).
subscription_id	string	yes	Orb subscription id.

No output schema declared.

No examples provided.

orb_get_subscription_usage Get subscription usage ~107

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

Input Output Examples

Name	Type	Req	Description
granularity	string	—	Time granularity for buckets (e.g. day).
group_by	string	—	Property to group usage by.
subscription_id	string	yes	Orb subscription id.
timeframe_end	string	—	ISO-8601 datetime, exclusive end.
timeframe_start	string	—	ISO-8601 datetime, inclusive start.

No output schema declared.

No examples provided.

orb_get_upcoming_invoice Get upcoming invoice ~43

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

Input Output Examples

Name	Type	Req	Description
subscription_id	string	yes	Orb subscription id.

No output schema declared.

No examples provided.

orb_list_alerts List alerts ~108

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

orb_list_coupons List coupons ~74

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

orb_list_customers List customers ~60

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

Input Output Examples

Name	Type	Req	Description
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
limit	integer	—	Max items to return (1–100, default 20).

No output schema declared.

No examples provided.

orb_list_invoices List invoices ~170

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

orb_list_items List items ~61

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

Input Output Examples

Name	Type	Req	Description
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
limit	integer	—	Max items to return (1–100, default 20).

No output schema declared.

No examples provided.

orb_list_metrics List billable metrics ~62

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

Input Output Examples

Name	Type	Req	Description
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
limit	integer	—	Max items to return (1–100, default 20).

No output schema declared.

No examples provided.

orb_list_plans List plans ~72

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

orb_list_prices List prices ~60

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

Input Output Examples

Name	Type	Req	Description
cursor	string	—	Opaque pagination cursor (from pagination_metadata.next_cursor).
limit	integer	—	Max items to return (1–100, default 20).

No output schema declared.

No examples provided.

orb_list_subscriptions List subscriptions ~103

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

Input Output Examples

Name	Type	Req	Description
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.

No output schema declared.

No examples provided.

orb_ping Ping / auth check ~26

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

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

orb_update_customer Update customer ~156

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

Input Output Examples

Name	Type	Req	Description
currency	string	—	New ISO-4217 currency code.
customer_id	string	yes	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.

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	12
27 Jul	69
28 Jul	70
29 Jul	71
30 Jul	69
31 Jul	72
1 Aug	18
2 Aug	73
3 Aug	18