# Improved agent experience with llms.txt and content negotiation

DevFeed: [Improved agent experience with llms.txt and content negotiation](<https://devfeed.tech/articles/improved-agent-experience-with-llms-txt-and-content-negotiation-30997.md>)

Original publisher: [Read original article](<https://www.mintlify.com/blog/context-for-agents>)

Author: Peri Langlois

Published: 2026-01-29T00:00:00Z

Content type: article

Language: en

Sources: [Mintlify Blog](<https://devfeed.tech/sources/mintlify-blog.md>)

Topics: [Documentation](<https://devfeed.tech/topics/documentation.md>), [HTTP](<https://devfeed.tech/topics/http.md>), [Markdown](<https://devfeed.tech/topics/markdown.md>), [Claude Code](<https://devfeed.tech/topics/claude-code.md>), [cursor](<https://devfeed.tech/topics/cursor.md>)

Tags: [best-practices](<https://devfeed.tech/tags/best-practices.md>), [claude-code](<https://devfeed.tech/tags/claude-code.md>), [cursor](<https://devfeed.tech/tags/cursor.md>), [documentation](<https://devfeed.tech/tags/documentation.md>), [http](<https://devfeed.tech/tags/http.md>), [markdown](<https://devfeed.tech/tags/markdown.md>)

## AI overview

Mintlify describes using content negotiation to serve Markdown to agents while continuing to serve HTML to browsers. The post also explains moving llms.txt guidance to the top of Markdown pages and advertising documentation indexes through HTTP headers to improve discoverability and reduce the tokens agents consume.

## Source excerpt

Clear, accessible documentation is a prerequisite for agents to successfully perform real world tasks. By improving llms.txt discoverability, we reduce friction in how agents find and consume the documentation they depend on.