@openaisdk/billing-mcp 0.2.1

package/README.md

@@ -0,0 +1,64 @@
+# @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`):
+
+```json
+{
+  "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`:
+
+```json
+"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`).
+
+## Сборка
+
+```bash
+pnpm --filter @openaisdk/billing-mcp run build
+```
+
+## Локальный запуск (проверка)
+
+```bash
+BILLING_API_KEY=<key> BILLING_PROJECT_ID=<uuid> pnpm --filter @openaisdk/billing-mcp run dev
+```
+
+Stdio ждёт MCP-клиент; для ручной проверки используйте Cursor или тестовый MCP-клиент.

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+/**
+ * MCP server: Billing Catalog — планы и цены (REST Billing API).
+ */
+import 'dotenv/config';

package/dist/index.js

@@ -0,0 +1,418 @@
+#!/usr/bin/env node
+/**
+ * MCP server: Billing Catalog — планы и цены (REST Billing API).
+ */
+import 'dotenv/config';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { seedMegaretroCatalog as runMegaretroCatalogSeed, upsertMegaretroFeaturesAndLimits, } from './megaretro-catalog-seed.js';
+function getBaseUrl() {
+    return (process.env.BILLING_API_BASE_URL ?? 'http://127.0.0.1:4001').replace(/\/$/, '');
+}
+function buildHeaders(extra) {
+    const h = { ...extra };
+    // Auth: project-scoped integration key (ADR-010).
+    // Tenant и project резолвятся из ключа на стороне API — x-tenant-id не нужен.
+    const key = process.env.BILLING_API_KEY?.trim();
+    if (!key) {
+        throw new Error('Задайте BILLING_API_KEY в .env / env MCP (project-scoped integration key, создаётся в Admin UI → Интеграция)');
+    }
+    h['Authorization'] = `Bearer ${key}`;
+    return h;
+}
+async function billingFetch(path, init = {}) {
+    const url = `${getBaseUrl()}${path.startsWith('/') ? path : `/${path}`}`;
+    const headers = new Headers(buildHeaders());
+    if (init.body) {
+        headers.set('Content-Type', 'application/json');
+    }
+    if (init.headers) {
+        const extra = new Headers(init.headers);
+        extra.forEach((v, k) => headers.set(k, v));
+    }
+    const res = await fetch(url, { ...init, headers });
+    const text = await res.text();
+    let body;
+    try {
+        body = text ? JSON.parse(text) : null;
+    }
+    catch {
+        body = text;
+    }
+    if (!res.ok) {
+        const msg = typeof body === 'string' ? body : JSON.stringify(body);
+        throw new Error(`HTTP ${res.status}: ${msg}`);
+    }
+    return body;
+}
+async function resolvePlanId(projectId, planCode) {
+    const plans = (await billingFetch(`/v1/projects/${projectId}/plans`));
+    const p = plans.find((x) => x.code === planCode);
+    if (!p) {
+        throw new Error(`План с code="${planCode}" не найден в проекте ${projectId}`);
+    }
+    return p.id;
+}
+async function resolvePlanIdFromArgs(projectId, args) {
+    let planId = args.planId;
+    if (!planId && args.planCode) {
+        planId = await resolvePlanId(projectId, String(args.planCode));
+    }
+    if (!planId) {
+        throw new Error('Укажите planId или planCode');
+    }
+    return planId;
+}
+const tools = [
+    {
+        name: 'billing_list_projects',
+        description: 'Список проектов тенанта (GET /v1/projects)',
+        inputSchema: { type: 'object', properties: {}, required: [] },
+    },
+    {
+        name: 'billing_list_plans',
+        description: 'Список планов проекта',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'UUID проекта' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_get_plan',
+        description: 'План по ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                planId: { type: 'string' },
+            },
+            required: ['projectId', 'planId'],
+        },
+    },
+    {
+        name: 'billing_create_plan',
+        description: 'Создать план (POST). code уникален в проекте.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                code: { type: 'string', description: 'slug, напр. team, business' },
+                name: { type: 'string' },
+                description: { type: 'string', description: 'опционально' },
+                isPublic: { type: 'boolean', description: 'по умолчанию true' },
+                isActive: { type: 'boolean', description: 'по умолчанию true' },
+                sortOrder: { type: 'number', description: 'по умолчанию 0' },
+            },
+            required: ['projectId', 'code', 'name'],
+        },
+    },
+    {
+        name: 'billing_update_plan',
+        description: 'Обновить план (PATCH). code менять нельзя.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                planId: { type: 'string' },
+                name: { type: 'string' },
+                description: { type: 'string' },
+                isPublic: { type: 'boolean' },
+                isActive: { type: 'boolean' },
+                sortOrder: { type: 'number' },
+            },
+            required: ['projectId', 'planId'],
+        },
+    },
+    {
+        name: 'billing_list_prices',
+        description: 'Список цен проекта',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_get_price',
+        description: 'Цена по ID',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                priceId: { type: 'string' },
+            },
+            required: ['projectId', 'priceId'],
+        },
+    },
+    {
+        name: 'billing_create_price',
+        description: 'Создать цену для плана. amountMinor — копейки (RUB). interval: month | year. Укажите planId ИЛИ planCode.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                planId: { type: 'string', description: 'UUID плана (если нет planCode)' },
+                planCode: { type: 'string', description: 'код плана, напр. team' },
+                code: { type: 'string', description: 'уникальный код цены в проекте, напр. team_monthly' },
+                amountMinor: { type: 'number', description: 'сумма в минорных единицах' },
+                currency: { type: 'string', description: 'по умолчанию RUB' },
+                interval: { type: 'string', enum: ['month', 'year'] },
+                intervalCount: { type: 'number', description: 'по умолчанию 1' },
+                trialDays: { type: 'number' },
+                isActive: { type: 'boolean', description: 'по умолчанию true' },
+            },
+            required: ['projectId', 'code', 'amountMinor', 'interval'],
+        },
+    },
+    {
+        name: 'billing_update_price',
+        description: 'Обновить цену (PATCH). planId менять нельзя.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                priceId: { type: 'string' },
+                code: { type: 'string' },
+                amountMinor: { type: 'number' },
+                currency: { type: 'string' },
+                interval: { type: 'string' },
+                intervalCount: { type: 'number' },
+                trialDays: { type: 'number' },
+                isActive: { type: 'boolean' },
+            },
+            required: ['projectId', 'priceId'],
+        },
+    },
+    {
+        name: 'billing_reset_project_catalog',
+        description: '[DEV] Удалить каталог проекта (plans/prices/…) и связанные подписки/инвойсы/платежи. Только NODE_ENV !== production. POST /v1/dev/projects/:id/reset-catalog',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'UUID проекта (напр. megaretro)' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_reset_and_seed_megaretro_catalog',
+        description: 'Сброс проекта, затем полный каталог MegaRetro по mega-retro/docs/product/pricing-and-capabilities.md: планы/цены (trial 14 дн. на team_monthly и business_monthly), фичи/лимиты, add-on доп. команда Business (+490₽/мес, год −20%), ориентиры Enterprise.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'UUID проекта megaretro' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_upsert_megaretro_features_and_limits',
+        description: 'Без сброса: создать недостающие фичи и привязки к планам free/team/business/enterprise с лимитами по pricing-and-capabilities.md (идемпотентно; уже существующие привязки пропускаются).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'UUID проекта' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_list_features',
+        description: 'Список фич проекта (GET /v1/projects/:id/features)',
+        inputSchema: {
+            type: 'object',
+            properties: { projectId: { type: 'string' } },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_create_feature',
+        description: 'Создать фичу: kind boolean | limit',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                code: { type: 'string' },
+                name: { type: 'string' },
+                kind: { type: 'string', enum: ['boolean', 'limit'] },
+            },
+            required: ['projectId', 'code', 'name', 'kind'],
+        },
+    },
+    {
+        name: 'billing_list_plan_features',
+        description: 'Привязки фич к плану. Укажите planId или planCode.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                planId: { type: 'string' },
+                planCode: { type: 'string', description: 'напр. team, business' },
+            },
+            required: ['projectId'],
+        },
+    },
+    {
+        name: 'billing_create_plan_feature',
+        description: 'Привязать фичу к плану (лимит или boolean). Укажите planId или planCode; для limit передайте limitValue (null = безлимит).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string' },
+                planId: { type: 'string' },
+                planCode: { type: 'string' },
+                featureId: { type: 'string' },
+                enabled: { type: 'boolean' },
+                limitValue: {
+                    type: 'number',
+                    description: 'для kind=limit; для безлимита передайте null через сырой JSON аргумента',
+                },
+            },
+            required: ['projectId', 'featureId'],
+        },
+    },
+];
+async function seedMegaretroCatalog(projectId) {
+    return runMegaretroCatalogSeed(billingFetch, projectId);
+}
+function pickBody(args, keys) {
+    const out = {};
+    for (const k of keys) {
+        if (args[k] !== undefined && args[k] !== null) {
+            out[k] = args[k];
+        }
+    }
+    return out;
+}
+async function handleTool(name, args) {
+    switch (name) {
+        case 'billing_list_projects':
+            return billingFetch('/v1/projects');
+        case 'billing_list_plans':
+            return billingFetch(`/v1/projects/${args.projectId}/plans`);
+        case 'billing_get_plan':
+            return billingFetch(`/v1/projects/${args.projectId}/plans/${args.planId}`);
+        case 'billing_create_plan':
+            return billingFetch(`/v1/projects/${args.projectId}/plans`, {
+                method: 'POST',
+                body: JSON.stringify(pickBody(args, ['code', 'name', 'description', 'isPublic', 'isActive', 'sortOrder'])),
+            });
+        case 'billing_update_plan':
+            return billingFetch(`/v1/projects/${args.projectId}/plans/${args.planId}`, {
+                method: 'PATCH',
+                body: JSON.stringify(pickBody(args, ['name', 'description', 'isPublic', 'isActive', 'sortOrder'])),
+            });
+        case 'billing_list_prices':
+            return billingFetch(`/v1/projects/${args.projectId}/prices`);
+        case 'billing_get_price':
+            return billingFetch(`/v1/projects/${args.projectId}/prices/${args.priceId}`);
+        case 'billing_create_price': {
+            let planId = args.planId;
+            const planCode = args.planCode;
+            if (!planId && planCode) {
+                planId = await resolvePlanId(String(args.projectId), planCode);
+            }
+            if (!planId) {
+                throw new Error('Укажите planId или planCode');
+            }
+            const body = {
+                planId,
+                code: args.code,
+                amountMinor: args.amountMinor,
+                currency: args.currency ?? 'RUB',
+                interval: args.interval,
+                intervalCount: args.intervalCount ?? 1,
+                trialDays: args.trialDays,
+                isActive: args.isActive ?? true,
+            };
+            return billingFetch(`/v1/projects/${args.projectId}/prices`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        }
+        case 'billing_update_price':
+            return billingFetch(`/v1/projects/${args.projectId}/prices/${args.priceId}`, {
+                method: 'PATCH',
+                body: JSON.stringify(pickBody(args, [
+                    'code',
+                    'amountMinor',
+                    'currency',
+                    'interval',
+                    'intervalCount',
+                    'trialDays',
+                    'isActive',
+                ])),
+            });
+        case 'billing_reset_project_catalog':
+            return billingFetch(`/v1/dev/projects/${args.projectId}/reset-catalog`, {
+                method: 'POST',
+            });
+        case 'billing_reset_and_seed_megaretro_catalog':
+            return seedMegaretroCatalog(String(args.projectId));
+        case 'billing_upsert_megaretro_features_and_limits':
+            return upsertMegaretroFeaturesAndLimits(billingFetch, String(args.projectId));
+        case 'billing_list_features':
+            return billingFetch(`/v1/projects/${args.projectId}/features`);
+        case 'billing_create_feature':
+            return billingFetch(`/v1/projects/${args.projectId}/features`, {
+                method: 'POST',
+                body: JSON.stringify(pickBody(args, ['code', 'name', 'kind'])),
+            });
+        case 'billing_list_plan_features': {
+            const planId = await resolvePlanIdFromArgs(String(args.projectId), args);
+            return billingFetch(`/v1/projects/${args.projectId}/plans/${planId}/plan-features`);
+        }
+        case 'billing_create_plan_feature': {
+            const planId = await resolvePlanIdFromArgs(String(args.projectId), args);
+            const body = { featureId: args.featureId };
+            if (args.enabled !== undefined) {
+                body.enabled = args.enabled;
+            }
+            if (Object.prototype.hasOwnProperty.call(args, 'limitValue')) {
+                body.limitValue = args.limitValue;
+            }
+            return billingFetch(`/v1/projects/${args.projectId}/plans/${planId}/plan-features`, {
+                method: 'POST',
+                body: JSON.stringify(body),
+            });
+        }
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}
+const server = new Server({ name: 'billing-catalog', version: '0.1.0' }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools }));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: raw } = request.params;
+    const args = raw || {};
+    try {
+        const result = await handleTool(name, args);
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    // Проверка наличия BILLING_API_KEY при старте (buildHeaders() бросит если ключ отсутствует)
+    buildHeaders();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('Billing Catalog MCP on stdio (project-scoped key configured)');
+}
+main().catch((e) => {
+    console.error(e);
+    process.exit(1);
+});

package/dist/megaretro-catalog-seed.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Каталог MegaRetro по канону:
+ * mega-retro/docs/product/pricing-and-capabilities.md (2026-03-22)
+ *
+ * Планы, цены, фичи (limits/boolean), add-on «доп. команда» для Business (+490 ₽/мес, год −20%).
+ */
+export type BillingFetch = (path: string, init?: RequestInit) => Promise<unknown>;
+type PlanCode = 'free' | 'team' | 'business' | 'enterprise';
+/** Помесячный trial для Team/Business — см. mega-retro/docs/product/pricing-and-capabilities.md */
+export declare const MEGARETRO_TRIAL_DAYS_PAID_MONTHLY = 14;
+/** Создаёт отсутствующие фичи проекта по канону MegaRetro (идемпотентно). */
+export declare function ensureMegaretroProjectFeatures(billingFetch: BillingFetch, projectId: string): Promise<Record<string, string>>;
+/** Привязки фич к планам по BINDINGS; существующие пары plan+feature пропускает. */
+export declare function applyMegaretroPlanFeatureBindings(billingFetch: BillingFetch, projectId: string, planIds: Record<PlanCode, string>, featureIds: Record<string, string>): Promise<{
+    items: unknown[];
+    created: number;
+    skipped: number;
+}>;
+/**
+ * Без сброса каталога: убедиться, что есть планы free/team/business/enterprise,
+ * завести недостающие фичи и привязки с лимитами по pricing-and-capabilities.md.
+ */
+export declare function upsertMegaretroFeaturesAndLimits(billingFetch: BillingFetch, projectId: string): Promise<{
+    sourceDoc: string;
+    planIds: Record<PlanCode, string>;
+    featureCodes: string[];
+    featureIds: Record<string, string>;
+    planFeatureBindingsCreated: number;
+    planFeatureBindingsSkipped: number;
+}>;
+export declare function seedMegaretroCatalog(billingFetch: BillingFetch, projectId: string): Promise<unknown>;
+export {};

package/dist/megaretro-catalog-seed.js

@@ -0,0 +1,444 @@
+/**
+ * Каталог MegaRetro по канону:
+ * mega-retro/docs/product/pricing-and-capabilities.md (2026-03-22)
+ *
+ * Планы, цены, фичи (limits/boolean), add-on «доп. команда» для Business (+490 ₽/мес, год −20%).
+ */
+const PLAN_ORDER = ['free', 'team', 'business', 'enterprise'];
+/** Описание фичи в проекте */
+const FEATURE_DEFS = [
+    { code: 'workspaces_in_subscription', name: 'Команд (workspaces) в подписке', kind: 'limit' },
+    { code: 'members_per_workspace', name: 'Участников на команду (null = безлимит)', kind: 'limit' },
+    {
+        code: 'concurrent_active_retro_boards',
+        name: 'Активных ретро-досок одновременно (null = безлимит)',
+        kind: 'limit',
+    },
+    {
+        code: 'retro_history_retention_days',
+        name: 'История ретро: дней хранения контента (null = безлимит)',
+        kind: 'limit',
+    },
+    { code: 'guest_board_access', name: 'Гостевой вход по ссылке на доску', kind: 'boolean' },
+    { code: 'board_templates_basic', name: 'Базовые шаблоны досок', kind: 'boolean' },
+    { code: 'board_templates_custom', name: 'Все шаблоны + кастомные шаблоны', kind: 'boolean' },
+    { code: 'corporate_template_library', name: 'Корпоративная библиотека шаблонов', kind: 'boolean' },
+    { code: 'export_full', name: 'Расширенный экспорт (сверх базового)', kind: 'boolean' },
+    { code: 'integration_slack', name: 'Интеграция Slack', kind: 'boolean' },
+    { code: 'integration_jira', name: 'Интеграция Jira', kind: 'boolean' },
+    { code: 'integration_webhooks', name: 'Webhooks', kind: 'boolean' },
+    { code: 'integration_public_api', name: 'Публичный / партнёрский API', kind: 'boolean' },
+    { code: 'integration_custom_contract', name: 'Кастомные интеграции (договор)', kind: 'boolean' },
+    { code: 'analytics_team_basic', name: 'Базовая аналитика по команде', kind: 'boolean' },
+    { code: 'analytics_cross_workspace', name: 'Расширенная аналитика и кросс-командные срезы', kind: 'boolean' },
+    { code: 'analytics_enterprise_reports', name: 'Корпоративные отчёты и выгрузки', kind: 'boolean' },
+    { code: 'data_isolation_multi_tenant', name: 'Базовая изоляция данных (multi-tenant)', kind: 'boolean' },
+    { code: 'security_sso_saml', name: 'SSO / SAML', kind: 'boolean' },
+    { code: 'security_rbac_extended', name: 'RBAC, расширенные роли', kind: 'boolean' },
+    { code: 'security_audit_extended', name: 'Журнал аудита расширенный', kind: 'boolean' },
+    { code: 'security_contractual_data', name: 'Условия хранения и обработки данных по договору', kind: 'boolean' },
+    { code: 'support_priority_email', name: 'Приоритетная поддержка (email)', kind: 'boolean' },
+    { code: 'support_chat_priority_247', name: 'Поддержка чат / приоритет 24/7', kind: 'boolean' },
+    { code: 'support_dedicated_account_manager', name: 'Выделенный аккаунт-менеджер', kind: 'boolean' },
+    { code: 'support_sla_availability', name: 'SLA по доступности сервиса', kind: 'boolean' },
+    { code: 'support_onboarding_training', name: 'Онбординг и обучение', kind: 'boolean' },
+    { code: 'ai_retro_summary', name: 'AI-саммари ретро', kind: 'boolean' },
+    { code: 'ai_card_rewrite', name: 'AI-rewrite / улучшение текста карточки', kind: 'boolean' },
+    { code: 'ai_card_clustering', name: 'AI-кластеризация карточек', kind: 'boolean' },
+    { code: 'ai_session_insights', name: 'AI-инсайты (одна сессия)', kind: 'boolean' },
+    { code: 'ai_action_items', name: 'AI-генерация action items', kind: 'boolean' },
+    { code: 'ai_cross_retro_patterns', name: 'Кросс-ретро тренды и паттерны', kind: 'boolean' },
+    { code: 'ai_priority_models', name: 'Приоритетные AI-модели и очередь', kind: 'boolean' },
+    { code: 'ai_custom_prompts', name: 'Кастомные промпты (корп. стандарты)', kind: 'boolean' },
+    { code: 'ai_opt_out_workspace', name: 'Opt-out AI на уровне workspace', kind: 'boolean' },
+    {
+        code: 'ai_requests_tier',
+        name: 'Уровень лимита AI-запросов (черновик: 0=нет, 1=умеренный, 2=выше, 3=наивысший)',
+        kind: 'limit',
+    },
+];
+/** Для каждой фичи — значения по планам (нет ключа = фича выключена / не применима для плана) */
+const BINDINGS = {
+    workspaces_in_subscription: {
+        free: { limit: 1 },
+        team: { limit: 1 },
+        business: { limit: 5 },
+        enterprise: { limit: null },
+    },
+    members_per_workspace: {
+        free: { limit: 10 },
+        team: { limit: 30 },
+        business: { limit: null },
+        enterprise: { limit: null },
+    },
+    concurrent_active_retro_boards: {
+        free: { limit: 3 },
+        team: { limit: null },
+        business: { limit: null },
+        enterprise: { limit: null },
+    },
+    retro_history_retention_days: {
+        free: { limit: 30 },
+        team: { limit: null },
+        business: { limit: null },
+        enterprise: { limit: null },
+    },
+    guest_board_access: {
+        free: { enabled: true },
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    board_templates_basic: {
+        free: { enabled: true },
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    board_templates_custom: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    corporate_template_library: { enterprise: { enabled: true } },
+    export_full: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    integration_slack: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    integration_jira: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    integration_webhooks: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    integration_public_api: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    integration_custom_contract: { enterprise: { enabled: true } },
+    analytics_team_basic: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    analytics_cross_workspace: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    analytics_enterprise_reports: { enterprise: { enabled: true } },
+    data_isolation_multi_tenant: {
+        free: { enabled: true },
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    security_sso_saml: { enterprise: { enabled: true } },
+    security_rbac_extended: { enterprise: { enabled: true } },
+    security_audit_extended: { enterprise: { enabled: true } },
+    security_contractual_data: { enterprise: { enabled: true } },
+    support_priority_email: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    support_chat_priority_247: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    support_dedicated_account_manager: { enterprise: { enabled: true } },
+    support_sla_availability: { enterprise: { enabled: true } },
+    support_onboarding_training: { enterprise: { enabled: true } },
+    ai_retro_summary: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_card_rewrite: {
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_card_clustering: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_session_insights: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_action_items: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_cross_retro_patterns: {
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_priority_models: { enterprise: { enabled: true } },
+    ai_custom_prompts: { enterprise: { enabled: true } },
+    ai_opt_out_workspace: {
+        free: { enabled: true },
+        team: { enabled: true },
+        business: { enabled: true },
+        enterprise: { enabled: true },
+    },
+    ai_requests_tier: {
+        free: { limit: 0 },
+        team: { limit: 1 },
+        business: { limit: 2 },
+        enterprise: { limit: 3 },
+    },
+};
+const PLAN_DEFS = [
+    {
+        code: 'free',
+        name: 'Free',
+        description: 'Freemium: 1 workspace, лимиты по mega-retro/docs/product/pricing-and-capabilities.md. Базовый экспорт, без платных AI.',
+        sortOrder: 0,
+        isPublic: true,
+        isActive: true,
+    },
+    {
+        code: 'team',
+        name: 'Team',
+        description: '1 workspace, 1 290 ₽/мес. AI: саммари и rewrite. Годовая оплата −20% от суммы 12 месяцев.',
+        sortOrder: 1,
+        isPublic: true,
+        isActive: true,
+    },
+    {
+        code: 'business',
+        name: 'Business',
+        description: 'До 5 команд в базе; +490 ₽/мес за каждую команду сверх (add-on). 2 990 ₽/мес база. Jira, webhooks, API, расширенная AI.',
+        sortOrder: 2,
+        isPublic: true,
+        isActive: true,
+    },
+    {
+        code: 'enterprise',
+        name: 'Enterprise',
+        description: 'По запросу, договор. Цены в биллинге — ориентиры для кассы/офферов; фактические условия в договоре.',
+        sortOrder: 3,
+        isPublic: false,
+        isActive: true,
+    },
+];
+/** Помесячный trial для Team/Business — см. mega-retro/docs/product/pricing-and-capabilities.md */
+export const MEGARETRO_TRIAL_DAYS_PAID_MONTHLY = 14;
+const PRICE_DEFS = [
+    { planCode: 'free', code: 'free_monthly', amountMinor: 0, interval: 'month' },
+    { planCode: 'free', code: 'free_yearly', amountMinor: 0, interval: 'year' },
+    {
+        planCode: 'team',
+        code: 'team_monthly',
+        amountMinor: 129_000,
+        interval: 'month',
+        trialDays: MEGARETRO_TRIAL_DAYS_PAID_MONTHLY,
+    },
+    { planCode: 'team', code: 'team_yearly', amountMinor: 1_238_400, interval: 'year' },
+    {
+        planCode: 'business',
+        code: 'business_monthly',
+        amountMinor: 299_000,
+        interval: 'month',
+        trialDays: MEGARETRO_TRIAL_DAYS_PAID_MONTHLY,
+    },
+    { planCode: 'business', code: 'business_yearly', amountMinor: 2_870_400, interval: 'year' },
+    {
+        planCode: 'enterprise',
+        code: 'enterprise_monthly_from',
+        amountMinor: 2_700_000,
+        interval: 'month',
+    },
+    {
+        planCode: 'enterprise',
+        code: 'enterprise_yearly_from',
+        amountMinor: 25_920_000,
+        interval: 'year',
+    },
+];
+/** 490 ₽ × 12 × 0,8 в копейках */
+const BUSINESS_EXTRA_WORKSPACE_YEARLY_MINOR = 490 * 100 * 12 * 0.8;
+function buildPlanFeatureRequestBody(f, featureId, b) {
+    const body = { featureId };
+    if (f.kind === 'boolean') {
+        body.enabled = b.enabled ?? true;
+    }
+    else {
+        body.enabled = true;
+        if (b.limit !== undefined) {
+            body.limitValue = b.limit;
+        }
+    }
+    return body;
+}
+/** Создаёт отсутствующие фичи проекта по канону MegaRetro (идемпотентно). */
+export async function ensureMegaretroProjectFeatures(billingFetch, projectId) {
+    const existing = (await billingFetch(`/v1/projects/${projectId}/features`));
+    const byCode = new Map(existing.map((x) => [x.code, x.id]));
+    const featureIds = {};
+    for (const f of FEATURE_DEFS) {
+        let id = byCode.get(f.code);
+        if (!id) {
+            const row = (await billingFetch(`/v1/projects/${projectId}/features`, {
+                method: 'POST',
+                body: JSON.stringify({ code: f.code, name: f.name, kind: f.kind }),
+            }));
+            id = row.id;
+            byCode.set(f.code, id);
+        }
+        featureIds[f.code] = id;
+    }
+    return featureIds;
+}
+/** Привязки фич к планам по BINDINGS; существующие пары plan+feature пропускает. */
+export async function applyMegaretroPlanFeatureBindings(billingFetch, projectId, planIds, featureIds) {
+    const items = [];
+    let created = 0;
+    let skipped = 0;
+    for (const planCode of PLAN_ORDER) {
+        const planId = planIds[planCode];
+        const existingList = (await billingFetch(`/v1/projects/${projectId}/plans/${planId}/plan-features`));
+        const have = new Set(existingList.map((x) => x.featureId));
+        for (const f of FEATURE_DEFS) {
+            const b = BINDINGS[f.code]?.[planCode];
+            if (!b) {
+                continue;
+            }
+            const fid = featureIds[f.code];
+            if (have.has(fid)) {
+                skipped++;
+                continue;
+            }
+            const body = buildPlanFeatureRequestBody(f, fid, b);
+            const pf = await billingFetch(`/v1/projects/${projectId}/plans/${planId}/plan-features`, { method: 'POST', body: JSON.stringify(body) });
+            items.push(pf);
+            have.add(fid);
+            created++;
+        }
+    }
+    return { items, created, skipped };
+}
+/**
+ * Без сброса каталога: убедиться, что есть планы free/team/business/enterprise,
+ * завести недостающие фичи и привязки с лимитами по pricing-and-capabilities.md.
+ */
+export async function upsertMegaretroFeaturesAndLimits(billingFetch, projectId) {
+    const plans = (await billingFetch(`/v1/projects/${projectId}/plans`));
+    const planIds = {};
+    for (const code of PLAN_ORDER) {
+        const p = plans.find((x) => x.code === code);
+        if (!p) {
+            throw new Error(`В проекте нет плана с code="${code}". Создайте планы или выполните billing_reset_and_seed_megaretro_catalog.`);
+        }
+        planIds[code] = p.id;
+    }
+    const featureIds = await ensureMegaretroProjectFeatures(billingFetch, projectId);
+    const { created, skipped } = await applyMegaretroPlanFeatureBindings(billingFetch, projectId, planIds, featureIds);
+    return {
+        sourceDoc: 'mega-retro/docs/product/pricing-and-capabilities.md',
+        planIds,
+        featureCodes: FEATURE_DEFS.map((x) => x.code),
+        featureIds,
+        planFeatureBindingsCreated: created,
+        planFeatureBindingsSkipped: skipped,
+    };
+}
+export async function seedMegaretroCatalog(billingFetch, projectId) {
+    await billingFetch(`/v1/dev/projects/${projectId}/reset-catalog`, { method: 'POST' });
+    const planIds = {};
+    for (const p of PLAN_DEFS) {
+        const res = (await billingFetch(`/v1/projects/${projectId}/plans`, {
+            method: 'POST',
+            body: JSON.stringify(p),
+        }));
+        planIds[p.code] = res.id;
+    }
+    const createdPrices = [];
+    for (const pr of PRICE_DEFS) {
+        const payload = {
+            planId: planIds[pr.planCode],
+            code: pr.code,
+            amountMinor: pr.amountMinor,
+            currency: 'RUB',
+            interval: pr.interval,
+            intervalCount: 1,
+            isActive: true,
+        };
+        if (pr.trialDays != null) {
+            payload.trialDays = pr.trialDays;
+        }
+        const r = await billingFetch(`/v1/projects/${projectId}/prices`, {
+            method: 'POST',
+            body: JSON.stringify(payload),
+        });
+        createdPrices.push(r);
+    }
+    const extraMonthly = (await billingFetch(`/v1/projects/${projectId}/prices`, {
+        method: 'POST',
+        body: JSON.stringify({
+            planId: planIds.business,
+            code: 'business_extra_workspace_monthly',
+            amountMinor: 490_000,
+            currency: 'RUB',
+            interval: 'month',
+            intervalCount: 1,
+            isActive: true,
+        }),
+    }));
+    const extraYearly = (await billingFetch(`/v1/projects/${projectId}/prices`, {
+        method: 'POST',
+        body: JSON.stringify({
+            planId: planIds.business,
+            code: 'business_extra_workspace_yearly',
+            amountMinor: BUSINESS_EXTRA_WORKSPACE_YEARLY_MINOR,
+            currency: 'RUB',
+            interval: 'year',
+            intervalCount: 1,
+            isActive: true,
+        }),
+    }));
+    const featureIds = await ensureMegaretroProjectFeatures(billingFetch, projectId);
+    const { items: planFeatures, created: pfCreated, skipped: pfSkipped } = await applyMegaretroPlanFeatureBindings(billingFetch, projectId, planIds, featureIds);
+    const addonMonthly = await billingFetch(`/v1/admin/projects/${projectId}/addons`, {
+        method: 'POST',
+        body: JSON.stringify({
+            code: 'business_extra_workspace',
+            name: 'Дополнительная команда (workspace)',
+            description: '+490 ₽/мес за каждую команду сверх 5 (Business). pricing-and-capabilities.md',
+            priceId: extraMonthly.id,
+            billingType: 'recurring',
+            compatiblePlanIds: [planIds.business],
+        }),
+    });
+    const addonYearly = await billingFetch(`/v1/admin/projects/${projectId}/addons`, {
+        method: 'POST',
+        body: JSON.stringify({
+            code: 'business_extra_workspace_yearly',
+            name: 'Дополнительная команда — годовая',
+            description: 'Годовая оплата за одну доп. команду: 12×490₽×0,8',
+            priceId: extraYearly.id,
+            billingType: 'recurring',
+            compatiblePlanIds: [planIds.business],
+        }),
+    });
+    return {
+        sourceDoc: 'mega-retro/docs/product/pricing-and-capabilities.md',
+        plans: planIds,
+        prices: createdPrices,
+        extraWorkspacePrices: { monthly: extraMonthly, yearly: extraYearly },
+        addons: { addonMonthly, addonYearly },
+        featureCount: FEATURE_DEFS.length,
+        planFeatureBindingsCreated: pfCreated,
+        planFeatureBindingsSkipped: pfSkipped,
+        planFeatures,
+    };
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@openaisdk/billing-mcp",
+  "version": "0.2.1",
+  "description": "MCP server: управление планами и ценами Billing API (catalog)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "billing-catalog-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx index.ts",
+    "lint": "eslint .",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.4.7"
+  },
+  "devDependencies": {
+    "@saas-billing/eslint-config": "workspace:*",
+    "@saas-billing/typescript-config": "workspace:*",
+    "@types/node": "^20",
+    "tsx": "^4.21.0",
+    "typescript": "^5"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "billing",
+    "saas-billing",
+    "catalog",
+    "cursor"
+  ],
+  "license": "MIT",
+  "author": "Anatoliy Tukov <openaisdk@gmail.com>"
+}