About transparentpt
transparentpt is an open-source MCP server for exploring budget used cars in Portugal. It searches current stock and provides car details, estimated fair-price ranges, annual IUC costs, and a consent-based contact option.
Key features
- 01Search stock by car and price criteria
- 02Retrieve vehicle details and specifications
- 03Compare asking prices with market ranges
- 04Estimate annual IUC road tax
- 05Look up canonical makes and models
- 06Request contact with explicit consent
Use cases
- 01Find cars matching a budget and preferences
- 02Check whether a listed car price is near market range
- 03Estimate yearly IUC before buying
- 04Ask TransparentCars to make contact
MCP support
Exposes TransparentCars public API functions as tools for MCP clients, including stock search, vehicle lookup, price checks, cost estimates, and contact requests. It is available as a remote Streamable HTTP server or through local stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://transparent.pt/mcpclaude mcp add --transport http transparentpt https://transparent.pt/mcp{"mcpServers":{"transparentpt":{"type":"http","url":"https://transparent.pt/mcp"}}}Open in Cursor{"servers":{"transparentpt":{"type":"http","url":"https://transparent.pt/mcp"}}}Open in VS Code{"mcpServers":{"transparentpt":{"type":"http","url":"https://transparent.pt/mcp"}}}{"mcpServers":{"transparentpt":{"serverUrl":"https://transparent.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
11| Parameter | Type | Required | Description |
|---|---|---|---|
| fuel | string | No | Fuel: petrol, diesel, hybrid, phev, electric, lpg |
| make | string | No | Full brand name in Latin, as the market lists it — 'Renault', 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'. |
| limit | integer | No | Max results (default 20) |
| model | string | No | Short model name WITHOUT engine or trim — 'Clio' (not 'Clio 1.5 dCi'), 'Golf' (not 'Golf TSI'). |
| gearbox | string | No | Gearbox: manual or automatic |
| min_year | number | No | Earliest registration year |
| max_price | number | No | Maximum price in EUR |
Details
From the project README
TransparentCars MCP server
An MCP server that lets AI assistants work with TransparentCars — honest, budget used cars for the local Portuguese market. Search live stock, check whether a car's asking price is actually fair, estimate the yearly cost of keeping a car on the road, and get in touch.
It's a thin, open-source wrapper over the public transparent.pt API — no keys, no setup beyond adding the server.
Tools
| Tool | What it does |
|---|---|
search_inventory | Search current budget stock by make, model, fuel, gearbox, price, year |
get_car | Full details + specs for one car |
check_fair_price | The market range a car sells for — plus a fair / above-market / below-market verdict on an asking price |
cost_to_own | The annual IUC road tax + a plain running-cost framing for budgeting |
list_makes_models | Canonical brand/model names the other tools expect |
contact_me | Ask a human to get in touch (needs the user's consent + contact) |
The fair-price check is the point: paste any listing's price and get a straight answer on whether it's a good deal — no sales spin.
Use it
Remote (add a URL)
https://transparent.pt/mcp
Add it in any client that supports remote/Streamable HTTP MCP servers.
Local (stdio, via npx)
Claude Desktop / Cline / Continue config:
{
"mcpServers": {
"transparentcars": {
"command": "npx",
"args": ["-y", "transparentcars-mcp"]
}
}
}
Examples
- "Find a manual petrol car under €10,000 in TransparentCars stock."
- "A dealer wants €9,500 for a 2014 Renault Clio with 120,000 km — is that fair?"
- "What's the yearly road tax on a 2016 petrol, 1200 cc, 120 g/km CO₂?"
- "Ask TransparentCars to call me — my name is … and my number is …"
Configuration
| Env var | Default | Purpose |
|---|---|---|
TC_API_BASE | https://transparent.pt/api/public | Public API base |
TC_SITE | transparentcars | Site key the API is scoped to |
TC_LANG | en | Response language (pt/en) |
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 guarantees. The fair-price range and running-cost figures are estimates built from real comparable listings and the official road-tax table; treat them as guidance, not a formal valuation.
- Privacy.
contact_mesends the details the user provides to TransparentCars (privacy policy); it requires explicit user intent and consent. - No business logic or data lives in this repo — it only calls the public API.
MIT © TransparentCars
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.