MCP 服务器

orb

io.usefulapi/orb
商业与运营 支付与金融科技 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Reads and manages Orb customers, subscriptions, invoices, plans, credits, usage, costs, and pricing data.

orb_create_customer
Create customer
Creates a new customer in Orb (additive). Requires name and a valid email. Orb API: POST /customers.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string', 'description': 'Customer display name (required).'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'description': 'Customer billing email (required, must be a valid email).'}, 'currency': {'type': 'string', 'description': 'ISO-4217 currency code for this customer.'}, 'metadata': {'type': 'object', 'description': 'User-defined key/value metadata (string→string).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'timezone': {'type': 'string', 'description': 'IANA timezone (e.g. America/New_York).'}, 'payment_provider': {'enum': ['quickbooks', 'bill.com', 'stripe_charge', 'stripe_invoice', 'netsuite', 'adyen'], 'type': 'string', 'description': 'External payment/invoicing provider.'}, 'payment_provider_id': {'type': 'string', 'description': 'Id of this customer in the external payment provider.'}, 'external_customer_id': {'type': 'string', 'description': 'Your external id for this customer.'}}}
orb_get_customer
Get customer
Fetch a single customer by Orb customer id. Orb API: GET /customers/{customer_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['customer_id'], 'properties': {'customer_id': {'type': 'string', 'description': 'Orb customer id.'}}}
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}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['external_customer_id'], 'properties': {'external_customer_id': {'type': 'string', 'description': 'Your external customer id.'}}}
orb_get_customer_costs
Get customer costs
Get costs incurred by a customer over a timeframe. Orb API: GET /customers/{customer_id}/costs.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['customer_id'], 'properties': {'group_by': {'type': 'string', 'description': 'Price grouping key to break costs down by.'}, 'view_mode': {'enum': ['periodic', 'cumulative'], 'type': 'string', 'description': 'periodic or cumulative.'}, 'customer_id': {'type': 'string', 'description': 'Orb customer id.'}, 'timeframe_end': {'type': 'string', 'description': 'ISO-8601 datetime, exclusive end.'}, 'timeframe_start': {'type': 'string', 'description': 'ISO-8601 datetime, inclusive start.'}}}
orb_get_customer_credits
Get customer credit balances
Get a customer's credit balances by currency. Orb API: GET /customers/{customer_id}/credits.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['customer_id'], 'properties': {'currency': {'type': 'string', 'description': 'Filter to a single currency.'}, 'customer_id': {'type': 'string', 'description': 'Orb customer id.'}, 'include_all_blocks': {'type': 'boolean', 'description': 'Include expired/depleted blocks too.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['customer_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'currency': {'type': 'string', 'description': 'Filter to a single currency.'}, 'entry_type': {'type': 'string', 'description': 'Filter to a ledger entry type (e.g. increment, decrement, expiration_change).'}, 'customer_id': {'type': 'string', 'description': 'Orb customer id.'}}}
orb_get_invoice
Get invoice
Fetch a single invoice by id. Orb API: GET /invoices/{invoice_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice_id'], 'properties': {'invoice_id': {'type': 'string', 'description': 'Orb invoice id.'}}}
orb_get_item
Get item
Fetch a single item by id. Orb API: GET /items/{item_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['item_id'], 'properties': {'item_id': {'type': 'string', 'description': 'Orb item id.'}}}
orb_get_plan
Get plan
Fetch a single plan by id. Orb API: GET /plans/{plan_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['plan_id'], 'properties': {'plan_id': {'type': 'string', 'description': 'Orb plan id.'}}}
orb_get_price
Get price
Fetch a single price by id. Orb API: GET /prices/{price_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['price_id'], 'properties': {'price_id': {'type': 'string', 'description': 'Orb price id.'}}}
orb_get_subscription
Get subscription
Fetch a single subscription by id. Orb API: GET /subscriptions/{subscription_id}.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription_id'], 'properties': {'subscription_id': {'type': 'string', 'description': 'Orb subscription id.'}}}
orb_get_subscription_costs
Get subscription costs
Get costs for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/costs.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription_id'], 'properties': {'group_by': {'type': 'string', 'description': 'Price grouping key to break costs down by.'}, 'view_mode': {'enum': ['periodic', 'cumulative'], 'type': 'string', 'description': 'periodic or cumulative.'}, 'timeframe_end': {'type': 'string', 'description': 'ISO-8601 datetime, exclusive end.'}, 'subscription_id': {'type': 'string', 'description': 'Orb subscription id.'}, 'timeframe_start': {'type': 'string', 'description': 'ISO-8601 datetime, inclusive start.'}}}
orb_get_subscription_schedule
Get subscription schedule
Get the plan-change schedule for a subscription. Orb API: GET /subscriptions/{subscription_id}/schedule.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription_id'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'subscription_id': {'type': 'string', 'description': 'Orb subscription id.'}}}
orb_get_subscription_usage
Get subscription usage
Get metered usage for a subscription over a timeframe. Orb API: GET /subscriptions/{subscription_id}/usage.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription_id'], 'properties': {'group_by': {'type': 'string', 'description': 'Property to group usage by.'}, 'granularity': {'type': 'string', 'description': 'Time granularity for buckets (e.g. day).'}, 'timeframe_end': {'type': 'string', 'description': 'ISO-8601 datetime, exclusive end.'}, 'subscription_id': {'type': 'string', 'description': 'Orb subscription id.'}, 'timeframe_start': {'type': 'string', 'description': 'ISO-8601 datetime, inclusive start.'}}}
orb_get_upcoming_invoice
Get upcoming invoice
Preview the upcoming (draft) invoice for a subscription. Orb API: GET /invoices/upcoming.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['subscription_id'], 'properties': {'subscription_id': {'type': 'string', 'description': 'Orb subscription id.'}}}
orb_list_alerts
List alerts
List usage/spend alerts, optionally filtered by customer or subscription. Orb API: GET /alerts.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'customer_id': {'type': 'string', 'description': 'Filter to an Orb customer id.'}, 'subscription_id': {'type': 'string', 'description': 'Filter to a subscription id.'}, 'external_customer_id': {'type': 'string', 'description': 'Filter to your external customer id.'}}}
orb_list_coupons
List coupons
List coupons in the Orb account. Orb API: GET /coupons.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'show_archived': {'type': 'boolean', 'description': 'Include archived coupons.'}}}
orb_list_customers
List customers
List customers in the Orb account. Orb API: GET /customers.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}}}
orb_list_invoices
List invoices
List invoices, optionally filtered by customer, subscription, or status. Orb API: GET /invoices.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'status': {'type': 'string', 'description': 'Filter by invoice status (e.g. draft, issued, paid, void).'}, 'due_date': {'type': 'string', 'description': 'ISO-8601 date filter.'}, 'date_type': {'type': 'string', 'description': 'Which date `due_date` filters on (e.g. due_date, invoice_date).'}, 'customer_id': {'type': 'string', 'description': 'Filter to an Orb customer id.'}, 'subscription_id': {'type': 'string', 'description': 'Filter to a subscription id.'}, 'external_customer_id': {'type': 'string', 'description': 'Filter to your external customer id.'}}}
orb_list_items
List items
List items (the things you bill for). Orb API: GET /items.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}}}
orb_list_metrics
List billable metrics
List billable metrics configured in the Orb account. Orb API: GET /metrics.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}}}
orb_list_plans
List plans
List plans configured in the Orb account. Orb API: GET /plans.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'status': {'enum': ['active', 'archived', 'draft'], 'type': 'string', 'description': 'Filter by plan status.'}}}
orb_list_prices
List prices
List prices configured in the Orb account. Orb API: GET /prices.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}}}
orb_list_subscriptions
List subscriptions
List subscriptions, optionally filtered by customer or status. Orb API: GET /subscriptions.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (1–100, default 20).'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor (from pagination_metadata.next_cursor).'}, 'status': {'enum': ['active', 'ended', 'upcoming'], 'type': 'string', 'description': 'Filter by subscription status.'}, 'customer_id': {'type': 'string', 'description': 'Filter to an Orb customer id.'}, 'external_customer_id': {'type': 'string', 'description': 'Filter to your external customer id.'}}}
orb_ping
Ping / auth check
Health and auth check — verifies the API key works. Orb API: GET /ping.
只读
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
orb_update_customer
Update customer
Updates an existing customer's details (reversible). Only provided fields are changed. Orb API: PUT /customers/{customer_id}.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['customer_id'], 'properties': {'name': {'type': 'string', 'description': 'New display name.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'description': 'New billing email (must be a valid email).'}, 'currency': {'type': 'string', 'description': 'New ISO-4217 currency code.'}, 'metadata': {'type': 'object', 'description': 'User-defined key/value metadata (string→string).', 'propertyNames': {'type': 'string'}, 'additionalProperties': {'type': 'string'}}, 'timezone': {'type': 'string', 'description': 'New IANA timezone.'}, 'customer_id': {'type': 'string', 'description': 'Orb customer id (required).'}, 'payment_provider': {'enum': ['quickbooks', 'bill.com', 'stripe_charge', 'stripe_invoice', 'netsuite', 'adyen'], 'type': 'string', 'description': 'External payment/invoicing provider.'}, 'payment_provider_id': {'type': 'string', 'description': 'New id in the external payment provider.'}, 'external_customer_id': {'type': 'string', 'description': 'New external id.'}}}
已添加
orb_update_customer
2026年9月25日 02:44
已添加
orb_create_customer
2026年9月25日 02:44
已添加
orb_list_alerts
2026年9月25日 02:44
已添加
orb_list_coupons
2026年9月25日 02:44
已添加
orb_list_metrics
2026年9月25日 02:44
已添加
orb_get_price
2026年9月25日 02:44
已添加
orb_list_prices
2026年9月25日 02:44
已添加
orb_get_item
2026年9月25日 02:44
已添加
orb_list_items
2026年9月25日 02:44
已添加
orb_get_upcoming_invoice
2026年9月25日 02:44
已添加
orb_get_invoice
2026年9月25日 02:44
已添加
orb_list_invoices
2026年9月25日 02:44
已添加
orb_get_subscription_schedule
2026年9月25日 02:44
已添加
orb_get_subscription_usage
2026年9月25日 02:44
已添加
orb_get_subscription_costs
2026年9月25日 02:44
已添加
orb_get_subscription
2026年9月25日 02:44
已添加
orb_list_subscriptions
2026年9月25日 02:44
已添加
orb_get_plan
2026年9月25日 02:44
已添加
orb_list_plans
2026年9月25日 02:44
已添加
orb_get_customer_credits_ledger
2026年9月25日 02:44
已添加
orb_get_customer_credits
2026年9月25日 02:44
已添加
orb_get_customer_costs
2026年9月25日 02:44
已添加
orb_get_customer_by_external_id
2026年9月25日 02:44
已添加
orb_get_customer
2026年9月25日 02:44
已添加
orb_list_customers
2026年9月25日 02:44
已添加
orb_ping
2026年9月25日 02:44