Orb MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Read Orb customers, subscriptions, invoices, usage and costs; create or update customers.
26 tools: 2 can delete or cancel things and 24 only read.
Scanned Oct 21, 2026
- Deletes or cancels2Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads24Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http orb https://orb.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
26 tools
Deletes or cancels 2Claude Code: deny
orb_create_customerCreates a new customer in Orb (additive).No findings
Why it is in this group
- The name "orb_create_customer" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers.
Annotations the server declares
- title: Create customer
- destructiveHint: true
orb_update_customerUpdates an existing customer's details (reversible).No findings
Why it is in this group
- The name "orb_update_customer" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}.
Annotations the server declares
- title: Update customer
- destructiveHint: true
Only reads 24Claude Code: allow
orb_get_customerFetch a single customer by Orb customer id.No findings
Why it is in this group
- The name "orb_get_customer" says "get": a word for reading.
Description, as the server wrote it Fetch a single customer by Orb customer id. Orb API: GET /customers/{customer_id}.
Annotations the server declares
- title: Get customer
- readOnlyHint: true
orb_get_customer_by_external_idFetch a single customer by your external customer id.No findings
Why it is in this group
- The name "orb_get_customer_by_external_id" says "get": a word for reading.
Description, as the server wrote it Fetch a single customer by your external customer id. Orb API: GET /customers/external_customer_id/{external_customer_id}.
Annotations the server declares
- title: Get customer by external id
- readOnlyHint: true
orb_get_customer_costsGet costs incurred by a customer over a timeframe.No findings
Why it is in this group
- The name "orb_get_customer_costs" says "get": a word for reading.
Description, as the server wrote it Get costs incurred by a customer over a timeframe. Orb API: GET /customers/{customer_id}/costs.
Annotations the server declares
- title: Get customer costs
- readOnlyHint: true
orb_get_customer_creditsGet a customer's credit balances by currency.No findings
Why it is in this group
- The name "orb_get_customer_credits" says "get": a word for reading.
Description, as the server wrote it Get a customer's credit balances by currency. Orb API: GET /customers/{customer_id}/credits.
Annotations the server declares
- title: Get customer credit balances
- readOnlyHint: true
orb_get_customer_credits_ledgerGet the append-only credit ledger for a customer.No findings
Why it is in this group
- The name "orb_get_customer_credits_ledger" says "get": a word for reading.
Description, as the server wrote it Get the append-only credit ledger for a customer. Orb API: GET /customers/{customer_id}/credits/ledger.
Annotations the server declares
- title: Get customer credit ledger
- readOnlyHint: true
orb_get_invoiceFetch a single invoice by id.No findings
Why it is in this group
- The name "orb_get_invoice" says "get": a word for reading.
Description, as the server wrote it Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}.
Annotations the server declares
- title: Get invoice
- readOnlyHint: true
orb_get_itemFetch a single item by id.No findings
Why it is in this group
- The name "orb_get_item" says "get": a word for reading.
Description, as the server wrote it Fetch a single item by id. Orb API: GET /items/{item_id}.
Annotations the server declares
- title: Get item
- readOnlyHint: true
orb_get_planFetch a single plan by id.No findings
Why it is in this group
- The name "orb_get_plan" says "get": a word for reading.
Description, as the server wrote it Fetch a single plan by id. Orb API: GET /plans/{plan_id}.
Annotations the server declares
- title: Get plan
- readOnlyHint: true
orb_get_priceFetch a single price by id.No findings
Why it is in this group
- The name "orb_get_price" says "get": a word for reading.
Description, as the server wrote it Fetch a single price by id. Orb API: GET /prices/{price_id}.
Annotations the server declares
- title: Get price
- readOnlyHint: true
orb_get_subscriptionFetch a single subscription by id.No findings
Why it is in this group
- The name "orb_get_subscription" says "get": a word for reading.
Description, as the server wrote it Fetch a single subscription by id. Orb API: GET /subscriptions/{subscription_id}.
Annotations the server declares
- title: Get subscription
- readOnlyHint: true
orb_get_subscription_costsGet costs for a subscription over a timeframe.No findings
Why it is in this group
- The name "orb_get_subscription_costs" says "get": a word for reading.
Description, as the server wrote it Get costs for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/costs.
Annotations the server declares
- title: Get subscription costs
- readOnlyHint: true
orb_get_subscription_scheduleGet the plan-change schedule for a subscription.No findings
Why it is in this group
- The name "orb_get_subscription_schedule" says "get": a word for reading.
Description, as the server wrote it Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule.
Annotations the server declares
- title: Get subscription schedule
- readOnlyHint: true
orb_get_subscription_usageGet metered usage for a subscription over a timeframe.No findings
Why it is in this group
- The name "orb_get_subscription_usage" says "get": a word for reading.
Description, as the server wrote it Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage.
Annotations the server declares
- title: Get subscription usage
- readOnlyHint: true
orb_get_upcoming_invoicePreview the upcoming (draft) invoice for a subscription.No findings
Why it is in this group
- The name "orb_get_upcoming_invoice" says "get": a word for reading.
Description, as the server wrote it Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming.
Annotations the server declares
- title: Get upcoming invoice
- readOnlyHint: true
orb_list_alertsList usage/spend alerts, optionally filtered by customer or subscription.No findings
Why it is in this group
- The name "orb_list_alerts" says "list": a word for reading.
Description, as the server wrote it List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts.
Annotations the server declares
- title: List alerts
- readOnlyHint: true
orb_list_couponsList coupons in the Orb account.No findings
Why it is in this group
- The name "orb_list_coupons" says "list": a word for reading.
Description, as the server wrote it List coupons in the Orb account. Orb API: GET /coupons.
Annotations the server declares
- title: List coupons
- readOnlyHint: true
orb_list_customersList customers in the Orb account.No findings
Why it is in this group
- The name "orb_list_customers" says "list": a word for reading.
Description, as the server wrote it List customers in the Orb account. Orb API: GET /customers.
Annotations the server declares
- title: List customers
- readOnlyHint: true
orb_list_invoicesList invoices, optionally filtered by customer, subscription, or status.No findings
Why it is in this group
- The name "orb_list_invoices" says "list": a word for reading.
Description, as the server wrote it List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices.
Annotations the server declares
- title: List invoices
- readOnlyHint: true
orb_list_itemsList items (the things you bill for).No findings
Why it is in this group
- The name "orb_list_items" says "list": a word for reading.
Description, as the server wrote it List items (the things you bill for). Orb API: GET /items.
Annotations the server declares
- title: List items
- readOnlyHint: true
orb_list_metricsList billable metrics configured in the Orb account.No findings
Why it is in this group
- The name "orb_list_metrics" says "list": a word for reading.
Description, as the server wrote it List billable metrics configured in the Orb account. Orb API: GET /metrics.
Annotations the server declares
- title: List billable metrics
- readOnlyHint: true
orb_list_plansList plans configured in the Orb account.No findings
Why it is in this group
- The name "orb_list_plans" says "list": a word for reading.
Description, as the server wrote it List plans configured in the Orb account. Orb API: GET /plans.
Annotations the server declares
- title: List plans
- readOnlyHint: true
orb_list_pricesList prices configured in the Orb account.No findings
Why it is in this group
- The name "orb_list_prices" says "list": a word for reading.
Description, as the server wrote it List prices configured in the Orb account. Orb API: GET /prices.
Annotations the server declares
- title: List prices
- readOnlyHint: true
orb_list_subscriptionsList subscriptions, optionally filtered by customer or status.No findings
Why it is in this group
- The name "orb_list_subscriptions" says "list": a word for reading.
Description, as the server wrote it List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions.
Annotations the server declares
- title: List subscriptions
- readOnlyHint: true
orb_pingHealth and auth check — verifies the API key works.No findings
Why it is in this group
- The name "orb_ping" says "ping": a word for reading.
Description, as the server wrote it Health and auth check — verifies the API key works. Orb API: GET /ping.
Annotations the server declares
- title: Ping / auth check
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http orb https://orb.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__orb__orb_ping",
"mcp__orb__orb_list_customers",
"mcp__orb__orb_get_customer",
"mcp__orb__orb_get_customer_by_external_id",
"mcp__orb__orb_get_customer_costs",
"mcp__orb__orb_get_customer_credits",
"mcp__orb__orb_get_customer_credits_ledger",
"mcp__orb__orb_list_plans",
"mcp__orb__orb_get_plan",
"mcp__orb__orb_list_subscriptions",
"mcp__orb__orb_get_subscription",
"mcp__orb__orb_get_subscription_costs",
"mcp__orb__orb_get_subscription_usage",
"mcp__orb__orb_get_subscription_schedule",
"mcp__orb__orb_list_invoices",
"mcp__orb__orb_get_invoice",
"mcp__orb__orb_get_upcoming_invoice",
"mcp__orb__orb_list_items",
"mcp__orb__orb_get_item",
"mcp__orb__orb_list_prices",
"mcp__orb__orb_get_price",
"mcp__orb__orb_list_metrics",
"mcp__orb__orb_list_coupons",
"mcp__orb__orb_list_alerts"
],
"ask": [],
"deny": [
"mcp__orb__orb_create_customer",
"mcp__orb__orb_update_customer"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as orb. Review it before you use it.