{
  "name": "wiki.yachts WebMCP API",
  "version": "1.0.0",
  "description": "Machine-readable API spec for wiki.yachts superyacht database. Enables programmatic agent interaction with verified yacht intelligence.",
  "base_url": "https://wiki.yachts/api",
  "endpoints": [
    {
      "name": "list_yachts",
      "method": "GET",
      "path": "/yachts",
      "description": "List all yachts in the directory, sorted by length descending.",
      "parameters": [
        {"name": "limit", "type": "integer", "default": 50, "in": "query"},
        {"name": "builder", "type": "string", "in": "query", "description": "Filter by builder slug"},
        {"name": "min_length", "type": "number", "in": "query"},
        {"name": "tier", "type": "string", "in": "query", "enum": ["free", "premium", "elite"], "default": "free"}
      ],
      "response": {
        "type": "object",
        "properties": {
          "yachts": {"type": "array", "items": {"$ref": "#/components/schemas/yacht"}}
        }
      }
    },
    {
      "name": "get_yacht",
      "method": "GET",
      "path": "/yachts/{slug}",
      "description": "Get full technical dossier for a single yacht by slug.",
      "parameters": [
        {"name": "slug", "type": "string", "in": "path"}
      ],
      "response": {"$ref": "#/components/schemas/yacht"}
    },
    {
      "name": "get_builder",
      "method": "GET",
      "path": "/builders/{slug}",
      "description": "Get builder profile with all yachts produced.",
      "parameters": [
        {"name": "slug", "type": "string", "in": "path"}
      ],
      "response": {"$ref": "#/components/schemas/builder"}
    },
    {
      "name": "list_tags",
      "method": "GET",
      "path": "/tags",
      "description": "List all tags and their associated yachts.",
      "response": {
        "type": "object",
        "properties": {
          "tags": {"type": "array", "items": {"$ref": "#/components/schemas/tag"}}
        }
      }
    }
  ],
  "components": {
    "schemas": {
      "yacht": {
        "type": "object",
        "properties": {
          "id": {"type": "string", "format": "uuid"},
          "name": {"type": "string"},
          "slug": {"type": "string"},
          "lengthMeters": {"type": "number"},
          "lengthFeet": {"type": "number"},
          "beamMeters": {"type": "number"},
          "draftMeters": {"type": "number"},
          "yearBuilt": {"type": "integer"},
          "hullType": {"type": "string"},
          "propulsion": {"type": "string"},
          "maxGuests": {"type": "integer"},
          "maxCrew": {"type": "integer"},
          "builder": {"$ref": "#/components/schemas/builder"},
          "exteriorDesignerName": {"type": "string"},
          "interiorDesignerName": {"type": "string"},
          "exteriorStyle": {"type": "string"},
          "construction": {"type": "string"},
          "hullMaterial": {"type": "string"},
          "rangeNautical": {"type": "string"},
          "cruiseSpeed": {"type": "string"},
          "maxSpeed": {"type": "string"},
          "description": {"type": "string"},
          "provenance": {"type": "string"}
        }
      },
      "builder": {
        "type": "object",
        "properties": {
          "id": {"type": "string", "format": "uuid"},
          "name": {"type": "string"},
          "slug": {"type": "string"},
          "country": {"type": "string"},
          "shortNote": {"type": "string"},
          "website": {"type": "string"}
        }
      },
      "designer": {
        "type": "object",
        "properties": {
          "id": {"type": "string", "format": "uuid"},
          "name": {"type": "string"},
          "slug": {"type": "string"},
          "roleFocus": {"type": "string"},
          "shortNote": {"type": "string"},
          "website": {"type": "string"}
        }
      },
      "tag": {
        "type": "object",
        "properties": {
          "id": {"type": "string", "format": "uuid"},
          "name": {"type": "string"},
          "slug": {"type": "string"}
        }
      },
      "list": {
        "type": "object",
        "properties": {
          "id": {"type": "string", "format": "uuid"},
          "title": {"type": "string"},
          "subtitle": {"type": "string"},
          "description": {"type": "string"},
          "priceCents": {"type": "integer"},
          "isPublished": {"type": "boolean"},
          "isMemberOnly": {"type": "boolean"},
          "sortOrder": {"type": "integer"},
          "slug": {"type": "string"}
        }
      }
    }
  }
}