April 8, 2026 Guide

How to Score 100/100 on AgentReady: Complete Guide

AgentReady scores your website's AI agent readiness on a scale of 0 to 100 across six categories. Most websites score between 5 and 25 on their first scan. This guide walks you through every category, explains what's checked, and provides the exact code to fix each issue.

Time estimate: A typical website can go from ~15/100 to 100/100 in 1-2 hours. Static sites and SPAs are the fastest to fix. WordPress sites may need a plugin or theme edit.

1. WebMCP Compliance

Weight: 30%

This is the largest scoring category. AgentReady checks whether your forms have WebMCP attributes (declarative) and whether you register tools via the JavaScript API (imperative).

What's checked

Fix: Declarative approach

Before (0 points)
<form action="/search"> <input name="q" type="text"> <button type="submit"> Search </button> </form>
After (full points)
<form action="/search" tool-name="site-search" tool-description="Search products by keyword"> <input name="q" type="text" tool-param-description= "Search query text"> <button type="submit"> Search </button> </form>

Fix: Imperative approach

if (navigator.modelContext) { navigator.modelContext.registerTool({ name: "site-search", description: "Search products by keyword, category, or price range", parameters: { type: "object", properties: { query: { type: "string", description: "Search keywords" }, category: { type: "string", description: "Product category filter" }, maxPrice: { type: "number", description: "Maximum price in USD" } }, required: ["query"] }, handler: async ({ query, category, maxPrice }) => { const results = await fetch(`/api/search?q=${query}&cat=${category || ''}&max=${maxPrice || ''}`); return results.json(); } }); }

2. AI Discovery Protocols

Weight: 20%

AgentReady checks for the five standard AI discovery files. Each detected protocol adds points.

What's checked

You don't need all five for a good score, but having all five gets you maximum points. See our detailed guide on AI discovery protocols for implementation instructions.

Quick win: llms.txt

# Your Site Name ## About Brief description of your website and its purpose. ## Key Pages - / — Homepage - /products — Product catalog - /contact — Contact form - /api — Developer API documentation ## API - OpenAPI spec: /openapi.json - Base URL: https://yoursite.com/api/v1 ## Contact - Email: hello@yoursite.com

Place this at your site root as llms.txt. Takes under 5 minutes.

3. Semantic HTML Structure

Weight: 15%

Even without WebMCP, good semantic HTML helps AI agents understand your page. AgentReady checks your HTML quality from an AI-readability perspective.

What's checked

Before
<div class="form"> <div>Email</div> <input class="input-1"> <div>Message</div> <textarea></textarea> <div class="btn" onclick="send()"> Send </div> </div>
After
<form action="/contact" method="POST" tool-name="contact" tool-description="Send a message to our team"> <label for="email"> Email </label> <input id="email" name="email" type="email" required tool-param-description= "Your email address"> <label for="msg"> Message </label> <textarea id="msg" name="message" required tool-param-description= "Your message"> </textarea> <button type="submit"> Send </button> </form>

4. Crawlability & Robots

Weight: 15%

AI agents need permission to access your site. AgentReady checks whether your robots.txt and meta tags welcome AI crawlers.

What's checked

Optimal robots.txt

User-agent: * Allow: / # AI Crawlers — explicitly welcome User-agent: GPTBot Allow: / User-agent: ClaudeBot Allow: / User-agent: GoogleOther Allow: / User-agent: PerplexityBot Allow: / User-agent: Applebot-Extended Allow: / Sitemap: https://yoursite.com/sitemap.xml

See our complete guide to robots.txt for AI bots for details on each crawler.

5. Structured Data

Weight: 10%

JSON-LD structured data helps AI agents understand the type and context of your content.

What's checked

<script type="application/ld+json"> { "@context": "https://schema.org", "@type": "WebApplication", "name": "Your App Name", "description": "What your app does in one sentence", "url": "https://yoursite.com", "applicationCategory": "BusinessApplication", "operatingSystem": "Web", "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" } } </script>

6. Meta & OpenGraph

Weight: 10%

Proper meta tags give AI agents context about your page before they even parse the DOM.

What's checked

<head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <title>Your Page Title — Your Brand</title> <meta name="description" content="Clear, concise description of what this page does. 150-160 characters."> <meta property="og:title" content="Your Page Title"> <meta property="og:description" content="Same or similar description."> <meta property="og:type" content="website"> <meta property="og:url" content="https://yoursite.com/page"> <meta name="twitter:card" content="summary_large_image"> <link rel="canonical" href="https://yoursite.com/page"> </head>

Putting It All Together: The 100/100 Checklist

  1. Add WebMCP attributes to every <form> and <input> on your pages
  2. Register tools via navigator.modelContext.registerTool() for complex interactions
  3. Create llms.txt and agents.json at your site root
  4. Add A2A Agent Card at /.well-known/agent.json
  5. Add MCP Discovery at /.well-known/mcp.json (if applicable)
  6. Generate or link OpenAPI spec (if you have an API)
  7. Fix semantic HTML — labels, names, types, required attributes
  8. Configure robots.txt — allow AI crawlers, reference sitemap
  9. Add JSON-LD structured data with appropriate Schema.org types
  10. Complete meta tags — title, description, OG tags, canonical URL

Pro tip: After making changes, use AgentReady's rescan feature to verify your score immediately. The Agent Simulator tab shows exactly how an AI agent sees your page before and after your fixes.

Common Mistakes That Cost Points

Ready to hit 100?

Scan your site now and see exactly which fixes you need. AgentReady generates the code for you.

Scan Your Site Free

Related Articles