Для AI-агентов: markdown этой страницы — /docs/mcp-platform.mdиндекс документации — /llms.txt
MCP: platform
Обновлено
MCP: platform
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
ack_skills
Confirm the downloaded TelegaFirst Agent Kit package with its pack_sha.
{
"description": "Confirm the downloaded TelegaFirst Agent Kit package with its pack_sha.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"pack_sha": {
"description": "Value for pack sha.",
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"pack_sha"
],
"type": "object"
},
"name": "ack_skills",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "write",
"scope": "platform:read",
"title": "Ack Skills"
}describe_tool
Return one tool's full descriptor (input schema, required scope and risk) by tool-id — use before the matching execute_admin proxy for exact parameters.
{
"description": "Return one tool's full descriptor (input schema, required scope and risk) by tool-id — use before the matching execute_admin proxy for exact parameters.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"tool_id": {
"description": "Value for tool id.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"tool_id"
],
"type": "object"
},
"name": "describe_tool",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": {},
"properties": {
"_meta": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"annotations": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"description": {
"type": "string"
},
"inputSchema": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"name": {
"type": "string"
},
"outputSchema": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"title": {
"type": "string"
}
},
"required": [
"name",
"description",
"inputSchema"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Describe Tool"
}execute_admin_read
Run a discovered read tool by tool_id + params with the same scope, rate-limit and validation as its dedicated tool. Write, destructive and money tools are refused; call their own typed tool or execute_admin_write when risk is write.
{
"description": "Run a discovered read tool by tool_id + params with the same scope, rate-limit and validation as its dedicated tool. Write, destructive and money tools are refused; call their own typed tool or execute_admin_write when risk is write.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"params": {
"additionalProperties": {},
"default": {},
"description": "Value for params.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"tool_id": {
"description": "Value for tool id.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"tool_id",
"params"
],
"type": "object"
},
"name": "execute_admin_read",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Execute Admin Read"
}execute_admin_write
Run a discovered write tool by tool_id + params with the same scope, rate-limit and validation as its dedicated tool. Read, destructive and money tools are refused; call their own typed tool when risk is destructive or money.
{
"description": "Run a discovered write tool by tool_id + params with the same scope, rate-limit and validation as its dedicated tool. Read, destructive and money tools are refused; call their own typed tool when risk is destructive or money.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"params": {
"additionalProperties": {},
"default": {},
"description": "Value for params.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"tool_id": {
"description": "Value for tool id.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"tool_id",
"params"
],
"type": "object"
},
"name": "execute_admin_write",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema"
},
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "write",
"scope": "platform:read",
"title": "Execute Admin Write"
}get_doc
Read a product documentation page by slug from search_docs. Returns title, contents and blocks. Args: slug, optional locale ru|en (ru). Returns found:false if unavailable for locale or audience.
{
"description": "Read a product documentation page by slug from search_docs. Returns title, contents and blocks. Args: slug, optional locale ru|en (ru). Returns found:false if unavailable for locale or audience.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"locale": {
"default": "ru",
"description": "Value for locale.",
"enum": [
"ru",
"en"
],
"type": "string"
},
"slug": {
"description": "Value for slug.",
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug",
"locale"
],
"type": "object"
},
"name": "get_doc",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Get Doc"
}get_skill
Read a TelegaFirst Agent Kit skill or one manifest-addressed file. Args: name; optional part path.
{
"description": "Read a TelegaFirst Agent Kit skill or one manifest-addressed file. Args: name; optional part path.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"name": {
"description": "Value for name.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"part": {
"description": "Value for part.",
"maxLength": 512,
"minLength": 1,
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"name": "get_skill",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Get Skill"
}load_domain
Inline every tool's full schema for one domain (e.g. catalog, orders) in the result; run read/write tools via their matching execute_admin proxy.
{
"description": "Inline every tool's full schema for one domain (e.g. catalog, orders) in the result; run read/write tools via their matching execute_admin proxy.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"domain": {
"description": "Value for domain.",
"maxLength": 64,
"minLength": 1,
"type": "string"
}
},
"required": [
"domain"
],
"type": "object"
},
"name": "load_domain",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"domain": {
"type": "string"
},
"tools": {
"items": {
"additionalProperties": {},
"properties": {
"_meta": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"annotations": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"description": {
"type": "string"
},
"inputSchema": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"name": {
"type": "string"
},
"outputSchema": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"title": {
"type": "string"
}
},
"required": [
"name",
"description",
"inputSchema"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"domain",
"tools"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Load Domain"
}search_admin_tools
Rank admin tools by keyword over their name + description; returns tool-ids you run via execute_admin_read or execute_admin_write. Start here when the advertised surface lacks a capability you need.
{
"description": "Rank admin tools by keyword over their name + description; returns tool-ids you run via execute_admin_read or execute_admin_write. Start here when the advertised surface lacks a capability you need.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"detail_level": {
"default": "name_desc",
"description": "Value for detail level.",
"enum": [
"name",
"name_desc",
"full_schema"
],
"type": "string"
},
"domain": {
"description": "Value for domain.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"intent": {
"description": "Value for intent.",
"maxLength": 400,
"minLength": 1,
"type": "string"
}
},
"required": [
"intent",
"detail_level"
],
"type": "object"
},
"name": "search_admin_tools",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"count": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"matches": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"type": "string"
},
"domain": {
"type": "string"
},
"idempotent": {
"type": "boolean"
},
"inputSchema": {
"additionalProperties": {},
"properties": {},
"type": "object"
},
"requiredScopes": {
"items": {
"enum": [
"sessions",
"orders",
"payments",
"catalog:read",
"catalog:write",
"entitlements",
"push",
"export",
"pull:users",
"pull:orders",
"pull:payments",
"dx",
"content:read",
"content:write",
"agents:read",
"agents:write",
"statuses:read",
"statuses:write",
"kb:read",
"kb:write",
"payments:config",
"legal:read",
"legal:write",
"broadcasts:read",
"broadcasts:write",
"chains:read",
"chains:write",
"marketing:read",
"marketing:write",
"storefront:read",
"storefront:write",
"team:read",
"team:write",
"quick-replies:read",
"quick-replies:write",
"events:read",
"events:write",
"integrations:read",
"integrations:write",
"client-config:read",
"client-config:write",
"onboarding:read",
"onboarding:write",
"dialogs:read",
"dialogs:write",
"topics:read",
"topics:write",
"identity:read",
"identity:write",
"credentials:read",
"credentials:write",
"domain:read",
"domain:write",
"site:read",
"site:write",
"pull:form_submissions",
"push:form_submissions",
"support:read",
"support:write",
"booking:read",
"booking:write",
"partner:read",
"partner:payout",
"orders:write",
"pricing:write",
"orders:status",
"analytics:read"
],
"type": "string"
},
"type": "array"
},
"risk": {
"enum": [
"read",
"write",
"destructive",
"money"
],
"type": "string"
},
"scope": {
"type": "string"
},
"tool_id": {
"type": "string"
}
},
"required": [
"tool_id",
"domain"
],
"type": "object"
},
"type": "array"
},
"query": {
"type": "string"
}
},
"required": [
"query",
"count",
"matches"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Search Admin Tools"
}search_docs
Search product docs. Returns slug, title and snippet; pass slug to get_doc. Args: query; optional limit 1–20 (5), locale ru|en (ru). No credential required; credentials include client guides.
{
"description": "Search product docs. Returns slug, title and snippet; pass slug to get_doc. Args: query; optional limit 1–20 (5), locale ru|en (ru). No credential required; credentials include client guides.",
"domain": "platform",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"limit": {
"default": 5,
"description": "Value for limit.",
"maximum": 20,
"minimum": 1,
"type": "integer"
},
"locale": {
"default": "ru",
"description": "Value for locale.",
"enum": [
"ru",
"en"
],
"type": "string"
},
"query": {
"description": "Value for query.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"query",
"limit",
"locale"
],
"type": "object"
},
"name": "search_docs",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"platform:read"
],
"risk": "read",
"scope": "platform:read",
"title": "Search Docs"
}