Skip to content

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.

Deletes · 2

26 tools: 2 can delete or cancel things and 24 only read.

Scanned Oct 21, 2026

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/mcp

Tools

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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

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