Voxcars MCP
An official MCP server provided by Voxcars that allows AI agents to search for used cars in Portugal, retrieve vehicle details, find similar cars, and access real-time price statistics and articles without requiring authentication.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.voxcars.pt/api/mcpWhat its tools do
6 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to voxs.eu ·
- Passed Endpoint and vendor documentation share a domain
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for used cars by make, model, price, and other filters
- Retrieve detailed information about specific vehicles
- Get real-time price statistics and fair price scores
- Search for related articles and market trends
Source and maintenance
Protocol and capabilities
- Server
- voxcars-pt 1.0.0
- MCP protocol negotiated in check
- 2024-11-05
- Tools
- 6 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {}
}Tools
6 advertised
search_cars
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.
{
"type": "object",
"properties": {
"fuel": {
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"type": "string",
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"page": {
"type": "number",
"description": "1-based page number. Use with `total` to walk a large result set."
},
"sort": {
"enum": [
"recent",
"price_asc",
"price_desc",
"km_asc",
"year_desc"
],
"type": "string",
"description": "Result order. Default `recent` (most recently seen first)."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"limit": {
"type": "number",
"description": "Results per page (default 10, max 20)."
},
"model": {
"type": "string",
"description": "Model slug (e.g. corolla, serie-3, golf). Requires `make` to disambiguate."
},
"yearMax": {
"type": "number",
"description": "Maximum registration year."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"bodyType": {
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"type": "string",
"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."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"priceMin": {
"type": "number",
"description": "Minimum price in the market currency."
},
"condition": {
"enum": [
"new",
"used",
"semi_new"
],
"type": "string",
"description": "Vehicle condition. new = 0 km / registered this year; semi_new = <2 years and <20 000 km; used = everything else."
}
}
}{
"type": "object",
"required": [
"market",
"currency",
"total",
"page",
"hasMore",
"cars"
],
"properties": {
"cars": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
],
"properties": {
"km": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"make": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"year": {
"type": [
"number",
"null"
]
},
"model": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"variant": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"condition": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"sellerType": {
"enum": [
"STAND",
"PARTICULAR",
null
],
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"transmission": {
"type": [
"string",
"null"
]
}
}
}
},
"page": {
"type": "number"
},
"shown": {
"type": "number"
},
"total": {
"type": "number",
"description": "Exact number of listings in this market matching the filters, across all pages."
},
"market": {
"type": "string",
"description": "ISO country code of this market."
},
"hasMore": {
"type": "boolean"
},
"currency": {
"type": "string"
},
"pageSize": {
"type": "number"
}
}
}{
"title": "Search used cars in Portugal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_cars_by_description
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.
{
"type": "object",
"required": [
"description"
],
"properties": {
"fuel": {
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"type": "string",
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"limit": {
"type": "number",
"description": "Maximum number of results (default 10, max 20)."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"bodyType": {
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"type": "string",
"description": "Body style. SEDAN = berlina, HATCHBACK = citadino, COMBI = carrinha, CABRIO = descapotável, MINIVAN = monovolume."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"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."
}
}
}{
"type": "object",
"required": [
"market",
"total",
"shown",
"cars"
],
"properties": {
"cars": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
],
"properties": {
"km": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"make": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"year": {
"type": [
"number",
"null"
]
},
"model": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"variant": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"condition": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"sellerType": {
"enum": [
"STAND",
"PARTICULAR",
null
],
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"transmission": {
"type": [
"string",
"null"
]
}
}
},
"description": "Ordered by relevance to the description, most relevant first."
},
"shown": {
"type": "number"
},
"total": {
"type": "number",
"description": "Listings matching the structural filters. The description narrows the ranking, not this count."
},
"market": {
"type": "string"
},
"currency": {
"type": "string"
}
}
}{
"title": "Search cars by description in Portugal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_price_stats
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.
{
"type": "object",
"properties": {
"fuel": {
"enum": [
"GASOLINE",
"DIESEL",
"ELECTRIC",
"HYBRID",
"PLUG_IN_HYBRID",
"LPG"
],
"type": "string",
"description": "Fuel type. GASOLINE = gasolina, ELECTRIC = eléctrico, HYBRID = full hybrid, PLUG_IN_HYBRID = PHEV."
},
"make": {
"type": "string",
"description": "Make slug (e.g. toyota, bmw, volkswagen). Not free text — the slug is the same in every market."
},
"kmMax": {
"type": "number",
"description": "Maximum kilometres on the odometer."
},
"model": {
"type": "string",
"description": "Model slug (e.g. corolla, serie-3, golf). Requires `make` to disambiguate."
},
"yearMax": {
"type": "number",
"description": "Maximum registration year."
},
"yearMin": {
"type": "number",
"description": "Minimum registration year."
},
"bodyType": {
"enum": [
"SUV",
"SEDAN",
"HATCHBACK",
"COMBI",
"COUPE",
"CABRIO",
"MINIVAN",
"PICKUP"
],
"type": "string",
"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."
},
"priceMax": {
"type": "number",
"description": "Maximum price in the market currency. Listings with no published price are excluded by either bound."
},
"priceMin": {
"type": "number",
"description": "Minimum price in the market currency."
},
"condition": {
"enum": [
"new",
"used",
"semi_new"
],
"type": "string",
"description": "Vehicle condition. new = 0 km / registered this year; semi_new = <2 years and <20 000 km; used = everything else."
}
}
}{
"type": "object",
"required": [
"market",
"currency",
"count",
"priced",
"byBodyType"
],
"properties": {
"count": {
"type": "number",
"description": "Listings matching the filters, with or without a published price."
},
"price": {
"type": [
"object",
"null"
],
"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."
},
"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."
},
"median": {
"type": "number",
"description": "The typical price — use this to answer 'how much'."
}
},
"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."
},
"market": {
"type": "string"
},
"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'."
},
"currency": {
"type": "string"
},
"byBodyType": {
"type": "array",
"items": {
"type": "object",
"required": [
"body",
"count"
],
"properties": {
"body": {
"type": "string"
},
"count": {
"type": "number"
},
"medianPrice": {
"type": [
"number",
"null"
]
}
}
},
"description": "Up to 6 most represented body types, each with its own median."
},
"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."
}
}
}{
"title": "Used-car price statistics for Portugal",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_similar_cars
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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Slug of the reference listing, as returned by search_cars or get_car_detail."
},
"limit": {
"type": "number",
"description": "Maximum number of comparables (default 6, max 20)."
},
"maxPrice": {
"type": "number",
"description": "Optional budget ceiling, in EUR. Use it for 'similar but cheaper'; it overrides the default band around the reference price."
}
}
}{
"type": "object",
"required": [
"market",
"reference",
"total",
"cars"
],
"properties": {
"cars": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
],
"properties": {
"km": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"make": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"year": {
"type": [
"number",
"null"
]
},
"model": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"variant": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"condition": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"sellerType": {
"enum": [
"STAND",
"PARTICULAR",
null
],
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"transmission": {
"type": [
"string",
"null"
]
}
}
}
},
"total": {
"type": "number",
"description": "Comparables returned."
},
"market": {
"type": "string"
},
"currency": {
"type": "string"
},
"reference": {
"type": "object",
"properties": {
"km": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"make": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"year": {
"type": [
"number",
"null"
]
},
"model": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"title": {
"type": "string"
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"variant": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"condition": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"sellerType": {
"enum": [
"STAND",
"PARTICULAR",
null
],
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"transmission": {
"type": [
"string",
"null"
]
}
},
"description": "The listing the comparables are measured against, echoed back for the comparison."
}
}
}{
"title": "Find comparable cars",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_car_detail
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.
{
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Unique listing slug, as returned by search_cars."
}
}
}{
"type": "object",
"required": [
"slug",
"url",
"title",
"make",
"model",
"currency",
"publishedAt"
],
"properties": {
"km": {
"type": [
"number",
"null"
]
},
"url": {
"type": "string",
"description": "Canonical listing page on this market's domain."
},
"body": {
"type": [
"string",
"null"
]
},
"fuel": {
"type": [
"string",
"null"
]
},
"make": {
"type": "string"
},
"slug": {
"type": "string",
"description": "Stable identifier; pass to get_car_detail or find_similar_cars."
},
"year": {
"type": [
"number",
"null"
]
},
"color": {
"type": [
"string",
"null"
]
},
"doors": {
"type": [
"number",
"null"
]
},
"model": {
"type": "string"
},
"price": {
"type": [
"number",
"null"
],
"description": "null means the source does not publish a price (on request)."
},
"seats": {
"type": [
"number",
"null"
]
},
"title": {
"type": "string"
},
"origin": {
"type": [
"string",
"null"
],
"description": "NACIONAL = domestic; IMPORTADO = imported."
},
"photos": {
"type": "array",
"items": {
"type": "string"
},
"description": "Up to 5 image URLs."
},
"source": {
"type": [
"string",
"null"
],
"description": "Aggregator platform the listing came from; null when published directly with us."
},
"variant": {
"type": [
"string",
"null"
]
},
"currency": {
"type": "string",
"description": "ISO 4217 code of this market."
},
"district": {
"type": [
"string",
"null"
]
},
"engineCc": {
"type": [
"number",
"null"
]
},
"features": {
"type": "array",
"items": {
"type": "string"
}
},
"power_cv": {
"type": [
"number",
"null"
],
"description": "Engine power in metric horsepower (CV/PS)."
},
"condition": {
"type": [
"string",
"null"
]
},
"sourceUrl": {
"type": [
"string",
"null"
],
"description": "Original listing URL at the source. Cite this alongside url."
},
"sellerType": {
"enum": [
"STAND",
"PARTICULAR",
null
],
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"publishedAt": {
"type": "string",
"description": "ISO 8601 date the listing was first seen at the source."
},
"transmission": {
"type": [
"string",
"null"
]
}
}
}{
"title": "Get car detail",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_articles
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.
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Maximum number of results (default 5, max 10)."
},
"category": {
"enum": [
"GUIA",
"REVIEW",
"COMPARATIVO",
"MERCADO",
"GLOSSARIO",
"NOTICIA"
],
"type": "string",
"description": "Article category."
}
}
}{
"type": "object",
"required": [
"articles"
],
"properties": {
"articles": {
"type": "array",
"items": {
"type": "object",
"required": [
"slug",
"title",
"url"
],
"properties": {
"dek": {
"type": "string"
},
"url": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"category": {
"type": "string"
}
}
}
}
}
}{
"title": "Search articles",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1907 ms
- 95th percentile latency
- 1907 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1907 ms · metadata changed · 6 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http voxcars-mcp https://www.voxcars.pt/api/mcpCodex
codex mcp add voxcars-mcp --url https://www.voxcars.pt/api/mcpCursor
{
"mcpServers": {
"voxcars-mcp": {
"url": "https://www.voxcars.pt/api/mcp"
}
}
}Cline
{
"mcpServers": {
"voxcars-mcp": {
"type": "streamableHttp",
"url": "https://www.voxcars.pt/api/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"voxcars-mcp": {
"type": "http",
"url": "https://www.voxcars.pt/api/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http voxcars-mcp https://www.voxcars.pt/api/mcpClaude Desktop
https://www.voxcars.pt/api/mcpWindsurf
{
"mcpServers": {
"voxcars-mcp": {
"serverUrl": "https://www.voxcars.pt/api/mcp"
}
}
}Let your agent find its tools
Find servers like Voxcars MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Voxcars MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.