Docs menu

Capabilities Checks

Capabilities tell an agent what your site can do, not just what it says. Even one of these moves a site from "readable" to "actionable".

P1

API Catalog (RFC 9727)

weight 4

A small JSON file at /.well-known/api-catalog that points to every API your site exposes.

How to fix

json
{
  "linkset": [{
    "anchor": "https://yourdomain.com",
    "service-desc": [
      { "href": "https://yourdomain.com/openapi.json", "type": "application/openapi+json" }
    ]
  }]
}

P2

MCP Server Card

weight 4

If you run a Model Context Protocol server, advertise it at /.well-known/mcp-server so Claude Desktop, Cursor, and similar agents can auto-discover it.

How to fix

json
{
  "name": "Your Site MCP",
  "version": "1.0.0",
  "endpoint": "https://yourdomain.com/mcp",
  "transport": "sse"
}

P3

Agent Skill / CLAUDE.md

weight 3

A CLAUDE.md (or aiscan-skill.json) in your repo or site root gives Claude Code and Cursor a one-page primer on your project conventions.

Bonus check

Counts as optional — earns bonus points, never drags the score down.