# orb MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-orb
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://orb.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://orb.usefulapi.io/mcp

## Tools
- orb_ping (Ping / auth check) - Health and auth check — verifies the API key works. Orb API: GET /ping. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_customers (List customers) - List customers in the Orb account. Orb API: GET /customers. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_customer (Get customer) - Fetch a single customer by Orb customer id. Orb API: GET /customers/{customer_id}. Endpoint: https://orb.usefulapi.io/mcp
- 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}. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_customer_costs (Get customer costs) - Get costs incurred by a customer over a timeframe. Orb API: GET /customers/{customer_id}/costs. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_customer_credits (Get customer credit balances) - Get a customer's credit balances by currency. Orb API: GET /customers/{customer_id}/credits. Endpoint: https://orb.usefulapi.io/mcp
- 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. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_plans (List plans) - List plans configured in the Orb account. Orb API: GET /plans. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_plan (Get plan) - Fetch a single plan by id. Orb API: GET /plans/{plan_id}. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_subscriptions (List subscriptions) - List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_subscription (Get subscription) - Fetch a single subscription by id. Orb API: GET /subscriptions/{subscription_id}. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_subscription_costs (Get subscription costs) - Get costs for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/costs. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_subscription_usage (Get subscription usage) - Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_subscription_schedule (Get subscription schedule) - Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_invoices (List invoices) - List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_invoice (Get invoice) - Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_upcoming_invoice (Get upcoming invoice) - Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_items (List items) - List items (the things you bill for). Orb API: GET /items. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_item (Get item) - Fetch a single item by id. Orb API: GET /items/{item_id}. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_prices (List prices) - List prices configured in the Orb account. Orb API: GET /prices. Endpoint: https://orb.usefulapi.io/mcp
- orb_get_price (Get price) - Fetch a single price by id. Orb API: GET /prices/{price_id}. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_metrics (List billable metrics) - List billable metrics configured in the Orb account. Orb API: GET /metrics. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_coupons (List coupons) - List coupons in the Orb account. Orb API: GET /coupons. Endpoint: https://orb.usefulapi.io/mcp
- orb_list_alerts (List alerts) - List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts. Endpoint: https://orb.usefulapi.io/mcp
- orb_create_customer (Create customer) - Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers. Endpoint: https://orb.usefulapi.io/mcp
- orb_update_customer (Update customer) - Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}. Endpoint: https://orb.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 17, 2026
- Source: https://registry.modelcontextprotocol.io