К содержанию
TelegaFirst

Для AI-агентов: markdown этой страницы — /docs/mcp-identity.mdиндекс документации — /llms.txt

MCP: identity

Обновлено

MCP: identity

Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.

get_active_bot

Return the bot this session is currently acting as: { slug, bot_username }.

{
  "description": "Return the bot this session is currently acting as: { slug, bot_username }.",
  "domain": "identity",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "get_active_bot",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "identity:read"
  ],
  "risk": "read",
  "scope": "identity:read",
  "title": "Get Active Bot"
}

list_accessible_bots

List the bots you can act as (owned or operated): slug, bot_username, name. Use before switch_active_bot.

{
  "description": "List the bots you can act as (owned or operated): slug, bot_username, name. Use before switch_active_bot.",
  "domain": "identity",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "additionalProperties": false,
    "properties": {},
    "type": "object"
  },
  "name": "list_accessible_bots",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "identity:read"
  ],
  "risk": "read",
  "scope": "identity:read",
  "title": "List Accessible Bots"
}

switch_active_bot

Switch your active bot to slug (one of list_accessible_bots), then re-read tools/list. Moves every connection of yours and the bot you see in the platform bot chat.

{
  "description": "Switch your active bot to slug (one of list_accessible_bots), then re-read tools/list. Moves every connection of yours and the bot you see in the platform bot chat.",
  "domain": "identity",
  "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"
      },
      "slug": {
        "description": "Value for slug.",
        "maxLength": 128,
        "minLength": 1,
        "type": "string"
      }
    },
    "required": [
      "slug"
    ],
    "type": "object"
  },
  "name": "switch_active_bot",
  "outputSchema": null,
  "platform_version": "1.0.19",
  "required_scopes": [
    "identity:write"
  ],
  "risk": "write",
  "scope": "identity:write",
  "title": "Switch Active Bot"
}