gramax-docportal-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GRAMAX_BASE_URL | Yes | URL портала документации | |
| GRAMAX_API_TOKEN | No | API-токен (Bearer); не нужен для публичных порталов |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| gramax_list_catalogsA | Получить список всех каталогов документации на портале Gramax. Возвращает таблицу с названиями и ID каталогов. |
| gramax_get_navigationA | Получить дерево навигации каталога: разделы, статьи, ссылки. Args: catalog_id: ID каталога (получить через gramax_list_catalogs) |
| gramax_searchA | Поиск по статьям документации Gramax. Args: query: Поисковый запрос (авто-раскладка RU/EN и транслитерация) catalog_name: Имя каталога для поиска (без него — поиск по всем каталогам) search_type: Тип поиска — "vector" для семантического, без значения — полнотекстовый language: Язык статей: "ru", "en", "es", "zh", "fr", "de", "ja" и др. ВНИМАНИЕ: на некоторых порталах непустое значение обнуляет выдачу (уходит как articlesLanguage). По умолчанию не задавать. resource_filter: Фильтр ресурсов: "without" — только статьи, "only" — только файлы, "with" — всё (по умолчанию) property_filter: Фильтр по свойствам статей. Примеры: {"op": "eq", "key": "Продукт", "value": "NSD"} {"op": "contains", "key": "Сегмент", "list": ["Enterprise", "SMB"]} {"op": "and", "filters": [ {"op": "eq", "key": "Тип контента", "value": "Кейс"}, {"op": "eq", "key": "Отрасль", "value": "Логистика"} ]} |
| gramax_get_articleA | Получить содержимое статьи в формате Markdown. Args: catalog_id: ID каталога article_id: ID статьи (получить через gramax_get_navigation или gramax_search) |
| gramax_ai_searchA | AI-поиск по документации Gramax: связный ответ с ссылками на источники. Использовать для вопросов в свободной форме, когда нужен сгенерированный ответ, а не список релевантных статей. Для списка результатов — gramax_search. Args: query: Вопрос на естественном языке. catalog_name: Имя каталога для контекста (без него — по всем). articles_language: Язык статей в индексе ("ru", "en", ...). По умолчанию не задаётся: на некоторых порталах непустое значение обнуляет выдачу. Задать явно или через GRAMAX_AI_ARTICLES_LANGUAGE, если портал этого требует. response_language: Язык генерируемого ответа. По умолчанию — из GRAMAX_AI_RESPONSE_LANGUAGE (ru). current_article: ID текущей статьи как контекст ("catalog_id/path"). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
gramax_search and gramax_ai_search have overlapping purposes (both search documentation), though descriptions clarify the difference between list results and generated answers. Other tools are distinct, but the search overlap is a notable ambiguity.
All tools follow a consistent gramax_verb_noun pattern (e.g., gramax_get_navigation, gramax_list_catalogs, gramax_search). The prefix is uniform and verbs are predictable.
5 tools for a documentation portal is well-scoped: navigation, listing, search, AI search, and article retrieval cover common needs without bloat.
Core lifecycle for documentation access is covered: list catalogs, get navigation, search, and retrieve articles. However, there is no tool to create, update, or delete content, which might be expected in a full docportal MCP, but the surface is sufficient for read-only use.