# MCP: platform

Source: <https://telegafirst.com/docs/mcp-platform>
Locale: ru
releaseGitSha: c9a428d902de0b479a981e43774f38b9ec077ed7
sourceContentDigest: 208644ecfb0dc190ce4c78a1cc5f0599a43210c9158bee51387fd940f91453a8
Version: 1

# MCP: platform

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required\_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load\_domain/describe\_tool и существующий meta-dispatch описаны в [MCP-руководстве](https://telegafirst.com/docs/mcp-guide). [Scopes и права](https://telegafirst.com/docs/scopes-and-permissions) применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

## ack\_skills

Confirm the downloaded TelegaFirst Agent Kit package with its pack\_sha.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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.

```json
{
  "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"
}
```