YardStock NZ Vehicle Listings

Stock de autos usados en vivo en los patios de concesionarios neozelandeses nombrados. Busca por marca, modelo, precio y ciudad. No es Trade Me.

GitHubPrueba este MCPPatrocinado

Documentación

YardStock — Listados de Vehículos de NZ MCP

License: MIT Agent Skill on skills.sh Docs: connect MCP Registry: nz.yardstock/nz-car-listings

Stock de autos usados en vivo en patios de concesionarios neozelandeses nombrados: busca 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 de Model Context Protocol alojado 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 10 grupos de concesionarios, aproximadamente 6,000 listados en vivo, con peso en Auckland.
  • Cada respuesta incluye un bloque de cobertura para que un agente pueda indicar qué no revisó.
Endpoint MCPhttps://stock.yardstock.nz/mcp (HTTP Streamable, JSON-RPC sobre POST)
Verificación de saludhttps://stock.yardstock.nz/health → {"ok": true, "service": "nz-yard-stock"} (abierto, sin autenticación)
Nombre del registronz.yardstock/nz-car-listings v1.0.0
AutenticaciónAuthorization: Bearer <key> o X-Api-Key: <key>
Sitiohttps://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, y 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 plugin de Claude Code

Este repositorio también incluye un mercado de plugins 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

HerramientaArgumentosDevuelve
coverageningunogroups[{legal_name, listing_count, cities[]}] — exactamente qué grupos de concesionarios están en el alcance ahora mismo
search_stockmake, 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_listingsource_urlun 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

Pregúntale 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 el resto de lo que cubres."
  • "Trae 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 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 los patios de 10 grupos de concesionarios nombrados, aproximadamente 6,000 listados en vivo, con peso hacia Auckland.

  • 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

RutaQué es
SKILL.mdHabilidad del agente: detección de superficie (herramientas MCP primero, JSON-RPC sin procesar como respaldo), documentación de argumentos, ejemplos trabajados
AGENTS.mdConvenciones para agentes que operan contra este repositorio y la API
examples/curl.mdLlamadas curl JSON-RPC ejecutables para las tres herramientas, anónimas y con clave
.claude-plugin/Plugin de Claude Code + manifiestos de mercado autoalojado
context7.jsonConfiguración de indexación de Context7

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

Licencia

MIT © 2026 Aaron Waddington