Package Exports

@openaisdk/billing-mcp
@openaisdk/billing-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@openaisdk/billing-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

@openaisdk/billing-mcp

MCP-сервер для управления каталогом в Billing API: проекты, планы, цены (REST v1/projects/.../plans, .../prices).

Переменные окружения

Переменная	Обязательно	Описание
`BILLING_API_KEY`	да	Project-scoped integration key (получить через Admin UI → Integration)
`BILLING_PROJECT_ID`	да	UUID проекта (Admin UI → Settings или `pnpm db:seed` output)
`BILLING_API_BASE_URL`	нет	По умолчанию `http://127.0.0.1:4001`

Ключ передаётся как Authorization: Bearer <key>. BILLING_TENANT_ID / DEV_TENANT_ID больше не нужны.

Cursor

В .cursor/mcp.json добавьте сервер (после pnpm install и pnpm --filter @openaisdk/billing-mcp run build):

{
  "mcpServers": {
    "billing-catalog": {
      "command": "node",
      "args": ["packages/billing-catalog-mcp/dist/index.js"],
      "cwd": "${workspaceFolder}",
      "env": {
        "BILLING_API_BASE_URL": "http://127.0.0.1:4001",
        "BILLING_API_KEY": "<project-scoped integration key>",
        "BILLING_PROJECT_ID": "<project-uuid>"
      }
    }
  }
}

Для разработки без сборки можно tsx:

"command": "pnpm",
"args": ["exec", "tsx", "packages/billing-catalog-mcp/index.ts"],
"cwd": "${workspaceFolder}"

Инструменты (tools)

billing_list_projects — проекты тенанта
billing_list_plans / billing_get_plan / billing_create_plan / billing_update_plan
billing_list_prices / billing_get_price / billing_create_price / billing_update_price

billing_create_price: укажите planId или planCode (например team), плюс code, amountMinor (копейки), interval (month | year).

Сборка

pnpm --filter @openaisdk/billing-mcp run build

Локальный запуск (проверка)

BILLING_API_KEY=<key> BILLING_PROJECT_ID=<uuid> pnpm --filter @openaisdk/billing-mcp run dev

Stdio ждёт MCP-клиент; для ручной проверки используйте Cursor или тестовый MCP-клиент.