hermes-docs-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | Hosting-provided port for HTTP transports, used as an alternative to HERMES_DOCS_MCP_PORT. | |
| HERMES_DOCS_MCP_TTL | No | Number of seconds after which the cache is considered stale. | 86400 |
| HERMES_DOCS_MCP_HOST | No | Bind host for HTTP transports. | 127.0.0.1 |
| HERMES_DOCS_MCP_PORT | No | Bind port for HTTP transports. The hosting-provided PORT variable is also read. | 8020 |
| HERMES_DOCS_MCP_OFFLINE | No | Set to 1 to never access the network and work only from the cache. | |
| HERMES_DOCS_MCP_TIMEOUT | No | HTTP timeout in seconds. | 30 |
| HERMES_DOCS_MCP_BASE_URL | No | Source of documentation exports. Only https is allowed; http is accepted only for loopback connections. | https://hermes-agent.nousresearch.com |
| HERMES_DOCS_MCP_CACHE_DIR | No | Directory where the documentation cache is stored. Can be pre-populated. | ~/.cache/hermes-docs-mcp |
| HERMES_DOCS_MCP_TRANSPORT | No | Transport mode: stdio, sse, or streamable-http. | stdio |
| HERMES_DOCS_MCP_PUBLIC_URL | No | External URL of the deployed instance. When set, icons are served by link; otherwise they are inlined. On Render it is set automatically. | RENDER_EXTERNAL_URL |
| HERMES_DOCS_MCP_MIN_REFRESH | No | Minimum interval in seconds between documentation refreshes. | 300 |
| HERMES_DOCS_MCP_ALLOW_PUBLIC_BIND | No | Set to 1 to allow binding HTTP transports outside loopback. This is an intentional public exposure. |
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": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| searchA | Поиск по официальной документации Hermes Agent (228 страниц, на английском). Зови этот инструмент на любой вопрос про Hermes Agent — установку, настройку, конфигурацию, инструменты, память, скиллы, MCP, мессенджеры, безопасность, развёртывание. Примеры: «как поставить Hermes на сервер», «что писать в SOUL.md», «как подключить Telegram», «какие есть режимы approvals», «чем skills отличаются от memory», «как настроить cron», «как запустить в Docker», «какие провайдеры моделей поддерживаются», «как дать агенту доступ к MCP». Документация англоязычная, а поиск лексический — формулируй запрос по-английски, даже если пользователь спросил по-русски («как подключить телеграм» → «connect telegram bot gateway»). Отвечать пользователю можно на его языке. Возвращает фрагменты страниц с адресом id, заголовком, ссылкой и текстом. Отвечай по ним и ссылайся на url; за полной страницей вызывай fetch. |
| fetchA | Возвращает страницу документации Hermes Agent целиком в markdown. Принимает id из результатов search — и путь страницы («user-guide/features/mcp»), и id фрагмента с суффиксом («…/mcp#3»), и полный URL страницы документации. Страницы бывают объёмными, поэтому зови только когда фрагментов из search действительно не хватает, а не на каждый результат. |
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 2 tools
The two tools have clearly distinct purposes: search returns relevant fragments from the documentation, while fetch retrieves a full page in markdown. Their descriptions explicitly state when to use each, leaving no ambiguity for an agent.
Both tool names are single, simple verbs (search, fetch) that directly describe their actions. This consistent minimalist pattern is predictable and easy to remember.
With only 2 tools, the server feels slightly thin for a documentation MCP, though the scope is narrow and focused on search + retrieval. According to the calibration, 1-2 tools is borderline, but each tool clearly earns its place.
The pair of search and fetch covers the core documentation lookup workflow well: find relevant fragments, then fetch the full page if needed. A minor gap is the lack of direct browsing or listing of documentation sections, but agents can work around this via search.