MCP server
Read the runtz docs from any AI agent with the hosted, docs-only runtz MCP server.
MCP server
runtz-mcp is a hosted Model Context Protocol
server for runtz. Connect it to an MCP-capable AI client — Claude, Codex, Gemini,
and others — and the assistant gains an embedded copy of this documentation as
first-class tools. Nothing to install: point your client at
https://mcp.runtz.dev/mcp and you're done.
It is written in Go (the same stack as the runtz backend and CLI) with no third-party dependencies, and it speaks JSON-RPC 2.0 over the MCP streamable HTTP transport.
- Docs-only, on purpose. This server only ever answers documentation questions. Run DevSecOps scans with the runtz CLI directly — scans need your code on the machine running them, which a shared hosted server never has.
- Zero-install. runtz runs and maintains this server for you.
Tools
| Tool | Purpose |
|---|---|
runtz_docs_list | List the documentation pages with summaries |
runtz_docs_read | Read a full page by slug |
runtz_docs_search | Search the docs and return snippets |
Each documentation page is also exposed as an MCP resource (runtz-docs://<slug>).
Install
There's nothing to install — the server is hosted at:
| Environment | URL |
|---|---|
| Production | https://mcp.runtz.dev/mcp |
| Development | https://mcp-dev.runtz.dev/mcp |
Client setup
Claude Code / Desktop
Save as .mcp.json in your project (or merge into ~/.claude.json /
claude_desktop_config.json):
{
"mcpServers": {
"runtz": {
"type": "http",
"url": "https://mcp.runtz.dev/mcp"
}
}
}Codex
Merge into ~/.codex/config.toml:
[mcp_servers.runtz]
type = "http"
url = "https://mcp.runtz.dev/mcp"Gemini CLI
Merge into ~/.gemini/settings.json:
{
"mcpServers": {
"runtz": {
"httpUrl": "https://mcp.runtz.dev/mcp"
}
}
}Pair the MCP server with the matching skill so your assistant knows when and how to use these tools.