chezmoi-documentation-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_USER_AGENT | No | Optional custom user agent for HTTP requests. If unset, the server uses its built-in user agent string | |
| FASTMCP_LOG_LEVEL | No | Log level for FastMCP (from example config) | ERROR |
| CHEZMOI_DOCUMENTATION_BASE_URL | No | Base URL for docs crawling | https://www.chezmoi.io/ |
| CHEZMOI_DOCUMENTATION_MAX_PAGES | No | Maximum number of pages to crawl for the search index | 350 |
| CHEZMOI_DOCUMENTATION_CONCURRENCY | No | Concurrent fetches while building the index | 10 |
| CHEZMOI_DOCUMENTATION_MAX_REDIRECTS | No | Maximum redirects to follow after validating each hop | 5 |
| CHEZMOI_DOCUMENTATION_MAX_URL_LENGTH | No | Maximum documentation URL length | 2048 |
| CHEZMOI_DOCUMENTATION_MAX_LIST_RESULTS | No | Upper bound for list_documentation_pages(limit=...) | 200 |
| CHEZMOI_DOCUMENTATION_MAX_QUERY_LENGTH | No | Maximum search or filter query length | 240 |
| CHEZMOI_DOCUMENTATION_RATE_LIMIT_CALLS | No | Maximum tool calls per rate-limit window | 30 |
| CHEZMOI_DOCUMENTATION_CACHE_TTL_SECONDS | No | Cached search index lifetime in seconds | 3600 |
| CHEZMOI_DOCUMENTATION_MAX_SECTION_COUNT | No | Maximum requested sections per call | 12 |
| CHEZMOI_DOCUMENTATION_MAX_DOCUMENT_CHARS | No | Maximum Markdown/text characters returned from a page or section | 120000 |
| CHEZMOI_DOCUMENTATION_MAX_RESPONSE_BYTES | No | Maximum HTML response size in bytes | 3145728 |
| CHEZMOI_DOCUMENTATION_MAX_SEARCH_RESULTS | No | Upper bound for search_documentation(limit=...) | 20 |
| CHEZMOI_DOCUMENTATION_MAX_SECTION_LENGTH | No | Maximum section heading match length | 120 |
| CHEZMOI_DOCUMENTATION_REQUEST_TIMEOUT_SECONDS | No | HTTP timeout per request in seconds | 20 |
| CHEZMOI_DOCUMENTATION_ALLOW_UNOFFICIAL_BASE_URL | No | Set to 'true' only for local development against a non-official docs mirror | |
| CHEZMOI_DOCUMENTATION_RATE_LIMIT_PERIOD_SECONDS | No | Rate-limit window length in seconds | 60 |
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 |
|---|---|
| search_documentationB | Search the official chezmoi documentation and return ranked matches. |
| read_documentationA | Read a chezmoi documentation page and convert its main content to Markdown. |
| read_sectionsB | Read selected sections from a chezmoi documentation page. |
| list_documentation_pagesB | List documentation pages discovered from the official chezmoi documentation site. |
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 4 tools
Each tool targets a distinct action: searching, reading a full page, reading specific sections, and listing available pages. There is no meaningful overlap between these operations.
All tool names follow a consistent verb_noun pattern (search_documentation, read_documentation, read_sections, list_documentation_pages), making the set predictable and easy to navigate.
Four tools is well-scoped for a documentation server, covering the essential tasks without unnecessary duplication. Each tool has a clear purpose and earns its place.
The tool surface covers the full workflow for documentation access: discovering pages, searching content, reading entire pages, and reading specific sections. No obvious gaps exist for the stated purpose.