Orb MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.36.5Updated Nov 8, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted MCP server that lets an assistant read Orb billing data — customers, subscriptions, invoices, usage and costs — and create or update customers.

What you can do
  • Check API key health and see the monthly tool-call meter
  • List and fetch customers, including lookup by external id, plus costs, credit balances and the credit ledger
  • List and fetch plans, subscriptions, subscription costs, metered usage and plan-change schedules
  • List and fetch invoices, preview the upcoming draft invoice, and list items, prices, metrics, coupons and alerts
  • Create a new customer or update an existing customer's details
  • Manage the server's own plan: request a feature, upgrade, or cancel the subscription
When to use it
Useful when you want to ask questions about Orb usage-based billing in plain language — for example reviewing a subscription's usage over a period, finding unpaid invoices and their customers, or previewing the next invoice — without opening the Orb dashboard.
Requirements
Remote streamable HTTP endpoint; no local install. Connect with the URL only and sign in through OAuth, pasting your Orb API key on the first connect; the key is validated and stored per user. A free tier allows 50 tool calls per month.
Before you install
The server asks for your Orb API key during OAuth login; do not put it in the client config as a header. Two tools write to Orb: creating a customer and updating customer details. Paid plans cost money ($9/month Pro, $39/month Pro+ per the instructions) and upgrades return Stripe Checkout links; cancellation has no refund for the current period. Your Orb billing data passes through a third-party host.

Installation

In SourceWeft

  1. Open Orb MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Forb/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Orb MCP by usefulapi

Query and manage your Orb usage-based billing from Claude, Cursor, or any MCP client. Hosted, no local install — connect with your Orb API key.

Live endpoint: https://orb.usefulapi.io/mcp · Homepage: https://usefulapi.io/orb

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://orb.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http orb https://orb.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "orb": {      "url": "https://orb.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Orb credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/orb/

On first connect you'll paste your Orb API key. It's validated, stored per-user, and scoped to you.

Tools

ToolTypeWhat it does
orb_pingreadPing / auth check
orb_list_customersreadList customers
orb_get_customerreadGet customer
orb_get_customer_by_external_idreadGet customer by external id
orb_get_customer_costsreadGet customer costs
orb_get_customer_creditsreadGet customer credit balances
orb_get_customer_credits_ledgerreadGet customer credit ledger
orb_list_plansreadList plans
orb_get_planreadGet plan
orb_list_subscriptionsreadList subscriptions
orb_get_subscriptionreadGet subscription
orb_get_subscription_costsreadGet subscription costs
orb_get_subscription_usagereadGet subscription usage
orb_get_subscription_schedulereadGet subscription schedule
orb_list_invoicesreadList invoices
orb_get_invoicereadGet invoice
orb_get_upcoming_invoicereadGet upcoming invoice
orb_list_itemsreadList items
orb_get_itemreadGet item
orb_list_pricesreadList prices
orb_get_pricereadGet price
orb_list_metricsreadList billable metrics
orb_list_couponsreadList coupons
orb_list_alertsreadList alerts
orb_create_customerwriteCreate customer
orb_update_customerwriteUpdate customer
orb_usage_statusmetaUsage status (free-tier meter)
orb_request_featuremetaRequest a missing feature
orb_upgrademetaUpgrade to Pro or Pro+
orb_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with orb_upgrade (it returns a Stripe Checkout link). Cancel any time with orb_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running orb_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/orb/README.md at commit 4046075

Tools

26

orb_ping

Ping / auth check

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

Takes no parameters.

orb_list_customers

List customers

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

Parameterslimitcursor

orb_get_customer

Get customer

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

Parameterscustomer_idrequired

orb_get_customer_by_external_id

Get customer by external id

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

Parametersexternal_customer_idrequired

orb_get_customer_costs

Get customer costs

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

Parametersgroup_byview_modecustomer_idrequiredtimeframe_endtimeframe_start

orb_get_customer_credits

Get customer credit balances

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

Parameterscurrencycustomer_idrequiredinclude_all_blocks

orb_get_customer_credits_ledger

Get customer credit ledger

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

Parameterslimitcursorcurrencyentry_typecustomer_idrequired

orb_list_plans

List plans

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

Parameterslimitcursorstatus

orb_get_plan

Get plan

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

Parametersplan_idrequired

orb_list_subscriptions

List subscriptions

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

Parameterslimitcursorstatuscustomer_idexternal_customer_id

orb_get_subscription

Get subscription

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

Parameterssubscription_idrequired

orb_get_subscription_costs

Get subscription costs

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

Parametersgroup_byview_modetimeframe_endsubscription_idrequiredtimeframe_start

orb_get_subscription_usage

Get subscription usage

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

Parametersgroup_bygranularitytimeframe_endsubscription_idrequiredtimeframe_start

orb_get_subscription_schedule

Get subscription schedule

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

Parameterslimitcursorsubscription_idrequired

orb_list_invoices

List invoices

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

Parameterslimitcursorstatusdue_datedate_typecustomer_idsubscription_idexternal_customer_id

orb_get_invoice

Get invoice

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

Parametersinvoice_idrequired

orb_get_upcoming_invoice

Get upcoming invoice

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

Parameterssubscription_idrequired

orb_list_items

List items

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

Parameterslimitcursor

orb_get_item

Get item

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

Parametersitem_idrequired

orb_list_prices

List prices

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

Parameterslimitcursor

orb_get_price

Get price

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

Parametersprice_idrequired

orb_list_metrics

List billable metrics

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

Parameterslimitcursor

orb_list_coupons

List coupons

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

Parameterslimitcursorshow_archived

orb_list_alerts

List alerts

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

Parameterslimitcursorcustomer_idsubscription_idexternal_customer_id

orb_create_customer

Create customer

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

Parametersnamerequiredemailrequiredcurrencymetadatatimezonepayment_providerpayment_provider_idexternal_customer_id

orb_update_customer

Update customer

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

Parametersnameemailcurrencymetadatatimezonecustomer_idrequiredpayment_providerpayment_provider_idexternal_customer_id

Version history

22
  1. v1.36.5LatestNov 8, 2026
  2. v1.36.4Nov 7, 2026
  3. v1.35.3Nov 5, 2026
  4. v1.35.2Nov 5, 2026
  5. v1.35.1Nov 4, 2026
  6. v1.35.0Nov 3, 2026
  7. v1.34.1Nov 3, 2026
  8. v1.33.0Nov 1, 2026
  9. v1.31.0Oct 31, 2026
  10. v1.30.0Oct 31, 2026
  11. v1.29.2Oct 30, 2026
  12. v1.29.0Oct 30, 2026
  13. v1.24.0Oct 26, 2026
  14. v1.21.3Oct 25, 2026
  15. v1.21.0Oct 25, 2026
  16. v1.20.0Oct 24, 2026
  17. v1.17.0Oct 23, 2026
  18. v1.16.4Oct 22, 2026
  19. v1.16.3Oct 21, 2026
  20. v1.11.1Oct 9, 2026
  21. v1.10.0Oct 9, 2026
  22. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 8, 2026

Tiltify MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant read Tiltify campaigns, donations and top donor and fundraiser leaderboards.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

Termii MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Termii server that lets an assistant send SMS, check wallet balance, DND status, sender IDs and message history.

Streamable HTTPWeb executable
Communication & Collaboration5 toolsNov 8, 2026

Temp Stick MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server that lets an assistant read Temp Stick temperature and humidity sensors, their readings and alert notifications.

Streamable HTTPWeb executable
Location & Lifestyle4 toolsNov 8, 2026

Stibee MCP by usefulapi

io.usefulapiOfficial publisher

Connects an assistant to a Stibee email marketing workspace to read address books, subscribers and email stats, and to add subscribers and group members.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 8, 2026