Use this manual from an AI agent
Connect an AI agent to the Stevin manual over MCP to search it in natural language and read exact pages, or fetch the whole manual as plain text.
What is available#
| Access | Address | Use |
|---|---|---|
| MCP server | https://manual.stevinhq.com/mcp |
Search and read from an agent. No key is needed |
| Page index | /llms.txt |
One line per page: title, link and summary |
| Full text | /llms-full.txt |
The whole manual as plain text, with screenshots replaced by their descriptions |
| Status | /healthz |
Whether the service is up, and what it has loaded |
Connect over MCP#
Add the server to your MCP client. Reading needs no key:
{
"mcpServers": {
"stevin-manual": { "url": "https://manual.stevinhq.com/mcp" }
}
}
When an agent connects, it receives a map of the manual (each page's path, title and summary), so it can often go straight to the right page.
Tools#
| Tool | What it does | Main arguments |
|---|---|---|
search_manual |
Finds the pages that answer a question | query, limit, path_prefix, lang |
read_page |
Returns the exact text of a page or of one section | path, heading, lang, raw |
list_tree |
Lists the pages under a directory with their summaries | path, depth, lang |
Search in natural language#
search_manual takes a question, a symptom or a few keywords, in any language. The wording does not have to match the manual:
- "how do I stop it asking for approval every time"
- "bot not replying in Slack"
- "who can change permissions"
It returns up to limit pages (8 by default), each with its best-matching section: path, heading, anchor, url and a snippet. Use path_prefix (for example customize) to search one section of the manual.
Search finds the page. For exact wording, follow up with read_page.
Read exact content#
read_page returns the page's metadata (title, summary, tags, aliases), the list of its headings, and its Markdown content.
- Pass
headingto get one section only. - Pass
raw: trueto also get the complete source file, including the front matter. - Paths are forgiving:
customize/permissions,manual/customize/permissions.mdand an old path listed in a page'saliasesall resolve to the same page. A directory name returns its index page and the list of its children.
Screenshots are readable too#
Every screenshot in the manual is written as a figure with numbered callouts. read_page returns them under figures: the image address, a description of the image, and for each callout its position, label and explanation. An agent that cannot see images gets the same information a person reads in the legend under the screenshot.
Languages#
The manual is written in English. search_manual understands questions in other languages, and the lang argument selects a translation where one exists. When a page has not been translated, the English page is returned and the result says so.
For editors of the manual#
People who maintain the manual connect with an admin key and get additional tools for drafting changes. Drafts are reviewed by a person before they are published. This is described in the manual's repository, not here.