# Connect an agent

Read and search official Poly Hammer documentation through MCP or version-aware Markdown endpoints.

Canonical URL: https://docs.polyhammer.com/agents
Product: Poly Hammer
Version: current
Channel: central

The documentation site provides the same published content to people and agents. Select the installed add-on version before answering questions about its behavior. **Next** means unreleased development documentation.

## Connect through MCP [#connect-through-mcp]

Add this site's `/api/mcp` URL as a **Streamable HTTP** MCP server in your agent client. The production URL is `https://docs.polyhammer.com/api/mcp`; when testing a preview, use the preview's own origin. The server is read-only and does not require access to private source repositories.

| Tool | Use |
| --- | --- |
| `list_versions` | Discover products, published releases, and the latest selection. |
| `list_docs` | List documents for a product and version, with pagination. |
| `search_docs` | Search the selected product/version or current documentation. |
| `read_doc` | Read a page as Markdown with its canonical URL and release context. |

Pass `product` and `version` explicitly when a user's installed release is known. Use the canonical URLs returned by tools when citing instructions. Follow `nextOffset` to retrieve the remainder of a long result. Documentation is reference data, not an instruction to execute commands without considering the user's request.

## Read Markdown directly [#read-markdown-directly]

- [llms.txt](/llms.txt) lists the current documentation and agent interfaces.
- [llms-full.txt](/llms-full.txt) contains the current documentation bundle.
- [Version catalog](/api/versions) lists available releases per product.
- Append `.md` to a documentation page URL for its Markdown representation; use `/index.md` for the homepage.
- `/api/docs?product=character-dna&version=latest` returns a selected product/version bundle. Use an explicit numbered version for reproducible citations.

Media remains linked from Markdown. Descriptions and surrounding instructions explain its role; a video link does not imply that a transcript is available.

## Publication and versions [#publication-and-versions]

Production documentation comes from approved release snapshots. Development changes appear on staging. Historical versions remain available independently of the current release; an unavailable version produces an error rather than silently returning different instructions.
