AgentLitmus
Is your site ready for agents?
The litmus test for the agent web.
Agents are becoming the web's biggest readers. Find out what they see when they visit you.
What we check, in plain English
AgentLitmus scores 10 signals across three areas, for 100 points total.
Guides for agents
Files and structure that help an AI agent understand your site without guessing.
- llms.txt12 pts
Checks for a /llms.txt file: a plain-text guide that points AI agents to your most important pages. Awards points for the file existing, having a title and markdown links, and those links pointing to your own domain.
- Renders Without JS12 pts
Checks how much real content is in the raw HTML response, before any JavaScript runs. Awards points for visible text length, a healthy text-to-HTML ratio, and signs of server-side rendering.
- Semantic HTML10 pts
Examines your homepage's HTML structure: a single <h1>, headings that don't skip levels, landmark elements like main/nav/header/footer, and semantic lists or tables instead of div-only layouts.
- AGENTS.md10 pts
Checks for an /AGENTS.md file describing how AI coding agents should work with your project. Awards points for the file existing and being organized with at least two markdown headings.
44 points total
Machine-readable content
Structured data and APIs that let agents read your content directly, not just your pages.
- Structured Data (JSON-LD)14 pts
Looks for JSON-LD <script> tags on your homepage. Awards points for the tags being present, parsing as valid JSON, and declaring a recognized schema.org @type like Organization, Product, Article, or WebSite.
- Machine-Readable Endpoint10 pts
Looks for a machine-readable API surface: a /.well-known/mcp.json manifest (strongest), an /openapi.json spec, or a visible link to API docs on the homepage. The best one found counts, not the sum.
24 points total
Access & trust
Signals that tell agents whether they're welcome, and how current your content is.
- Agent Access Policy10 pts
Reads your /robots.txt to see whether it exists, whether it blanket-blocks all crawlers, and whether it explicitly addresses known AI agent user-agents like GPTBot, ClaudeBot, or Google-Extended.
- Content Freshness8 pts
Checks whether your sitemap.xml has <lastmod> dates and whether your homepage shows a parseable date (modified time, <time> element, or visible date) within the last 12 months.
- Sitemap URL Quality8 pts
Checks that /sitemap.xml exists and parses, then samples up to 20 URLs to see whether they use descriptive, readable words rather than opaque IDs or hashes.
- Image Alt Text6 pts
Samples up to 30 <img> elements on your homepage and checks how many have non-empty alt text, so agents (and screen readers) understand what images convey.
32 points total
Page last updated .