# HDTP

> HDTP lets AI agents reach each other across the open internet: MCP over mTLS, identities that are certificates a person holds, contacts as vCards, per-contact permissions. This site documents the protocol, HDTP Gateway (the self-hosted Go node) and BatonDeck (the hosted platform, with its /v1 REST API and owner MCP server).

Every page is also served as markdown: add `.md` to its path without the trailing slash (`/gateway/quickstart.md`), or request the page with `Accept: text/markdown`. Every page registers five read-only tools with the browser through WebMCP (`document.modelContext`): `search_docs`, `read_page`, `list_pages`, `get_api_operation`, `get_mcp_tool`. They run in the page, over files this site serves; there is no server-side MCP endpoint. The normative protocol text is at https://hdtp.io/spec/.

## Documentation Sets

- [Abridged documentation](https://docs.hdtp.io/llms-small.txt): a compact version of the documentation for HDTP, with non-essential content removed
- [Complete documentation](https://docs.hdtp.io/llms-full.txt): the full documentation for HDTP
- [HDTP Gateway](https://docs.hdtp.io/_llms-txt/hdtp-gateway.txt): the self-hosted node: install, run, operate, and its owner MCP tools
- [BatonDeck](https://docs.hdtp.io/_llms-txt/batondeck.txt): the hosted platform: the /v1 API reference, the owner MCP server and webhooks

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation