MCP server

pagers-mcp is a stdio Model Context Protocol server that exposes pagers' operations as tools — build sites, list pages, render Markdown, inspect the link graph — so MCP-capable agents (and other clients) can drive the generator directly.

Setup

Point your MCP client at the binary:

{
  "mcpServers": {
    "pagers": {
      "command": "pagers-mcp"
    }
  }
}

Install it with the same scripts as pagers (install-local.sh, install.sh, or cargo install --path crates/pagers-mcp).

Tools

All tools return pretty-printed JSON; failures surface as MCP errors.

Tool	Parameters	Returns
`pagers_build`	`content_dir?`, `output_dir?`	Build summary (pages, assets, graph)
`pagers_list_pages`	`content_dir?`	Discovered pages: title, url, source, draft/order/label
`pagers_render_markdown`	`markdown`, `source_path?`	Rendered HTML, outline, title, link edges
`pagers_site_graph`	`content_dir?`	Nodes/edges/stats without building
`pagers_site_config`	`content_dir?`	Resolved config (title, basePath, theme, footer)

content_dir/output_dir default to docs/dist, matching the CLI.

Not exposed

serve and init are intentionally absent — a long-running server and an interactive scaffold don't fit a request/response tool model.