Loading ToolBench

Reading the current corpus…

telegram-rest-gateway MCP server · C · ToolBench

← Browse

telegram-rest-gateway

github.com/moveeeax/telegram-rest-gateway

MCP server exposing telegram-rest-gateway as agent tools (Telegram user account)

2026-07-28+STDIO12 tools

66/100

Definition Quality73

Protocol Readiness50

SupportabilityNot measured-

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence · evidence: stateless requests

Current-spec patterns detected

Summary

12 tools with consistent verb_noun naming (telegram_get_*, telegram_send_*, etc.). All tools have descriptions in Russian, ranging 50 - 200 chars. Input schemas present for all tools with type definitions and constraints (enums, min/max). However, descriptions lack English translations, making them inaccessible to non-Russian-speaking agents. Parameter descriptions are sparse, many lack context on format, dependencies, or recovery guidance. Output schemas are not documented. Error handling is absent from tool definitions. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels (READ_ONLY, WRITE, DESTRUCTIVE). Idempotency key on telegram_send_message is good, but not reflected in schema annotations.

Tools (12)

telegram_delete_messagesdestructiveauthsource verified75/100

Удалить сообщения. revoke=true (default) — у всех участников; false — только у себя.

telegram_edit_messagewriteauthsource verified70/100

Отредактировать текст своего сообщения.

telegram_forward_messageswriteauthsource verified75/100

Переслать сообщения из одного чата в другой.

telegram_get_chatread onlyauthsource verified68/100

Карточка чата по id (тип, название). Работает для чатов, известных клиенту (из списка/resolve).

telegram_get_chatsread onlyauthsource verified75/100

Список чатов аккаунта (главный список, по порядку). Возвращает id (строки!), title, type, unread_count.

telegram_get_historyread onlyauthsource verified75/100

История сообщений чата, от новых к старым. Медиа-сообщения содержат file_id — его можно скачать telegram_download_file.

telegram_get_me

Issues (5)

CRITICALtool-description ↗

All tool descriptions are in Russian only. Non-Russian-speaking agents cannot understand when or why to select tools. Descriptions must be in English for LLM accessibility.

telegram_get_metelegram_get_chatstelegram_get_historytelegram_send_messagetelegram_edit_messagetelegram_delete_messagestelegram_forward_messagestelegram_reacttelegram_search_livetelegram_resolve_usernametelegram_get_chattelegram_get_user

HIGHresponse-shaper ↗

No output schemas documented. LLMs cannot plan downstream calls or extract required fields (e.g., chat_id from telegram_get_chats for use in telegram_send_message). Responses must be formally specified.

telegram_get_metelegram_get_chatstelegram_get_historytelegram_search_livetelegram_resolve_usernametelegram_get_chattelegram_get_user

Recommendations

Translate all tool and parameter descriptions to English. Use clear, LLM-optimized language (50 - 200 chars per tool, 50 - 100 chars per parameter). Example: 'Get the authenticated user's profile (name, phone, premium status).' instead of 'Карточка пользователя: имя, @username, телефон, онлайн-статус, premium.'
Document output schemas for all tools. Specify returned fields, types, and structure. Example for telegram_get_chats: '{"chats": [{"id": string, "title": string, "type": "private"|"group"|"supergroup"|"channel", "unread_count": number}], "total": number}'
Add tool annotations to all tools. Use readOnlyHint=true for telegram_get_*, destructiveHint=true for telegram_delete_messages, idempotentHint=true for telegram_send_message (when idempotency_key is provided). This enables agents to reason about safety.
Enhance parameter descriptions with format and dependency hints. Example: 'chat_id (string): Telegram chat identifier. Numeric string (e.g., "123456789") or username (e.g., "@mychannel"). If you only have a username, call telegram_resolve_username() first.'
Add error recovery guidance to tool descriptions. Example for telegram_send_message: 'Returns 202 (temporary ID) on success. If chat_id is invalid, call telegram_resolve_username() to look up the ID. Markdown mode requires escaping special characters (_, *, [, ], etc.) with backslash.'

Score history

Overall score trend

First recorded score · v2 rubric

66/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-23	C	66	2026-07-28+	v2