# Webmotors — how to use (mcp.ai)

Vehicle search on Webmotors, Brazil's largest automotive marketplace. Search listings by make/model, get full details (specs, photos, seller) and the model's average market price — the real asking price on the marketplace, not just the FIPE table.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_webmotors?ms=1782254820000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `webmotors_category`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/webmotors`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/webmotors/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/webmotors/category` — Lista as categorias de veículo da Webmotors.
- `POST https://api.mcp.ai/api/webmotors/detail` — Detalhe completo de um anúncio. Informe o `slug` retornado por wm_search (o caminho após /comprar, ex.: '/honda/civic/2-0-.../4-portas/2023/71895570'). Retorna specs, preços, vendedor, fotos e descriç
  - body: { slug: string }
- `POST https://api.mcp.ai/api/webmotors/filters` — Lista as opções de filtro da busca (marcas, modelos e demais facetas) para montar consultas válidas.
- `POST https://api.mcp.ai/api/webmotors/location` — Resolve uma localização (cidade/estado/geo) a partir de um texto livre, para filtrar a busca por região.
  - body: { query: string }
- `POST https://api.mcp.ai/api/webmotors/market/price` — Preço médio de mercado do modelo de um anúncio (id = UniqueId de wm_search). Retorna { Make, Model, Version, Year, FipeCode, FipePrice, BiggestPrice, MediumPrice, SmallestPrice }. Diferencial sobre a 
  - body: { id: string, ids?: string[] }
- `POST https://api.mcp.ai/api/webmotors/search` — Busca anúncios de veículos na Webmotors. Filtre por marca e modelo; pagine e ordene. Retorna { total, results[] } com { id, title, make, model, version, year, km, price, fipePercent, slug, detailUrl, 
  - body: { brand?: string, model?: string, path?: string, page?: integer, perPage?: integer, order?: integer }

## Example prompts
- "Find a Honda Civic for sale on Webmotors"
- "What's the average market price of a 2020 Corolla?"
- "List Jeep Compass with photos and price"

## More
- Page: https://mcp.ai/webmotors
- Agent spec (llms.txt): https://mcp.ai/webmotors/llms.txt
- Postman collection: https://mcp.ai/webmotors/postman.json