Clara Carros — Used & Imported Cars In Portugal (search, Isv/iuc Tax, Valuation)
RemoteAbout Clara Carros — Used & Imported Cars In Portugal (search, Isv/iuc Tax, Valuation)
Clara Carros is an MCP server for AI assistants working with used and imported cars in Portugal. It wraps the public API to search stock, estimate taxes and resale values, and send contact or import quote requests.
Key features
- 01Search stock by make, model, and price
- 02Retrieve car details and specifications
- 03Estimate ISV and IUC taxes
- 04Estimate resale value in Portugal
- 05Send contact or import quote requests
Use cases
- 01Filter available cars by budget
- 02Estimate taxes for an imported car
- 03Check a car’s resale value in Portugal
- 04Request contact or an import quote from Clara Carros
MCP support
As an MCP server, it exposes inventory search, car details, ISV/IUC estimates, resale valuation, and contact tools to clients. It supports remote HTTP and local stdio connections.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://claracars.pt/mcpclaude mcp add --transport http claracarspt https://claracars.pt/mcp{"mcpServers":{"claracarspt":{"type":"http","url":"https://claracars.pt/mcp"}}}Open in Cursor{"servers":{"claracarspt":{"type":"http","url":"https://claracars.pt/mcp"}}}Open in VS Code{"mcpServers":{"claracarspt":{"type":"http","url":"https://claracars.pt/mcp"}}}{"mcpServers":{"claracarspt":{"serverUrl":"https://claracars.pt/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
9| Parameter | Type | Required | Description |
|---|---|---|---|
| make | string | No | Full brand name in Latin, as the market lists it — 'BMW', 'Mercedes-Benz' (not 'Mercedes'), 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'. |
| model | string | No | Short model/series WITHOUT engine or trim. BMW: series number only ('320','330','116', not '330e'/'320d'/'3 Series'). Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'). Others: plain model name ('Golf','Corolla','3008', not 'Golf 1.5 TSI'). |
| fuel | string | No | Fuel: petrol, diesel, hybrid, phev, electric, lpg |
| max_price | number | No | Maximum price in EUR |
| min_year | number | No | Earliest registration year |
| limit | integer | No | Max results (default 20) |
Details
From the project README
Clara Carros MCP server
An MCP server that lets AI assistants work with Clara Carros — used & imported cars in Portugal. Search live stock, estimate the Portuguese import tax (ISV), estimate a car's resale value, and get in touch.
It's a thin, open-source wrapper over the public claracars.pt API — no keys, no setup beyond adding the server.
Cline / one-click install: see
llms-install.md— the machine-readable setup guide.
Tools
| Tool | What it does |
|---|---|
search_inventory | Search current stock by make, model, fuel, price, year |
get_car | Full details + specs for one car |
calculate_isv | Estimate Portuguese car import tax (ISV) |
calculate_iuc | Estimate Portuguese annual road tax (IUC) |
list_makes_models | Canonical brand/model names the other tools expect |
estimate_resale_value | Market value range for a car in Portugal |
list_services | What Clara Carros offers |
contact_me | Ask a human to get in touch (needs the user's consent + contact) |
request_import_quote | Ask Clara Carros to source & quote a car to import |
Use it
Remote (add a URL)
https://claracars.pt/mcp
Add it in any client that supports remote/Streamable HTTP MCP servers.
Local (stdio, via npx)
Claude Desktop / Cline / Continue config:
{
"mcpServers": {
"claracars": {
"command": "npx",
"args": ["-y", "claracars-mcp"]
}
}
}
Examples
- "Find diesel wagons under €20,000 in Clara Carros stock."
- "What's the ISV and annual IUC road tax on a 2016 diesel, 1950 cc, 130 g/km CO₂?"
- "What's my 2018 VW Golf, 100,000 km worth in Portugal?"
- "Ask Clara Carros to source a BMW 320d Touring 2021, my name is … and phone …"
Configuration
| Env var | Default | Purpose |
|---|---|---|
CLARACARS_API_BASE | https://claracars.pt/api/public | Public API base |
CLARACARS_LANG | en | Response language (pt/en/ru/ua) |
PORT / MCP_PATH | 8099 / /mcp | HTTP server (remote mode) |
Develop
npm install
npm run build
node dist/index.js # stdio
npm run start:http # remote HTTP on :8099/mcp
Notes
- Estimates, not quotes. ISV and resale figures are estimates; the official ISV is assessed by the Portuguese tax authority.
- Privacy.
contact_me/request_import_quotesend the details the user provides to Clara Carros (privacy policy); they're rate-limited and require explicit user intent. - No business logic or data lives in this repo — it only calls the public API.
Related
- Calculators: the ISV/IUC tax logic this server calls is open-source at claracarspt/calcs — a zero-dependency Python library + key-free API.
MIT © Clara Carros
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.