Voxcars (Portugal)
Used-car listings in Portugal: search, price statistics, comparables and articles.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~4,715Tokens (definiciones de herramientas)
~7.7 KBTamaño de respuesta típico
Impacto significativo en la atención (3.68% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"voxcars-pt": {
"url": "https://www.voxcars.pt/api/mcp"
}
}
}Puntos de conexión remotos
https://www.voxcars.pt/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (6)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_cars(make, model, priceMin, priceMax, yearMin, ...)
Search current used-car listings for sale in Portugal. Use this whenever the user wants to find, compare or explore cars — by make, model, budget, mileage, fuel or district. Returns price, mileage, fuel, body and a citable listing URL, plus `total`: the exact number of listings matching the filters, which makes this tool usable to answer 'how many' questions. Listings are aggregated from stands and portals and refreshed daily; each result carries `publishedAt`. Prefer the broadest filters that answer the question and report `total` as a floor, not a census.
Esquema de entrada
{
"type": "object",
"properties": {
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"model": {
"type": "string",
"description": "Model slug (e.g. corolla, serie-3, golf). Requires `make` to disambiguate."
},
"priceMin": {
"type": "number",
"description": "Minimum price in the market currency."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"yearMax": {
"type": "number",
"description": "Maximum registration year."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"fuel": {
"type": "string",
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"bodyType": {
"type": "string",
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"description": "Body style. SEDAN = berlina, HATCHBACK = citadino, COMBI = carrinha, CABRIO = descapotável, MINIVAN = monovolume."
},
"district": {
"type": "string",
"description": "District or region inside the market (e.g. Lisboa, Porto, Berlin, Madrid). Matched exactly."
},
"condition": {
"type": "string",
"enum": [
"new",
"used",
"semi_new"
],
"description": "Vehicle condition. new = 0 km / registered this year; semi_new = <2 years and <20 000 km; used = everything else."
},
"sort": {
"type": "string",
"enum": [
"recent",
"price_asc",
"price_desc",
"km_asc",
"year_desc"
],
"description": "Result order. Default `recent` (most recently seen first)."
},
"limit": {
"type": "number",
"description": "Results per page (default 10, max 20)."
},
"page": {
"type": "number",
"description": "1-based page number. Use with `total` to walk a large result set."
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string",
"description": "ISO country code of this market."
},
"currency": {
"type": "string"
},
"total": {
"type": "number",
"description": "Exact number of listings in this market matching the filters, across all pages."
},
"page": {
"type": "number"
},
"pageSize": {
"type": "number"
},
"shown": {
"type": "number"
},
"hasMore": {
"type": "boolean"
},
"cars": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"km": {
"type": [
"number",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"sellerType": {
"type": [
"string",
"null"
],
"enum": [
"STAND",
"PARTICULAR",
null
]
},
"condition": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
}
},
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
]
}
}
},
"required": [
"market",
"currency",
"total",
"page",
"hasMore",
"cars"
]
}🟢search_cars_by_description(description, make, priceMax, yearMin, kmMax, ...)
Search Portugal listings by describing the car in plain language, matched against listing text by meaning rather than keywords. Use this for wants that are not filter fields — 'a family SUV good in the snow', 'a low-mileage hybrid for the city', 'a used 4x4 to restore'. Prefer search_cars for entirely structural queries (make/model/budget); use this when the request is descriptive. Combine both by passing structural filters here too — they act as hard constraints while the description only ranks. Results are ordered by relevance, so `total` is the number matching the structural filters, not the number that fit the description.
Esquema de entrada
{
"type": "object",
"properties": {
"description": {
"type": "string",
"description": "What the user is looking for, in their own words. Full phrases work better than keywords. Pass the qualities here and the hard limits in the other arguments."
},
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"fuel": {
"type": "string",
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"bodyType": {
"type": "string",
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"description": "Body style. SEDAN = berlina, HATCHBACK = citadino, COMBI = carrinha, CABRIO = descapotável, MINIVAN = monovolume."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 10, max 20)."
}
},
"required": [
"description"
]
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"total": {
"type": "number",
"description": "Listings matching the structural filters. The description narrows the ranking, not this count."
},
"shown": {
"type": "number"
},
"cars": {
"type": "array",
"description": "Ordered by relevance to the description, most relevant first.",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"km": {
"type": [
"number",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"sellerType": {
"type": [
"string",
"null"
],
"enum": [
"STAND",
"PARTICULAR",
null
]
},
"condition": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
}
},
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
]
}
}
},
"required": [
"market",
"total",
"shown",
"cars"
]
}🟢get_price_stats(make, model, priceMin, priceMax, yearMin, ...)
Get price statistics for a slice of the Portugal used-car market: how many listings match, the median price, the p25–p75 range, the median price per kilometre and a breakdown by body type. Use this when the user asks what something costs, whether an asking price is fair, or how two makes compare — instead of listing individual cars. Takes the same filters as search_cars and describes exactly the set that tool would return, so the two never disagree. Reports medians and quartiles rather than averages, because car prices have a long right tail and a single luxury listing moves an average.
Esquema de entrada
{
"type": "object",
"properties": {
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"model": {
"type": "string",
"description": "Model slug (e.g. corolla, serie-3, golf). Requires `make` to disambiguate."
},
"priceMin": {
"type": "number",
"description": "Minimum price in the market currency."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"yearMax": {
"type": "number",
"description": "Maximum registration year."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"fuel": {
"type": "string",
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"bodyType": {
"type": "string",
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"description": "Body style. SEDAN = berlina, HATCHBACK = citadino, COMBI = carrinha, CABRIO = descapotável, MINIVAN = monovolume."
},
"district": {
"type": "string",
"description": "District or region inside the market (e.g. Lisboa, Porto, Berlin, Madrid). Matched exactly."
},
"condition": {
"type": "string",
"enum": [
"new",
"used",
"semi_new"
],
"description": "Vehicle condition. new = 0 km / registered this year; semi_new = <2 years and <20 000 km; used = everything else."
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"count": {
"type": "number",
"description": "Listings matching the filters, with or without a published price."
},
"priced": {
"type": "number",
"description": "Subset with a published price — the base of every figure below. A large gap to `count` means many listings in this slice are 'price on request'."
},
"price": {
"type": [
"object",
"null"
],
"description": "Price distribution, in percentiles. null when no matching listing publishes a price. There is deliberately no min or max: listings come from third-party sources and the extremes are set by data errors, not by the market.",
"properties": {
"p10": {
"type": "number",
"description": "The bottom of the market: 10% of listings are cheaper."
},
"p25": {
"type": "number",
"description": "A quarter of listings are priced below this."
},
"median": {
"type": "number",
"description": "The typical price — use this to answer 'how much'."
},
"p75": {
"type": "number",
"description": "A quarter of listings are priced above this."
},
"p90": {
"type": "number",
"description": "The top of the market: 10% of listings are dearer."
}
}
},
"pricePerKmMedian": {
"type": [
"number",
"null"
],
"description": "Median price per kilometre on the odometer, in the listing currency (order of magnitude 0.05–3). Small = the car has done a lot for its price."
},
"byBodyType": {
"type": "array",
"description": "Up to 6 most represented body types, each with its own median.",
"items": {
"type": "object",
"properties": {
"body": {
"type": "string"
},
"count": {
"type": "number"
},
"medianPrice": {
"type": [
"number",
"null"
]
}
},
"required": [
"body",
"count"
]
}
}
},
"required": [
"market",
"currency",
"count",
"priced",
"byBodyType"
]
}🟢find_similar_cars(slug, maxPrice, limit)
Given one listing, find comparable ones: same make, similar year, mileage and price band. Use this when the user likes a car but wants alternatives — 'find me something similar', 'the same but cheaper', 'what else is around this price'. Pass `maxPrice` for the cheaper case; without it, comparables are drawn from a band around the reference price. Comparability is by structure (make/model/year/km/price), not by text similarity: it answers 'is this well priced for what it is', which a keyword search cannot.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Slug of the reference listing, as returned by search_cars or get_car_detail."
},
"maxPrice": {
"type": "number",
"description": "Optional budget ceiling, in EUR. Use it for 'similar but cheaper'; it overrides the default band around the reference price."
},
"limit": {
"type": "number",
"description": "Maximum number of comparables (default 6, max 20)."
}
},
"required": [
"slug"
]
}Esquema de salida
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"reference": {
"type": "object",
"description": "The listing the comparables are measured against, echoed back for the comparison.",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"km": {
"type": [
"number",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"sellerType": {
"type": [
"string",
"null"
],
"enum": [
"STAND",
"PARTICULAR",
null
]
},
"condition": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
}
}
},
"total": {
"type": "number",
"description": "Comparables returned."
},
"cars": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"km": {
"type": [
"number",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"sellerType": {
"type": [
"string",
"null"
],
"enum": [
"STAND",
"PARTICULAR",
null
]
},
"condition": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
}
},
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
]
}
}
},
"required": [
"market",
"reference",
"total",
"cars"
]
}🟢get_car_detail(slug)
Get the complete record of one used-car listing in Portugal by its slug. Use this after search_cars when the user asks about a specific car: full description, features, photos, seller, and the original source URL to cite.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Unique listing slug, as returned by search_cars."
}
},
"required": [
"slug"
]
}Esquema de salida
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"title": {
"type": "string"
},
"make": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": [
"string",
"null"
]
},
"year": {
"type": [
"number",
"null"
]
},
"km": {
"type": [
"number",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"transmission": {
"type": [
"string",
"null"
]
},
"body": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"sellerType": {
"type": [
"string",
"null"
],
"enum": [
"STAND",
"PARTICULAR",
null
]
},
"condition": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"description": {
"type": [
"string",
"null"
]
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"photos": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 image URLs."
},
"doors": {
"type": [
"number",
"null"
]
},
"seats": {
"type": [
"number",
"null"
]
},
"color": {
"type": [
"string",
"null"
]
},
"engineCc": {
"type": [
"number",
"null"
]
},
"origin": {
"type": [
"string",
"null"
],
"description": "NACIONAL = domestic; IMPORTADO = imported."
}
},
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
]
}🟢search_articles(category, limit)
Search editorial articles about the used-car market in Portugal: buying guides, reviews, comparisons and market analysis. Use this when the user asks how something works — financing, warranty, IUC, IPO/ITV, the buying process — rather than asking for listings.
Esquema de entrada
{
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"GUIA",
"REVIEW",
"COMPARATIVO",
"MERCADO",
"GLOSSARIO",
"NOTICIA"
],
"description": "Article category."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 5, max 10)."
}
}
}Esquema de salida
{
"type": "object",
"properties": {
"articles": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"type": "string"
},
"dek": {
"type": "string"
},
"category": {
"type": "string"
}
},
"required": [
"slug",
"title",
"url"
]
}
}
},
"required": [
"articles"
]
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada6 herramientas
verificadoversión no registrada6 herramientas