Loading…
Friday August 14, 2026 14:35 - 15:00 KST
When an MCP server exposes documentation.search and documentation.fetch, its docs site quietly acquires a second reader: the agent. And the agent is not a small human. Humans want narrative tutorials; agents want flat, deduplicated, single-source-of-truth pages. Humans skim; agents tokenize. Humans tolerate ambiguity; agents hallucinate from it.

This talk is a field report from rewriting an MCP server's documentation to serve both audiences from one markdown source. Concrete before/after pages, real agent traces from the SuprSend MCP server (used as a case study not a pitch), the five rewrite rules that actually moved the needle on hallucination rates, and the surprising downstream effect: the human-facing docs got better too. Every rule generalizes to any MCP server with public docs.

Closes with two open questions the audience is invited to argue back at: should agent-facing docs be a separate channel? Should MCP add a "documentation" primitive at the protocol level?

For DevRels, technical writers, and MCP server maintainers who already exposed their docs as a tool or are about to.
Speakers
avatar for Jyoti Bisht

Jyoti Bisht

DevRel Engineer, Independent

avatar for Tanisha Sharma

Tanisha Sharma

AI DevRel Engineer, Bolna
Tanisha is an AI Developer Advocate specializing in production multi-agent systems. Also a private pilot. Both pursuits taught her the same lesson: know when to trust automation and when human judgment matters most.
Friday August 14, 2026 14:35 - 15:00 KST
Orchid 1

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Share Modal

Share this link via

Or copy link