YardStock NZ Vehicle Listings

YardStock — Listagens de Veículos NZ MCP

Estoque ao vivo de carros usados em pátios de concessionárias nomeadas da Nova Zelândia — pesquisável por marca, modelo, preço e cidade, direto do seu agente. Não é Trade Me.

Funciona com Claude Code, Claude Desktop, Cursor, VS Code, Codex, Windsurf, ChatGPT (modo desenvolvedor), Perplexity e qualquer cliente MCP.

---

O que é isto

YardStock é um servidor Model Context Protocol hospedado que expõe estoque ao vivo de veículos usados coletado dos próprios sites de pátios de grupos de concessionárias da NZ.

• Não é Trade Me. Não é AutoTrader. Não é um registro nacional de todos os carros à venda na Nova Zelândia.
• Atualmente 10 grupos de concessionárias, aproximadamente 6.000 listagens ao vivo, com peso para Auckland.
• Cada resposta inclui um bloco de cobertura para que um agente possa declarar o que não examinou.

Endpoint MCP	https://stock.yardstock.nz/mcp (HTTP Streamable, JSON-RPC sobre POST)
Verificação de saúde	https://stock.yardstock.nz/health → {"ok": true, "service": "nz-yard-stock"} (aberto, sem autenticação)
Nome do registro	nz.yardstock/nz-car-listings v1.0.0
Autenticação	Authorization: Bearer <key> ou X-Api-Key: <key>
Site	https://yardstock.nz

---

Instalação

Claude Code

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

Com uma chave de API:

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

Claude Desktop / Claude web (conector personalizado)

Com um clique:

→ Adicionar YardStock ao Claude

Ou manualmente: Configurações → Conectores → Adicionar conector personalizado e cole

https://stock.yardstock.nz/mcp

Cursor

Com um clique:

→ Instalar no Cursor

Ou adicione a ~/.cursor/mcp.json (global) ou .cursor/mcp.json (por projeto):

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

O link profundo acima é o base64 exatamente dessa configuração de servidor — verifique você mesmo:

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

VS Code

Com um clique:

→ Instalar no VS Code

Ou pela CLI:

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

Ou adicione 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

Ou em ~/.codex/config.toml:

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

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

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

ChatGPT (modo desenvolvedor)

Configurações → Conectores → Avançado → Modo desenvolvedor e então Crie um conector com:

• Nome: YardStock
• URL do servidor MCP: https://stock.yardstock.nz/mcp
• Autenticação: Sem autenticação (nível gratuito) ou um cabeçalho Authorization: Bearer <key> personalizado para acesso completo.

Perplexity

Configurações → Conectores → Adicionar conector → Personalizado, transporte HTTP (Streamable), URL:

https://stock.yardstock.nz/mcp

Qualquer outro cliente MCP

Aponte para https://stock.yardstock.nz/mcp com transporte HTTP Streamable. Nada para instalar, nada para executar localmente. Veja examples/curl.md para JSON-RPC bruto.

Como um plugin do Claude Code

Este repositório também inclui um marketplace de plugins auto-hospedado, que instala o conector e a habilidade de agente agrupada juntos:

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

---

Ferramentas

Ferramenta	Argumentos	Retorna
coverage	nenhum	groups[{legal_name, listing_count, cities[]}] — exatamente quais grupos de concessionárias estão no escopo agora
search_stock	make, model, year_min, year_max, price_min_nzd, price_max_nzd, city, fuel, limit (≤50, padrão 20)	resultados ordenados preço crescente: {source_url, year, make, model, price_nzd, odometer_km, fuel, yard_label, city, trader_name, last_seen}
get_listing	source_url	uma listagem, além de vin / plate quando armazenados (acesso somente por chave)

Todos os argumentos para search_stock são opcionais — omita todos e você obtém o estoque ao vivo mais barato em todos os pátios cobertos.

---

Exemplos de frases

Pergunte ao seu agente, em linguagem simples:

• "Encontre uma Hilux 2019 abaixo de $35k em Auckland."
• "Quais grupos de concessionárias da NZ você realmente tem estoque ao vivo?"
• "Mostre todas as picapes a diesel abaixo de $30.000, da mais barata para a mais cara."
• "Algum RAV4 com menos de 80.000 km no hodômetro?"
• "Qual é a variação de preço de um Ford Ranger nos pátios que você cobre?"
• "Liste Toyota Corollas de 2018 ou mais novas abaixo de $25k."
• "Compare os preços do Mazda CX-5 entre os pátios de Auckland e todos os outros que você cobre."
• "Puxe os detalhes completos desta listagem — hodômetro, combustível, em qual pátio está."
• "Quão recente é isto? Quando cada um foi visto pela última vez no site do pátio?"
• "Tenho $18.000 — qual é o híbrido mais novo com baixa quilometragem que você pode ver agora?"

O agente deve responder com os resultados e com o que não pôde ver. Esse é o objetivo do produto.

---

Honestidade de cobertura

YardStock é deliberadamente estreito, e a API é construída para que um agente não possa fingir o contrário.

• Os dados vêm de 10 sites de pátios de grupos de concessionárias nomeados, aproximadamente 6.000 listagens ao vivo, com peso para Auckland.

• Não é Trade Me, não é AutoTrader e não é um quadro completo do mercado de carros usados da Nova Zelândia. Um carro ausente do YardStock não é um carro que não existe.

• Cada resposta inclui um bloco 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()"]
  }
  

• Agentes nunca devem inventar estoque para grupos não cobertos. Se um usuário perguntar sobre um grupo de concessionárias que coverage() não lista, a resposta correta é "esse grupo não está na cobertura do YardStock", não um palpite.

• last_seen em cada listagem é o sinal de frescor. Uma listagem que não foi vista recentemente pode já ter sido vendida — diga isso em vez de apresentá-la como certamente disponível.

---

Obtenha uma chave

O nível gratuito é anônimo: conecte-se sem credenciais, liste ferramentas e execute buscas limitadas (limit 5, sem VIN ou placa).

Acesso completo — o limit completo até 50, e vin/plate em get_listing — precisa de uma chave de API. As chaves são emitidas manualmente no momento; solicite uma via yardstock.nz.

Envie como um dos cabeçalhos:

Authorization: Bearer YOUR_KEY
X-Api-Key: YOUR_KEY

---

Conteúdo do repositório

Caminho	O que é
SKILL.md	Habilidade de agente — detecção de superfície (ferramentas MCP primeiro, fallback JSON-RPC bruto), documentação de argumentos, exemplos práticos
AGENTS.md	Convenções para agentes que operam contra este repositório e API
examples/curl.md	Chamadas curl JSON-RPC executáveis para todas as três ferramentas, anônimas e com chave
.claude-plugin/	Plugin do Claude Code + manifestos de marketplace auto-hospedado
context7.json	Configuração de indexação do Context7

Este repositório contém apenas documentação e configuração de cliente. Sem raspador, sem pipeline, sem dados de concessionárias.

---

Licença

MIT © 2026 Aaron Waddington