YardStock NZ Vehicle Listings

YardStock — Listados de Vehículos de NZ MCP

Stock de autos usados en vivo en patios de concesionarios neozelandeses nombrados — buscable por marca, modelo, precio y ciudad, directamente desde tu agente. No es Trade Me.

Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, ChatGPT (modo desarrollador), Perplexity y cualquier cliente MCP.

---

Qué es esto

YardStock es un servidor alojado de Model Context Protocol que expone stock de autos usados en vivo extraído de los sitios web de los patios de los grupos de concesionarios de NZ.

• No es Trade Me. No es AutoTrader. No es un registro nacional de todos los autos en venta en Nueva Zelanda.
• Actualmente más de 200 patios de concesionarios, aproximadamente 30,000 listados en vivo, en toda Nueva Zelanda. La herramienta coverage siempre indica la cifra exacta en vivo.
• Cada respuesta incluye un bloque de cobertura para que un agente pueda indicar lo que no revisó.

Punto final MCP	https://stock.yardstock.nz/mcp (HTTP Streamable, JSON-RPC sobre POST)
Verificación de salud	https://stock.yardstock.nz/health → {"ok": true, "service": "nz-yard-stock"} (abierto, sin autenticación)
Nombre del registro	nz.yardstock/nz-car-listings v1.0.0
Autenticación	Authorization: Bearer <key> o X-Api-Key: <key>
Sitio	https://yardstock.nz

---

Instalación

Claude Code

claude mcp add --transport http yardstock https://stock.yardstock.nz/mcp

Con una clave API:

claude mcp add --transport http yardstock https://stock.yardstock.nz/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Claude Desktop / Claude web (conector personalizado)

Un clic:

→ Agregar YardStock a Claude

O manualmente: Configuración → Conectores → Agregar conector personalizado, luego pega

https://stock.yardstock.nz/mcp

Cursor

Un clic:

→ Instalar en Cursor

O agrégalo a ~/.cursor/mcp.json (global) o .cursor/mcp.json (por proyecto):

{
  "mcpServers": {
    "yardstock": {
      "url": "https://stock.yardstock.nz/mcp"
    }
  }
}

El enlace profundo anterior es el base64 de exactamente esa configuración del servidor — verifícalo tú mismo:

printf '%s' '{"url":"https://stock.yardstock.nz/mcp"}' | base64
# eyJ1cmwiOiJodHRwczovL3N0b2NrLnlhcmRzdG9jay5uei9tY3AifQ==

VS Code

Un clic:

→ Instalar en VS Code

O desde la CLI:

code --add-mcp '{"name":"yardstock","type":"http","url":"https://stock.yardstock.nz/mcp"}'

O agrégalo a .vscode/mcp.json:

{
  "servers": {
    "yardstock": {
      "type": "http",
      "url": "https://stock.yardstock.nz/mcp"
    }
  }
}

Codex CLI

codex mcp add yardstock --url https://stock.yardstock.nz/mcp

O en ~/.codex/config.toml:

[mcp_servers.yardstock]
url = "https://stock.yardstock.nz/mcp"

Windsurf

Agrégalo a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "yardstock": {
      "serverUrl": "https://stock.yardstock.nz/mcp"
    }
  }
}

ChatGPT (modo desarrollador)

Configuración → Conectores → Avanzado → Modo desarrollador, luego Crea un conector con:

• Nombre: YardStock
• URL del servidor MCP: https://stock.yardstock.nz/mcp
• Autenticación: Sin autenticación (nivel gratuito) o un encabezado Authorization: Bearer <key> personalizado para acceso completo.

Perplexity

Configuración → Conectores → Agregar conector → Personalizado, transporte HTTP (Streamable), URL:

https://stock.yardstock.nz/mcp

Cualquier otro cliente MCP

Apúntalo a https://stock.yardstock.nz/mcp con transporte HTTP Streamable. Nada que instalar, nada que ejecutar localmente. Consulta examples/curl.md para JSON-RPC sin procesar.

Como complemento de Claude Code

Este repositorio también incluye un mercado de complementos autoalojado, que instala el conector y la habilidad del agente incluida juntos:

claude plugin marketplace add aaronwaddington-arch/yardstock-mcp
claude plugin install yardstock@yardstock

---

Herramientas

Herramienta	Argumentos	Devuelve
coverage	ninguno	groups[{legal_name, listing_count, cities[]}] — exactamente qué grupos de concesionarios están en el alcance en este momento
search_stock	make, model, year_min, year_max, price_min_nzd, price_max_nzd, city, fuel, limit (≤50, predeterminado 20)	resultados ordenados precio ascendente: {source_url, year, make, model, price_nzd, odometer_km, fuel, yard_label, city, trader_name, last_seen}
get_listing	source_url	un listado, más vin / plate donde se almacenen (acceso solo por clave)

Todos los argumentos de search_stock son opcionales — omítelos todos y obtendrás el stock en vivo más barato en todos los patios cubiertos.

---

Ejemplos de frases

Pregunta a tu agente, en lenguaje natural:

• "Encuéntrame una Hilux 2019 por menos de $35k en Auckland."
• "¿Qué grupos de concesionarios de NZ tienen stock en vivo realmente?"
• "Muéstrame todas las camionetas diésel por menos de $30,000, primero las más baratas."
• "¿Alguna RAV4 con menos de 80,000 km en el odómetro?"
• "¿Cuál es la variación de precios de una Ford Ranger en los patios que cubres?"
• "Lista Toyota Corollas de 2018 o más nuevas por menos de $25k."
• "Compara los precios del Mazda CX-5 entre los patios de Auckland y todos los demás que cubres."
• "Obtén el detalle completo de este listado — odómetro, combustible, en qué patio está."
• "¿Qué tan fresco es esto? ¿Cuándo se vio cada uno por última vez en el sitio web del patio?"
• "Tengo $18,000 — ¿cuál es el híbrido más nuevo y de bajo kilometraje que puedes ver realmente ahora mismo?"

El agente debe responder con resultados y con lo que no pudo ver. Ese es el punto del producto.

---

Honestidad de cobertura

YardStock es deliberadamente limitado, y la API está construida para que un agente no pueda fingir lo contrario.

• Los datos provienen de los sitios web de más de 200 patios de concesionarios nombrados, aproximadamente 30,000 listados en vivo, en toda Nueva Zelanda.

• No es Trade Me, no es AutoTrader, y no es una imagen completa del mercado de autos usados de Nueva Zelanda. Un auto ausente en YardStock no es un auto que no existe.

• Cada respuesta incluye un bloque de cobertura:

  {
    "groups_with_stock": 10,
    "live_listings": 6000,
    "last_seen_max": "2026-08-25T09:00:00Z",
    "not_included": ["Trade Me", "AutoTrader", "private sellers", "dealer groups not listed by coverage()"]
  }
  

• Los agentes nunca deben inventar stock para grupos no cubiertos. Si un usuario pregunta sobre un grupo de concesionarios que coverage() no lista, la respuesta correcta es "ese grupo no está en la cobertura de YardStock", no una suposición.

• last_seen en cada listado es la señal de frescura. Un listado que no se ha visto recientemente puede ya estar vendido — dilo en lugar de presentarlo como ciertamente disponible.

---

Obtén una clave

El nivel gratuito es anónimo: conéctate sin credenciales, lista herramientas y ejecuta búsquedas limitadas (limit 5, sin VIN ni placa).

Acceso completo — el limit completo hasta 50, y vin/plate en get_listing — necesita una clave API. Las claves se emiten manualmente por ahora; solicita una a través de yardstock.nz.

Envíala como cualquiera de estos encabezados:

Authorization: Bearer YOUR_KEY
X-Api-Key: YOUR_KEY

---

Contenido del repositorio

Ruta	Qué es
SKILL.md	Habilidad del agente — detección de superficie (herramientas MCP primero, respaldo JSON-RPC sin procesar), documentación de argumentos, ejemplos trabajados
AGENTS.md	Convenciones para agentes que operan con este repositorio y API
examples/curl.md	Llamadas curl JSON-RPC ejecutables para las tres herramientas, anónimas y con clave
.claude-plugin/	Complemento de Claude Code + manifiestos de mercado autoalojado
context7.json	Configuración de indexación de Context7

Este repositorio contiene solo documentación y configuración de cliente. Sin raspador, sin canalización, sin datos de concesionarios.

---

Licencia

MIT © 2026 Aaron Waddington