{
  "name": "YardStock NZ Vehicle Listings",
  "description": "Live used-car stock on named New Zealand dealer yards, read from those dealers' own websites. Search by make, model, year, price, city and fuel across roughly 30,000 live listings from 200+ dealer yards New Zealand-wide, and resolve a single listing by its URL. Not Trade Me, not AutoTrader, not a national registry roster: every response states which groups are covered and what is missing.",
  "supportedInterfaces": [
    {
      "url": "https://stock.yardstock.nz/mcp",
      "protocolBinding": "https://modelcontextprotocol.io/specification/basic/transports#streamable-http",
      "protocolVersion": "1.0"
    }
  ],
  "provider": {
    "organization": "YardStock",
    "url": "https://yardstock.nz"
  },
  "version": "1.0.0",
  "documentationUrl": "https://stock.yardstock.nz/llms.txt",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "extendedAgentCard": false
  },
  "defaultInputModes": ["text/plain", "application/json"],
  "defaultOutputModes": ["application/json", "text/plain"],
  "skills": [
    {
      "id": "coverage",
      "name": "Report dealer-yard coverage",
      "description": "List the New Zealand dealer groups currently in the index with their live listing counts and cities, plus what is explicitly not included. Call this before making any claim about the wider NZ market.",
      "tags": ["new-zealand", "used-cars", "coverage", "dealers"],
      "examples": [
        "Which NZ dealer groups can you actually see stock for?",
        "How fresh is your vehicle data?"
      ],
      "outputModes": ["application/json"]
    },
    {
      "id": "search-stock",
      "name": "Search live dealer stock",
      "description": "Find live used vehicles on covered NZ dealer yards by make, model, year range, price range in NZD, city or suburb, and fuel type. Results are sorted by price ascending and link to the dealer's own listing page. Anonymous callers receive at most 5 results per call and no VIN or plate.",
      "tags": ["new-zealand", "used-cars", "search", "pricing", "inventory"],
      "examples": [
        "Ford Rangers under $30,000 on Auckland yards",
        "Hybrid hatchbacks between $10k and $16k in Manukau",
        "2018 or newer diesel utes, cheapest first"
      ],
      "outputModes": ["application/json"]
    },
    {
      "id": "get-listing",
      "name": "Resolve one listing",
      "description": "Fetch a single vehicle listing by its exact source_url, including VIN and plate where the yard published them and the caller is using an API key. Unknown URLs return not_found, which usually means the vehicle has sold.",
      "tags": ["new-zealand", "used-cars", "listing", "vin"],
      "examples": [
        "Is this dealer listing still available?",
        "What are the full details for this vehicle URL?"
      ],
      "outputModes": ["application/json"]
    }
  ],
  "securitySchemes": {
    "apiKey": {
      "apiKeySecurityScheme": {
        "location": "header",
        "name": "Authorization",
        "description": "Optional. Send `Authorization: Bearer <key>` or `X-Api-Key: <key>` for full access. Calling with no credentials is allowed and returns the free tier: search capped at 5 results per call, VIN and plate omitted. Keys are issued manually on request via https://yardstock.nz"
      }
    }
  }
}