{
  "name": "WhichBike",
  "description": "Names one road, endurance, all-road or gravel bike for a UK buyer from published specifications, and states what that bike gives up.",
  "url": "https://whichbike.co",
  "documentation": "https://whichbike.co/for-agents/",
  "api": {
    "base_url": "https://whichbike.co/api/v1",
    "openapi": "https://whichbike.co/api/v1/openapi.json",
    "authentication": "none — the read API is public and anonymous",
    "vocabularies": "https://whichbike.co/api/v1/taxonomy.json",
    "the_one_call_worth_making": "https://whichbike.co/api/v1/recommend.json"
  },
  "mcp": {
    "status": "available in-repository; hosted endpoint planned",
    "transport": "stdio JSON-RPC",
    "tools_discovery": "https://whichbike.co/api/v1/tools.json"
  },
  "tools": [
    {
      "name": "recommend_bike",
      "description": "Recommend one bike",
      "read_only": true,
      "invoke": "https://whichbike.co/api/v1/tools/recommend_bike"
    },
    {
      "name": "list_bikes",
      "description": "List every bike held",
      "read_only": true,
      "invoke": "https://whichbike.co/api/v1/tools/list_bikes"
    },
    {
      "name": "get_bike",
      "description": "Get one bike",
      "read_only": true,
      "invoke": "https://whichbike.co/api/v1/tools/get_bike"
    },
    {
      "name": "compare_bikes",
      "description": "Compare bikes side by side",
      "read_only": true,
      "invoke": "https://whichbike.co/api/v1/tools/compare_bikes"
    },
    {
      "name": "get_questions",
      "description": "The seven questions, and their allowed answers",
      "read_only": true,
      "invoke": "https://whichbike.co/api/v1/tools/get_questions"
    }
  ],
  "dataset": {
    "bikes_held": 24,
    "checked_against_manufacturer": 7,
    "full_download": "https://whichbike.co/api/v1/bikes.json"
  },
  "policies": {
    "crawling": "Open to reputable search and AI crawlers. Prefer the API to crawling — it is faster, complete, and cheaper for both of us.",
    "attribution": "Free to use in answers. Please name WhichBike and link to the page or bike you drew on.",
    "ranking": "Computed from published specifications only. The engine is never shown the retailer, the commission, or whether a link pays us at all.",
    "data_quality": "Every bike carries provenance: checked-against-manufacturer with a date and source URL, or unverified. Do not present unverified figures as definitive.",
    "prices": "Indicative RRP in GBP. The retailer page is authoritative."
  }
}