Overview
Heretto Deploy MCP is an open source MCP wrapper for Heretto’s Deploy API.
Deploy MCP helps you connect your published Heretto deployment(s), with its governed and traversable content, into tools like chatbots and AI agents. Using structured DITA behind the Deploy API, every answer carries a granular path to a verifiable source, semantically rich and typed content, an audience, a locale, portal deep-links, metadata and more.
Connect an AI assistant — Claude, Cursor, ChatGPT, and others — to your Heretto powered documentation. Once it’s set up, you can ask the assistant questions in plain language and it will search your published Heretto content, read the relevant topics, and answer with links back to your portal instead of guessing or using non-authoratative information on the web or in it’s training model.
Core features
- Grounded retrieval. Answers are built from your actual published deployment content, not the model’s training data.
- Source provenance. Every answer can cite the exact topics it used and link straight to them in your portal.
- Full-text search. Query the whole deployment and get ranked results with titles, content type, breadcrumb trail, and last-modified dates.
- Structure-aware browsing. Walk the content hierarchy (the table of contents) and open any topic by its path.
- Audience scoping. Restrict what the assistant can see to a single audience, so internal-only content never surfaces in a customer-facing answer.
- Direct links back to source material. If configured, Deploy MCP can send your authors directly to the content in your Heretto CCMS that it’s found on your Deploy Portal. This gives authors an extremely fast way to analyze published content and make suggested changes.
- Portal link generation. Turn any content path into a clickable portal URL.
- Serve localized versions. Users can set their locale and deploy will serve content in their native language (provided translations have been published)
- Find what has changed since a specific date. Quickly get back a list of topics which have changed, get summaries of content and updates.
- Serve Developer Docs and OpenAPI specs directly into codeing agents
- MCP-native. Runs as a standard MCP server, so it plugs into any MCP-compatible client.
- Plus deployment metadata, locale and change-tracking queries, source-file listing, and published OpenAPI spec retrieval.
Examples
TODO: Link to EXAMPLES.md for examples and demos
License
MIT