{
  "auth": {
    "agent_check_in": {
      "description": "POST /api/v1/agent/check-in with {agent_name, agent_description, purpose} to receive a 1-hour Bearer token",
      "header": "Authorization",
      "prefix": "Bearer ",
      "type": "api_key"
    }
  },
  "description": "AgentReady — Yellow Pages for AI Agents. Search, compare, and discover AI-agent-friendly websites scored on 27+ signals.",
  "name": "agentready",
  "schema_version": "1.0",
  "server": {
    "transport": "streamable-http",
    "url": "https://agentready.info/mcp"
  },
  "tools": [
    {
      "description": "Search the AgentReady directory for AI-agent-friendly sites by keyword",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/search"
      },
      "name": "search",
      "parameters": {
        "properties": {
          "page": {
            "description": "Page number (default 1)",
            "type": "integer"
          },
          "per_page": {
            "description": "Results per page (default 20, max 100)",
            "type": "integer"
          },
          "q": {
            "description": "Search query",
            "type": "string"
          }
        },
        "required": [
          "q"
        ],
        "type": "object"
      }
    },
    {
      "description": "Get detailed information about a site including its agent-readiness score and signal breakdown",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/sites/{slug}"
      },
      "name": "get_site",
      "parameters": {
        "properties": {
          "slug": {
            "description": "Site slug (URL-friendly identifier)",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      }
    },
    {
      "description": "List all sites in the directory with optional filters",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/sites"
      },
      "name": "list_sites",
      "parameters": {
        "properties": {
          "min_score": {
            "description": "Minimum agent-readiness score",
            "type": "integer"
          },
          "page": {
            "description": "Page number (default 1)",
            "type": "integer"
          },
          "per_page": {
            "description": "Results per page (default 20, max 100)",
            "type": "integer"
          },
          "tier": {
            "description": "Filter by tier: platinum, gold, silver, bronze, basic",
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    {
      "auth": "agent_check_in",
      "description": "Get site recommendations based on a use case description (requires agent check-in)",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/recommend"
      },
      "name": "recommend",
      "parameters": {
        "properties": {
          "limit": {
            "description": "Max results (default 10)",
            "type": "integer"
          },
          "use_case": {
            "description": "Description of what the agent needs",
            "type": "string"
          }
        },
        "required": [
          "use_case"
        ],
        "type": "object"
      }
    },
    {
      "description": "List all site categories in the directory",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/categories"
      },
      "name": "categories",
      "parameters": {
        "properties": {},
        "type": "object"
      }
    },
    {
      "auth": "agent_check_in",
      "description": "Get sites trending among AI agents by recent activity (requires agent check-in)",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/trending"
      },
      "name": "trending",
      "parameters": {
        "properties": {
          "limit": {
            "description": "Max results (default 10)",
            "type": "integer"
          },
          "period_hours": {
            "description": "Lookback period in hours (default 24)",
            "type": "integer"
          }
        },
        "type": "object"
      }
    },
    {
      "auth": "agent_check_in",
      "description": "Compare multiple sites side-by-side on agent-readiness metrics (requires agent check-in)",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/compare"
      },
      "name": "compare",
      "parameters": {
        "properties": {
          "slugs": {
            "description": "Site slugs to compare (1-5)",
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "required": [
          "slugs"
        ],
        "type": "object"
      }
    },
    {
      "description": "Get directory-wide statistics (total sites, tier distribution, average score)",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/stats"
      },
      "name": "stats",
      "parameters": {
        "properties": {},
        "type": "object"
      }
    },
    {
      "description": "Check the agent-readiness status of a site by slug",
      "endpoint": {
        "method": "GET",
        "path": "/api/v1/sites/{slug}"
      },
      "name": "check_status",
      "parameters": {
        "properties": {
          "slug": {
            "description": "Site slug (URL-friendly identifier)",
            "type": "string"
          }
        },
        "required": [
          "slug"
        ],
        "type": "object"
      }
    },
    {
      "description": "Submit a new site to the AgentReady directory for scoring",
      "endpoint": {
        "method": "POST",
        "path": "/api/v1/sites"
      },
      "name": "submit_site",
      "parameters": {
        "properties": {
          "category_id": {
            "description": "Category UUID (optional)",
            "type": "string"
          },
          "description": {
            "description": "Brief description of the site",
            "type": "string"
          },
          "name": {
            "description": "Display name for the site",
            "type": "string"
          },
          "url": {
            "description": "Full URL of the site to submit",
            "type": "string"
          }
        },
        "required": [
          "url",
          "name"
        ],
        "type": "object"
      }
    },
    {
      "description": "Register as an AI agent to receive an API key for authenticated endpoints",
      "endpoint": {
        "method": "POST",
        "path": "/api/v1/agent/check-in"
      },
      "name": "check_in",
      "parameters": {
        "properties": {
          "agent_description": {
            "description": "What your agent does",
            "type": "string"
          },
          "agent_name": {
            "description": "Name of your AI agent",
            "type": "string"
          },
          "purpose": {
            "description": "Why you're accessing AgentReady",
            "type": "string"
          }
        },
        "required": [
          "agent_name",
          "agent_description",
          "purpose"
        ],
        "type": "object"
      }
    }
  ],
  "url": "https://agentready.info"
}