@bitrix24/mcp-docs 0.1.0

package/dist/data/scopes.json

@@ -0,0 +1,177 @@
+[
+    {
+        "scope": "crm",
+        "description": "Full access to CRM entities: deals, leads, contacts, companies, quotes, smart invoices, and CRM activities. Allows reading, creating, updating, and deleting CRM records and their associated fields.",
+        "module": "crm"
+    },
+    {
+        "scope": "task",
+        "description": "Access to task management: create, read, update, and delete tasks, task comments, and task fields. Includes access to task checklists and time tracking entries.",
+        "module": "tasks"
+    },
+    {
+        "scope": "tasks",
+        "description": "Alias for the task scope. Provides the same access to task management: create, read, update, and delete tasks, comments, and task-related entities.",
+        "module": "tasks"
+    },
+    {
+        "scope": "im",
+        "description": "Access to instant messaging: send messages to chats and users, read chat history, manage chat participants, and create notifications within Bitrix24 messenger.",
+        "module": "im"
+    },
+    {
+        "scope": "imbot",
+        "description": "Access to create and manage chatbots (IM bots). Allows registering bots, handling bot commands, sending messages from bots, and managing bot event subscriptions.",
+        "module": "im"
+    },
+    {
+        "scope": "imopenlines",
+        "description": "Access to Open Lines (omnichannel messaging). Allows integrating external messaging channels (WhatsApp, Telegram, etc.) with Bitrix24 Open Lines, managing conversations and operators.",
+        "module": "im"
+    },
+    {
+        "scope": "call",
+        "description": "Access to call tracking and VoIP integration. Allows registering incoming and outgoing calls, attaching call recordings, and linking calls to CRM entities.",
+        "module": "telephony"
+    },
+    {
+        "scope": "telephony",
+        "description": "Full access to telephony features: manage phone numbers, configure SIP connectors, access call logs, and integrate external PBX systems with Bitrix24 telephony.",
+        "module": "telephony"
+    },
+    {
+        "scope": "bizproc",
+        "description": "Access to business processes and automation. Allows starting and managing workflow instances, registering custom activities for business process templates, and reading business process definitions.",
+        "module": "bizproc"
+    },
+    {
+        "scope": "calendar",
+        "description": "Access to the calendar module: read and write calendar events, manage event attendees, access user and group calendars, and subscribe to calendar event notifications.",
+        "module": "calendar"
+    },
+    {
+        "scope": "timeman",
+        "description": "Access to time management features: read and write time tracking records, manage work schedules, access work time reports, and integrate with external time tracking systems.",
+        "module": "timeman"
+    },
+    {
+        "scope": "catalog",
+        "description": "Access to the product catalog: manage products, product sections, SKU variants, price types, and product properties. Used for e-commerce and inventory integrations.",
+        "module": "catalog"
+    },
+    {
+        "scope": "sale",
+        "description": "Access to the online store and sales module: manage orders, order items, order statuses, payment integrations, delivery configurations, and customer data in the store.",
+        "module": "sale"
+    },
+    {
+        "scope": "lists",
+        "description": "Access to universal lists (custom list entities in Bitrix24). Allows creating and managing list types, adding/editing/deleting list items, and configuring list fields.",
+        "module": "lists"
+    },
+    {
+        "scope": "disk",
+        "description": "Access to the Bitrix24 Drive (file storage): upload, download, move, copy, and delete files and folders. Manage file versions, sharing permissions, and access file metadata.",
+        "module": "disk"
+    },
+    {
+        "scope": "entity",
+        "description": "Access to the generic data storage entity (storage entity). Allows creating custom data storage containers and managing their items, similar to a key-value store with structured data.",
+        "module": "entity"
+    },
+    {
+        "scope": "user",
+        "description": "Full access to user management: read detailed user profiles, update user fields, manage user invitations, and access the full user directory including sensitive fields.",
+        "module": "user"
+    },
+    {
+        "scope": "user_basic",
+        "description": "Read-only access to basic user information: name, photo, and online status. Suitable for applications that need to display user avatars or check presence without accessing private data.",
+        "module": "user"
+    },
+    {
+        "scope": "user_brief",
+        "description": "Read-only access to a brief user profile: name, department, position, and work contact details. A middle-ground between user_basic and the full user scope.",
+        "module": "user"
+    },
+    {
+        "scope": "user.userfield",
+        "description": "Access to manage custom user fields (user fields). Allows creating, editing, and deleting custom fields attached to the user entity in Bitrix24.",
+        "module": "user"
+    },
+    {
+        "scope": "department",
+        "description": "Access to the company structure (departments/organisational chart). Allows reading and writing department data, managing department members, and navigating the org hierarchy.",
+        "module": "intranet"
+    },
+    {
+        "scope": "landing",
+        "description": "Access to the Bitrix24 Sites & Landing Pages module. Allows creating and managing landing pages, sites, blocks, and forms built with the Bitrix24 site builder.",
+        "module": "landing"
+    },
+    {
+        "scope": "documentgenerator",
+        "description": "Access to the Document Generator module. Allows creating documents from templates, filling template placeholders with entity data (e.g. from CRM deals), and managing document templates.",
+        "module": "documentgenerator"
+    },
+    {
+        "scope": "sign.b2e",
+        "description": "Access to the Bitrix24 Sign B2E (business-to-employee) electronic signature module. Allows initiating and tracking e-signature workflows for internal HR documents.",
+        "module": "sign"
+    },
+    {
+        "scope": "sonet_group",
+        "description": "Access to social network groups (workgroups and projects). Allows creating and managing groups, adding members, and reading group activity feeds.",
+        "module": "socialnetwork"
+    },
+    {
+        "scope": "log",
+        "description": "Access to the company activity feed (live feed/log). Allows reading and posting messages to the Bitrix24 activity feed and managing comments on feed posts.",
+        "module": "log"
+    },
+    {
+        "scope": "vote",
+        "description": "Access to the polling and voting module. Allows creating, reading, and managing votes and polls within Bitrix24.",
+        "module": "vote"
+    },
+    {
+        "scope": "ai_admin",
+        "description": "Administrative access to Bitrix24 AI features and CoPilot configuration. Allows managing AI provider settings, prompts, and AI-powered feature configuration.",
+        "module": "ai"
+    },
+    {
+        "scope": "biconnector",
+        "description": "Access to the BI Connector module for business intelligence integrations. Allows configuring data sources and exporting Bitrix24 data to external BI tools.",
+        "module": "biconnector"
+    },
+    {
+        "scope": "booking",
+        "description": "Access to the Booking module (online scheduling). Allows managing booking resources, time slots, reservations, and booking form configurations.",
+        "module": "booking"
+    },
+    {
+        "scope": "delivery",
+        "description": "Access to delivery services configuration in the online store. Allows registering and managing delivery service handlers and shipping methods.",
+        "module": "sale"
+    },
+    {
+        "scope": "pay_system",
+        "description": "Access to payment system integrations. Allows registering custom payment handlers, managing payment system settings, and processing payment callbacks in the online store.",
+        "module": "sale"
+    },
+    {
+        "scope": "main",
+        "description": "Access to core Bitrix24 platform features: application placement management, event subscriptions, option storage, and basic portal information. Required for most applications.",
+        "module": "main"
+    },
+    {
+        "scope": "placement",
+        "description": "Access to the placement API: bind and unbind application handlers to UI extension points (placements) within Bitrix24, and list currently bound placements.",
+        "module": "main"
+    },
+    {
+        "scope": "userfieldtype",
+        "description": "Access to register and manage custom user field types. Allows applications to define new field types that can be added to CRM entities, tasks, and other objects in Bitrix24.",
+        "module": "main"
+    }
+]

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+declare const server: McpServer;
+export { server };

package/dist/index.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+// packages/mcp-bitrix24-docs/src/index.ts
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ResourceTemplate } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { searchDocs, searchDocsSchema } from './tools/search.js';
+import { getPlacements, getPlacementDetail, getPlacementsSchema, getPlacementDetailSchema } from './tools/placements.js';
+import { getScopes, getScopesSchema } from './tools/scopes.js';
+import { getRestMethods, getMethodDetail, getRestMethodsSchema, getMethodDetailSchema } from './tools/methods.js';
+import { getAppTypes, getCategories } from './tools/references.js';
+import { getGuide, GUIDES } from './resources/guides.js';
+const server = new McpServer({
+    name: 'bitrix24-docs',
+    version: '0.1.0',
+});
+// Tools
+server.tool('search_docs', 'Full-text search across Bitrix24 docs', searchDocsSchema.shape, async (params) => {
+    const results = searchDocs(params.query, params.limit);
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+server.tool('get_placements', 'List available Bitrix24 UI placements', getPlacementsSchema.shape, async (params) => {
+    const results = getPlacements(params.module);
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+server.tool('get_placement_detail', 'Get full details for a specific UI placement', getPlacementDetailSchema.shape, async (params) => {
+    const result = getPlacementDetail(params.placement);
+    if (!result) {
+        return { content: [{ type: 'text', text: `Placement "${params.placement}" not found.` }] };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+});
+server.tool('get_scopes', 'List Bitrix24 REST API permission scopes', getScopesSchema.shape, async (params) => {
+    const results = getScopes(params.module);
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+server.tool('get_rest_methods', 'List Bitrix24 REST API methods', getRestMethodsSchema.shape, async (params) => {
+    const results = getRestMethods(params.scope, params.query);
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+server.tool('get_method_detail', 'Get full details for a specific REST API method', getMethodDetailSchema.shape, async (params) => {
+    const result = getMethodDetail(params.method);
+    if (!result) {
+        return { content: [{ type: 'text', text: `Method "${params.method}" not found.` }] };
+    }
+    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+});
+server.tool('get_app_types', 'List Bitrix24 application types', {}, async () => {
+    const results = getAppTypes();
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+server.tool('get_categories', 'List Bitrix24 application categories', {}, async () => {
+    const results = getCategories();
+    return { content: [{ type: 'text', text: JSON.stringify(results, null, 2) }] };
+});
+// Resources
+for (const guide of GUIDES) {
+    server.resource(guide.name, new ResourceTemplate(guide.uri, { list: undefined }), async () => {
+        const content = getGuide(guide.name);
+        return {
+            contents: [
+                {
+                    uri: guide.uri,
+                    mimeType: 'text/markdown',
+                    text: content ?? `Guide "${guide.name}" not found.`,
+                },
+            ],
+        };
+    });
+}
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('bitrix24-docs MCP server running on stdio');
+}
+main().catch(console.error);
+export { server };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/resources/guides.d.ts

@@ -0,0 +1,6 @@
+export declare function getGuide(name: string): string | null;
+export declare const GUIDES: {
+    uri: string;
+    name: string;
+    title: string;
+}[];

package/dist/resources/guides.js

@@ -0,0 +1,26 @@
+import { readFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const guidesDir = join(__dirname, '..', 'data', 'guides');
+export function getGuide(name) {
+    try {
+        return readFileSync(join(guidesDir, `${name}.md`), 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+export const GUIDES = [
+    {
+        uri: 'bitrix24://guides/getting-started',
+        name: 'getting-started',
+        title: 'Getting Started with Bitrix24 App Development',
+    },
+    {
+        uri: 'bitrix24://guides/app-lifecycle',
+        name: 'app-lifecycle',
+        title: 'Application Lifecycle',
+    },
+];
+//# sourceMappingURL=guides.js.map

package/dist/resources/guides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guides.js","sourceRoot":"","sources":["../../src/resources/guides.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAA;AAEnC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AACzD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAEzD,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,CAAC,CAAA;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB;QACE,GAAG,EAAE,mCAAmC;QACxC,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,+CAA+C;KACvD;IACD;QACE,GAAG,EAAE,iCAAiC;QACtC,IAAI,EAAE,eAAe;QACrB,KAAK,EAAE,uBAAuB;KAC/B;CACF,CAAA"}

package/dist/tools/methods.d.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+interface Method {
+    method: string;
+    description: string;
+    scope: string;
+    parameters: Array<{
+        name: string;
+        type: string;
+        description: string;
+    }>;
+    returns: string;
+    example: string;
+}
+export declare function getRestMethods(scope?: string, query?: string): Method[];
+export declare function getMethodDetail(method: string): Method | null;
+export declare const getRestMethodsSchema: z.ZodObject<{
+    scope: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    scope?: string | undefined;
+    query?: string | undefined;
+}, {
+    scope?: string | undefined;
+    query?: string | undefined;
+}>;
+export declare const getMethodDetailSchema: z.ZodObject<{
+    method: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    method: string;
+}, {
+    method: string;
+}>;
+export {};

package/dist/tools/methods.js

@@ -0,0 +1,24 @@
+import { z } from 'zod';
+import data from '../data/methods.json' with { type: 'json' };
+const methods = data;
+export function getRestMethods(scope, query) {
+    let result = methods;
+    if (scope)
+        result = result.filter(m => m.scope === scope);
+    if (query) {
+        const q = query.toLowerCase();
+        result = result.filter(m => m.method.toLowerCase().includes(q) || m.description.toLowerCase().includes(q));
+    }
+    return result;
+}
+export function getMethodDetail(method) {
+    return methods.find(m => m.method === method) ?? null;
+}
+export const getRestMethodsSchema = z.object({
+    scope: z.string().optional().describe('Filter by scope (e.g. "crm")'),
+    query: z.string().optional().describe('Search in method names and descriptions'),
+});
+export const getMethodDetailSchema = z.object({
+    method: z.string().describe('Method name (e.g. "crm.deal.list")'),
+});
+//# sourceMappingURL=methods.js.map

package/dist/tools/methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"methods.js","sourceRoot":"","sources":["../../src/tools/methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,IAAI,MAAM,sBAAsB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAW7D,MAAM,OAAO,GAAG,IAAgB,CAAA;AAEhC,MAAM,UAAU,cAAc,CAAC,KAAc,EAAE,KAAc;IAC3D,IAAI,MAAM,GAAG,OAAO,CAAA;IACpB,IAAI,KAAK;QAAE,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAA;IACzD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAA;QAC7B,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;IAC5G,CAAC;IACD,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,IAAI,IAAI,CAAA;AACvD,CAAC;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;CACjF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;CAClE,CAAC,CAAA"}

package/dist/tools/placements.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+interface Placement {
+    code: string;
+    title: string;
+    description: string;
+    module: string;
+    handler_params: Array<{
+        name: string;
+        type: string;
+    }>;
+    example: string;
+}
+export declare function getPlacements(module?: string): Placement[];
+export declare function getPlacementDetail(code: string): Placement | null;
+export declare const getPlacementsSchema: z.ZodObject<{
+    module: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    module?: string | undefined;
+}, {
+    module?: string | undefined;
+}>;
+export declare const getPlacementDetailSchema: z.ZodObject<{
+    placement: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    placement: string;
+}, {
+    placement: string;
+}>;
+export {};

package/dist/tools/placements.js

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+import data from '../data/placements.json' with { type: 'json' };
+const placements = data;
+export function getPlacements(module) {
+    if (!module)
+        return placements;
+    return placements.filter(p => p.module === module);
+}
+export function getPlacementDetail(code) {
+    return placements.find(p => p.code === code) ?? null;
+}
+export const getPlacementsSchema = z.object({
+    module: z.string().optional().describe('Filter by module (e.g. "crm", "tasks", "im")'),
+});
+export const getPlacementDetailSchema = z.object({
+    placement: z.string().describe('Placement code (e.g. "CRM_DEAL_DETAIL_TAB")'),
+});
+//# sourceMappingURL=placements.js.map

package/dist/tools/placements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"placements.js","sourceRoot":"","sources":["../../src/tools/placements.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,IAAI,MAAM,yBAAyB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAWhE,MAAM,UAAU,GAAG,IAAmB,CAAA;AAEtC,MAAM,UAAU,aAAa,CAAC,MAAe;IAC3C,IAAI,CAAC,MAAM;QAAE,OAAO,UAAU,CAAA;IAC9B,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;AACpD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAA;AACtD,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACvF,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;CAC9E,CAAC,CAAA"}

package/dist/tools/references.d.ts

@@ -0,0 +1,12 @@
+export declare function getAppTypes(): {
+    type: string;
+    title: string;
+    description: string;
+    use_cases: string[];
+    requirements: string[];
+}[];
+export declare function getCategories(): {
+    code: string;
+    title: string;
+    description: string;
+}[];

package/dist/tools/references.js

@@ -0,0 +1,9 @@
+import appTypes from '../data/app-types.json' with { type: 'json' };
+import categories from '../data/categories.json' with { type: 'json' };
+export function getAppTypes() {
+    return appTypes;
+}
+export function getCategories() {
+    return categories;
+}
+//# sourceMappingURL=references.js.map

package/dist/tools/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/tools/references.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,wBAAwB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AACnE,OAAO,UAAU,MAAM,yBAAyB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAEtE,MAAM,UAAU,WAAW;IACzB,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/tools/scopes.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+interface Scope {
+    scope: string;
+    description: string;
+    module: string;
+}
+export declare function getScopes(module?: string): Scope[];
+export declare const getScopesSchema: z.ZodObject<{
+    module: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    module?: string | undefined;
+}, {
+    module?: string | undefined;
+}>;
+export {};

package/dist/tools/scopes.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+import data from '../data/scopes.json' with { type: 'json' };
+const scopes = data;
+export function getScopes(module) {
+    if (!module)
+        return scopes;
+    return scopes.filter(s => s.module === module);
+}
+export const getScopesSchema = z.object({
+    module: z.string().optional().describe('Filter by module'),
+});
+//# sourceMappingURL=scopes.js.map

package/dist/tools/scopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scopes.js","sourceRoot":"","sources":["../../src/tools/scopes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,IAAI,MAAM,qBAAqB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAQ5D,MAAM,MAAM,GAAG,IAAe,CAAA;AAE9B,MAAM,UAAU,SAAS,CAAC,MAAe;IACvC,IAAI,CAAC,MAAM;QAAE,OAAO,MAAM,CAAA;IAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAA;AAChD,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;CAC3D,CAAC,CAAA"}

package/dist/tools/search.d.ts

@@ -0,0 +1,18 @@
+import { z } from 'zod';
+export interface SearchResult {
+    title: string;
+    type: 'placement' | 'scope' | 'method' | 'category' | 'app_type';
+    summary: string;
+    ref: string;
+}
+export declare function searchDocs(query: string, limit?: number): SearchResult[];
+export declare const searchDocsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+}, {
+    query: string;
+    limit?: number | undefined;
+}>;

package/dist/tools/search.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import placements from '../data/placements.json' with { type: 'json' };
+import scopes from '../data/scopes.json' with { type: 'json' };
+import methods from '../data/methods.json' with { type: 'json' };
+import categories from '../data/categories.json' with { type: 'json' };
+import appTypes from '../data/app-types.json' with { type: 'json' };
+function matchScore(text, query) {
+    const lower = text.toLowerCase();
+    const terms = query.toLowerCase().split(/\s+/);
+    return terms.filter(term => lower.includes(term)).length;
+}
+export function searchDocs(query, limit = 10) {
+    const maxLimit = Math.min(limit, 50);
+    const results = [];
+    for (const p of placements) {
+        const score = matchScore(`${p.code} ${p.title} ${p.description} ${p.module}`, query);
+        if (score > 0)
+            results.push({ title: p.code, type: 'placement', summary: p.description, ref: `placement:${p.code}`, score });
+    }
+    for (const s of scopes) {
+        const score = matchScore(`${s.scope} ${s.description} ${s.module}`, query);
+        if (score > 0)
+            results.push({ title: s.scope, type: 'scope', summary: s.description, ref: `scope:${s.scope}`, score });
+    }
+    for (const m of methods) {
+        const score = matchScore(`${m.method} ${m.description} ${m.scope}`, query);
+        if (score > 0)
+            results.push({ title: m.method, type: 'method', summary: m.description, ref: `method:${m.method}`, score });
+    }
+    for (const c of categories) {
+        const score = matchScore(`${c.code} ${c.title}`, query);
+        if (score > 0)
+            results.push({ title: c.code, type: 'category', summary: c.title, ref: `category:${c.code}`, score });
+    }
+    for (const a of appTypes) {
+        const score = matchScore(`${a.type} ${a.title} ${a.description}`, query);
+        if (score > 0)
+            results.push({ title: a.type, type: 'app_type', summary: a.description, ref: `app_type:${a.type}`, score });
+    }
+    results.sort((a, b) => b.score - a.score);
+    return results.slice(0, maxLimit).map(({ score, ...rest }) => rest);
+}
+export const searchDocsSchema = z.object({
+    query: z.string().describe('Search query'),
+    limit: z.number().optional().default(10).describe('Max results (default 10, max 50)'),
+});
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@bitrix24/mcp-docs",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "MCP server for Bitrix24 REST API documentation — methods, scopes, placements, app types",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "mcp-bitrix24-docs": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}