Orb MCP by usefulapi

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

사용해야 할까요

품질 및 안전성

A
설명 품질
100%
스키마 완전성
94%
이름 품질
78%
오염 위험
100%
권한 일치
100%
프로토콜 준수
100%

발견 사항 (2)

  • LOWTool 'orb_get_customer_by_external_id' name length outside 3-30 rangeorb_get_customer_by_external_id에서
  • LOWTool 'orb_get_customer_credits_ledger' name length outside 3-30 rangeorb_get_customer_credits_ledger에서

도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.

컨텍스트 비용

~3,826토큰 (도구 정의)
~1.2 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.99%)

이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.

설치

원클릭 설치

`claude_desktop_config.json` 파일에 다음을 추가하세요:

{
  "mcpServers": {
    "orb": {
      "url": "https://orb.usefulapi.io/mcp"
    }
  }
}

원격 엔드포인트

https://orb.usefulapi.io/mcpstreamable-http

할 수 있는 일

도구 목록

도구 (26)

🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢orb_ping

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

입력 스키마

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_customers(limit, cursor)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_customer(customer_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Orb customer id."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_customer_by_external_id(external_customer_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "external_customer_id": {
      "type": "string",
      "description": "Your external customer id."
    }
  },
  "required": [
    "external_customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_customer_costs(customer_id, timeframe_start, timeframe_end, view_mode, group_by)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Orb customer id."
    },
    "timeframe_start": {
      "description": "ISO-8601 datetime, inclusive start.",
      "type": "string"
    },
    "timeframe_end": {
      "description": "ISO-8601 datetime, exclusive end.",
      "type": "string"
    },
    "view_mode": {
      "description": "periodic or cumulative.",
      "type": "string",
      "enum": [
        "periodic",
        "cumulative"
      ]
    },
    "group_by": {
      "description": "Price grouping key to break costs down by.",
      "type": "string"
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_customer_credits(customer_id, currency, include_all_blocks)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Orb customer id."
    },
    "currency": {
      "description": "Filter to a single currency.",
      "type": "string"
    },
    "include_all_blocks": {
      "description": "Include expired/depleted blocks too.",
      "type": "boolean"
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_customer_credits_ledger(customer_id, limit, cursor, entry_type, currency)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Orb customer id."
    },
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "entry_type": {
      "description": "Filter to a ledger entry type (e.g. increment, decrement, expiration_change).",
      "type": "string"
    },
    "currency": {
      "description": "Filter to a single currency.",
      "type": "string"
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_plans(limit, cursor, status)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "status": {
      "description": "Filter by plan status.",
      "type": "string",
      "enum": [
        "active",
        "archived",
        "draft"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_plan(plan_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "description": "Orb plan id."
    }
  },
  "required": [
    "plan_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_subscriptions(limit, cursor, customer_id, external_customer_id, status)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "customer_id": {
      "description": "Filter to an Orb customer id.",
      "type": "string"
    },
    "external_customer_id": {
      "description": "Filter to your external customer id.",
      "type": "string"
    },
    "status": {
      "description": "Filter by subscription status.",
      "type": "string",
      "enum": [
        "active",
        "ended",
        "upcoming"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_subscription(subscription_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Orb subscription id."
    }
  },
  "required": [
    "subscription_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_subscription_costs(subscription_id, timeframe_start, timeframe_end, view_mode, group_by)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Orb subscription id."
    },
    "timeframe_start": {
      "description": "ISO-8601 datetime, inclusive start.",
      "type": "string"
    },
    "timeframe_end": {
      "description": "ISO-8601 datetime, exclusive end.",
      "type": "string"
    },
    "view_mode": {
      "description": "periodic or cumulative.",
      "type": "string",
      "enum": [
        "periodic",
        "cumulative"
      ]
    },
    "group_by": {
      "description": "Price grouping key to break costs down by.",
      "type": "string"
    }
  },
  "required": [
    "subscription_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_subscription_usage(subscription_id, timeframe_start, timeframe_end, granularity, group_by)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Orb subscription id."
    },
    "timeframe_start": {
      "description": "ISO-8601 datetime, inclusive start.",
      "type": "string"
    },
    "timeframe_end": {
      "description": "ISO-8601 datetime, exclusive end.",
      "type": "string"
    },
    "granularity": {
      "description": "Time granularity for buckets (e.g. day).",
      "type": "string"
    },
    "group_by": {
      "description": "Property to group usage by.",
      "type": "string"
    }
  },
  "required": [
    "subscription_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_subscription_schedule(subscription_id, limit, cursor)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Orb subscription id."
    },
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    }
  },
  "required": [
    "subscription_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_invoices(limit, cursor, customer_id, external_customer_id, subscription_id, ...)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "customer_id": {
      "description": "Filter to an Orb customer id.",
      "type": "string"
    },
    "external_customer_id": {
      "description": "Filter to your external customer id.",
      "type": "string"
    },
    "subscription_id": {
      "description": "Filter to a subscription id.",
      "type": "string"
    },
    "status": {
      "description": "Filter by invoice status (e.g. draft, issued, paid, void).",
      "type": "string"
    },
    "date_type": {
      "description": "Which date `due_date` filters on (e.g. due_date, invoice_date).",
      "type": "string"
    },
    "due_date": {
      "description": "ISO-8601 date filter.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_invoice(invoice_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "invoice_id": {
      "type": "string",
      "description": "Orb invoice id."
    }
  },
  "required": [
    "invoice_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_upcoming_invoice(subscription_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "subscription_id": {
      "type": "string",
      "description": "Orb subscription id."
    }
  },
  "required": [
    "subscription_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_items(limit, cursor)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_item(item_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "description": "Orb item id."
    }
  },
  "required": [
    "item_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_prices(limit, cursor)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_get_price(price_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "price_id": {
      "type": "string",
      "description": "Orb price id."
    }
  },
  "required": [
    "price_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_metrics(limit, cursor)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_coupons(limit, cursor, show_archived)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "show_archived": {
      "description": "Include archived coupons.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢orb_list_alerts(limit, cursor, customer_id, external_customer_id, subscription_id)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max items to return (1–100, default 20).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor (from pagination_metadata.next_cursor).",
      "type": "string"
    },
    "customer_id": {
      "description": "Filter to an Orb customer id.",
      "type": "string"
    },
    "external_customer_id": {
      "description": "Filter to your external customer id.",
      "type": "string"
    },
    "subscription_id": {
      "description": "Filter to a subscription id.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴orb_create_customer(name, email, external_customer_id, currency, timezone, ...)

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

입력 스키마

{
  "type": "object",
  "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-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Customer billing email (required, must be a valid email)."
    },
    "external_customer_id": {
      "description": "Your external id for this customer.",
      "type": "string"
    },
    "currency": {
      "description": "ISO-4217 currency code for this customer.",
      "type": "string"
    },
    "timezone": {
      "description": "IANA timezone (e.g. America/New_York).",
      "type": "string"
    },
    "metadata": {
      "description": "User-defined key/value metadata (string→string).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "payment_provider": {
      "description": "External payment/invoicing provider.",
      "type": "string",
      "enum": [
        "quickbooks",
        "bill.com",
        "stripe_charge",
        "stripe_invoice",
        "netsuite",
        "adyen"
      ]
    },
    "payment_provider_id": {
      "description": "Id of this customer in the external payment provider.",
      "type": "string"
    }
  },
  "required": [
    "name",
    "email"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴orb_update_customer(customer_id, name, email, external_customer_id, metadata, ...)

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

입력 스키마

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "description": "Orb customer id (required)."
    },
    "name": {
      "description": "New display name.",
      "type": "string"
    },
    "email": {
      "description": "New billing email (must be a valid email).",
      "type": "string",
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "external_customer_id": {
      "description": "New external id.",
      "type": "string"
    },
    "metadata": {
      "description": "User-defined key/value metadata (string→string).",
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": "string"
      }
    },
    "currency": {
      "description": "New ISO-4217 currency code.",
      "type": "string"
    },
    "timezone": {
      "description": "New IANA timezone.",
      "type": "string"
    },
    "payment_provider": {
      "description": "External payment/invoicing provider.",
      "type": "string",
      "enum": [
        "quickbooks",
        "bill.com",
        "stripe_charge",
        "stripe_invoice",
        "netsuite",
        "adyen"
      ]
    },
    "payment_provider_id": {
      "description": "New id in the external payment provider.",
      "type": "string"
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

커뮤니티

이 서버 평가하기

증거

최근 관측

검증됨버전이 기록되지 않음도구 26개
검증됨버전이 기록되지 않음도구 26개
검증됨버전이 기록되지 않음도구 26개
검증됨버전이 기록되지 않음도구 26개
관측 실패버전이 기록되지 않음—
관측 실패버전이 기록되지 않음—