Для AI-агентов: markdown этой страницы — /docs/mcp-topics.mdиндекс документации — /llms.txt
MCP: topics
Обновлено
MCP: topics
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
create_forum_topic
Create an arbitrary operator forum topic in one tenant supergroup. Returns its tenant-scoped sequence number.
{
"description": "Create an arbitrary operator forum topic in one tenant supergroup. Returns its tenant-scoped sequence number.",
"domain": "topics",
"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"
},
"supergroup_kind": {
"description": "Value for supergroup kind.",
"enum": [
"open_lines",
"settings",
"operations"
],
"type": "string"
},
"title": {
"description": "Value for title.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"required": [
"supergroup_kind",
"title"
],
"type": "object"
},
"name": "create_forum_topic",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"topics:write"
],
"risk": "write",
"scope": "topics:write",
"title": "Create Forum Topic"
}delete_forum_topic_message
Delete a message in an arbitrary operator forum topic. A deleted topic returns TOPIC_DELETED_IN_MESSENGER.
{
"description": "Delete a message in an arbitrary operator forum topic. A deleted topic returns TOPIC_DELETED_IN_MESSENGER.",
"domain": "topics",
"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"
},
"message_id": {
"description": "Value for message id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"topic_seq_num": {
"description": "Value for topic seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"topic_seq_num",
"message_id"
],
"type": "object"
},
"name": "delete_forum_topic_message",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"topics:write"
],
"risk": "destructive",
"scope": "topics:write",
"title": "Delete Forum Topic Message"
}edit_forum_topic_message
Edit text, caption, or buttons of a message in an arbitrary operator forum topic. A deleted topic returns TOPIC_DELETED_IN_MESSENGER.
{
"description": "Edit text, caption, or buttons of a message in an arbitrary operator forum topic. A deleted topic returns TOPIC_DELETED_IN_MESSENGER.",
"domain": "topics",
"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"
},
"buttons": {
"description": "Value for buttons.",
"items": {
"description": "Value for buttons item.",
"items": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"type": {
"const": "url",
"description": "Value for type.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"type",
"text",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"callback_data": {
"description": "Value for callback data.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"type": {
"const": "callback",
"description": "Value for type.",
"type": "string"
}
},
"required": [
"type",
"text",
"callback_data"
],
"type": "object"
}
],
"description": "Value for buttons item item."
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"maxItems": 10,
"type": "array"
},
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"message_id": {
"description": "Value for message id.",
"pattern": "^[1-9]\\d*$",
"type": "string"
},
"text": {
"description": "Value for text.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"topic_seq_num": {
"description": "Value for topic seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"topic_seq_num",
"message_id"
],
"type": "object"
},
"name": "edit_forum_topic_message",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"topics:write"
],
"risk": "write",
"scope": "topics:write",
"title": "Edit Forum Topic Message"
}list_forum_topics
List the current tenant’s arbitrary operator forum topics. Each topic is addressed by its tenant-scoped sequence number.
{
"description": "List the current tenant’s arbitrary operator forum topics. Each topic is addressed by its tenant-scoped sequence number.",
"domain": "topics",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "list_forum_topics",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"topics:read"
],
"risk": "read",
"scope": "topics:read",
"title": "List Forum Topics"
}send_to_forum_topic
Send text or one attachment (maximum 50 MiB) to an arbitrary operator forum topic. Uses a service bot. A topic deleted in Telegram returns TOPIC_DELETED_IN_MESSENGER.
{
"description": "Send text or one attachment (maximum 50 MiB) to an arbitrary operator forum topic. Uses a service bot. A topic deleted in Telegram returns TOPIC_DELETED_IN_MESSENGER.",
"domain": "topics",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"attachment": {
"additionalProperties": false,
"description": "Value for attachment.",
"properties": {
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"file_token": {
"description": "Value for file token.",
"maxLength": 1024,
"minLength": 1,
"type": "string"
},
"size_bytes": {
"description": "Value for size bytes.",
"exclusiveMinimum": 0,
"maximum": 52428800,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"file_token",
"size_bytes"
],
"type": "object"
},
"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"
},
"buttons": {
"description": "Value for buttons.",
"items": {
"description": "Value for buttons item.",
"items": {
"anyOf": [
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"type": {
"const": "url",
"description": "Value for type.",
"type": "string"
},
"url": {
"description": "Value for url.",
"format": "uri",
"type": "string"
}
},
"required": [
"type",
"text",
"url"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for buttons item item option.",
"properties": {
"callback_data": {
"description": "Value for callback data.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"text": {
"description": "Value for text.",
"maxLength": 64,
"minLength": 1,
"type": "string"
},
"type": {
"const": "callback",
"description": "Value for type.",
"type": "string"
}
},
"required": [
"type",
"text",
"callback_data"
],
"type": "object"
}
],
"description": "Value for buttons item item."
},
"maxItems": 8,
"minItems": 1,
"type": "array"
},
"maxItems": 10,
"type": "array"
},
"text": {
"description": "Value for text.",
"maxLength": 4096,
"minLength": 1,
"type": "string"
},
"topic_seq_num": {
"description": "Value for topic seq num.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"topic_seq_num"
],
"type": "object"
},
"name": "send_to_forum_topic",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"topics:write"
],
"risk": "write",
"scope": "topics:write",
"title": "Send To Forum Topic"
}