Lets AI assistants search used car inventory in Portugal, evaluate price fairness, and calculate import or road tax costs.
Also known as transparentpt/mcp, transparentcars-mcp
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 0.3.0
- Last commit
- Nov 10, 2026
- License
- MIT
What is TransparentCars MCP?
TransparentCars lets AI assistants search used car inventory in Portugal, evaluate price fairness, and calculate import or road tax costs. It exposes 13 tools, such as search_inventory, get_car, check_fair_price.
Summary generated from the project's README
About TransparentCars MCP server
TransparentCars provides an interface for AI assistants to interact with used car inventory in Portugal and manage vehicle import logistics. Users can search live stock by specific criteria like fuel type, gearbox, or price, and retrieve detailed specifications for individual vehicles. The server functions as a thin wrapper over a public API, meaning it requires no API keys or complex setup beyond adding the server to a client.
Developers can deploy this via stdio using npx for local tools like Claude Desktop or via a remote HTTP connection. The server includes specialized tools to calculate Portuguese road taxes, registration fees, and the total cost of importing a vehicle from Germany. It also features a fair-price check tool that compares asking prices against market ranges to provide a verdict on whether a deal is above or below market value.
What you can do with it
- 1Search local car inventoryFind a specific type of vehicle within the current Portuguese stock based on budget and technical requirements.
- 2Evaluate vehicle pricingDetermine if a specific car listing is priced fairly compared to the current market range.
- 3Calculate import expensesWork out the total financial requirement for bringing a car from Germany into Portugal.
- 4Estimate annual ownership costsFind out the yearly road tax amount for a specific vehicle configuration.
Written from the project's README. Every use case is checked against a quote from it.
How to install TransparentCars MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall TransparentCars MCP in Claude Code
$ claude mcp add mcp -- npx -y transparentcars-mcpInstall TransparentCars MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"transparentcars-mcp"
]
}
}
}Install TransparentCars MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"transparentcars-mcp"
]
}
}
}Install TransparentCars MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","transparentcars-mcp"]}'Install TransparentCars MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"transparentcars-mcp"
]
}
}
}Install TransparentCars MCP in Codex
$ codex mcp add mcp -- npx -y transparentcars-mcpInstall TransparentCars MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "transparentcars-mcp"]
Install TransparentCars MCP in Gemini CLI
$ gemini mcp add -s user mcp npx -- -y transparentcars-mcpInstall TransparentCars MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"transparentcars-mcp"
]
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for transparentcars-mcp 0.3.0 in an isolated container with no network and no keys. It answered and listed 13 tools.
TransparentCars MCP tools 13
Read from the server with tools/listsearch_inventorySearch TransparentCars' current stock of budget used cars in Portugal — honestly listed, everyday cars for the local market. Filter by make, model, fuel, gearbox and max price. Returns matching cars with price, year, mileage and a link. IMPORTANT — pass make/model canonically in Latin, as the Portuguese market lists them: make = full brand name ('BMW', 'Mercedes-Benz' not 'Mercedes', 'Volkswagen' not 'VW'); model = the short series/model WITHOUT the engine or trim suffix ('Golf' not 'Golf 1.5 TSI', 'Clio' not 'Clio dCi'). Put the fuel in the fuel field, not the model. If unsure of the spelling, call list_makes_models first.
get_carGet full details for one car in TransparentCars stock by its slug (from a search_inventory link, e.g. 'renault-clio-2016').
check_fair_priceCheck whether a car's asking price is fair for the Portuguese market — the TransparentCars transparency check. Given make, model, year and mileage, it returns the range comparable cars actually sell for (low / typical / high), built from real listings. If you pass asking_price, it also gives a plain verdict: fair, above market, or below market — so a buyer knows before they walk in. Works for ANY car (a listing you found elsewhere, or one of ours). IMPORTANT — pass make/model canonically in Latin: make = full brand name ('Renault', 'Volkswagen' not 'VW'); model = short name WITHOUT engine/trim ('Clio' not 'Clio dCi', 'Golf' not 'Golf 1.5 TSI'). If unsure of spelling, call list_makes_models first.
cost_to_ownEstimate a car's yearly running-cost floor in Portugal — the annual IUC road tax (Imposto Único de Circulação) every owner pays, plus a plain running-cost framing. Needs engine displacement (cc), CO₂ (g/km), fuel and first-registration year. Use this to help a buyer budget the true cost of keeping a car, beyond the sticker price.
list_makes_modelsList the exact canonical car makes (brands) TransparentCars can search and price — or, given a make, that brand's models — using the exact strings the other tools expect. Call this FIRST (or whenever unsure of spelling) and pass the returned values verbatim into search_inventory / check_fair_price. No make = the list of brands; with a make = that brand's models.
contact_meSend a contact request to TransparentCars so a human gets in touch. Only call this when the user explicitly asks to be contacted, provides their own name and a phone or email, AND agrees to share those details — pass consent=true only then. Never invent, guess, or use placeholder / example / test contact details: pass ONLY the real name and real phone or e-mail the user gave you in this conversation. If you don't have a real phone or e-mail from the user, ask them for it before calling — do not submit fake values. Submitting shares the provided contact details per the TransparentCars privacy policy.
calculate_isvEstimate Portuguese car import tax (ISV, Imposto Sobre Veículos) from the official ISV formula (engine-cc + CO₂ components, with age reduction for used cars). A maintained estimate: it matches the AT (Finanças) simulator to the cent on the common WLTP cases, but is not the official figure and may differ on edge cases (NEDC, light-commercial, month rounding) — confirm the final amount on the official AT simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year.
calculate_import_costFull turnkey cost of importing a car from Germany / another EU country (e.g. a mobile.de or AutoScout24 listing) to Portugal through TransparentCars: car price + transport + paperwork (inspection, IMT, plates) + TransparentCars service + ISV, as one total, with the yearly IUC road tax shown apart. Handles net/gross VAT: if the dealer listing shows deductible VAT (two prices, e.g. '€36,958 Net, 19% VAT' / 'MwSt. ausweisbar'), pass vat='gross' — the German VAT is removed and Portuguese IVA 23% applied to the net price. Private sellers / margin-scheme cars: vat='final'. An estimate (final ISV is set by the tax authority from the COC). For the tax alone use calculate_isv.
calculate_legalization_costCost of legalising a car that is ALREADY in Portugal (registered in another EU country, brought in by the owner) through TransparentCars: a fixed service fee + ISV + state fees (inspection, IMT, registration, DUA, plates) + the COC if it is missing, returned as a low/high range. Only the service fee is TransparentCars' price; ISV, state fees and the COC are paid separately at real cost against official receipts. Also returns exactly what the fee includes and what it doesn't. Use this when the user already has the car; for buying and importing a car use calculate_import_cost.
calculate_iucEstimate the Portuguese annual road tax (IUC, Imposto Único de Circulação) for a car — the yearly tax an owner pays — from the official IUC table. A maintained estimate; confirm on the official AT simulator. Needs engine displacement (cc), CO₂ (g/km), fuel and registration year.
estimate_resale_valueEstimate what a car is worth on the Portuguese market (the range comparable cars are listed for), based on real comparable listings. Needs make, model, year, mileage and fuel. TransparentCars also BUYS cars directly — after giving the estimate, offer to connect the user for a firm buy-out offer (via contact_me or the /sell page). IMPORTANT — pass make/model canonically in Latin, as the Portuguese market lists them: make = full brand name ('BMW', 'Mercedes-Benz' not 'Mercedes', 'Volkswagen' not 'VW'); model = the short series/model WITHOUT the engine or trim suffix (BMW: '320','330' not '320d'; Mercedes: 'C 220','A 250' not 'C220d'; others: 'Golf','Corolla','3008'). If unsure of the spelling, call list_makes_models first.
list_servicesList what TransparentCars offers (buying stock cars, importing to order, sourcing, auction buying, selling/trading in your car, ISV/IUC calculators).
Show all 13 toolsShow fewer tools
request_import_quoteAsk TransparentCars to source & quote a specific car to import (from German/EU auctions). Only call when the user wants an import quote, provides the wanted model plus their own name and a phone or email, AND agrees to be contacted — pass consent=true only then. Never invent, guess, or use placeholder / example / test contact details: pass ONLY the real name and real phone or e-mail the user gave you in this conversation. If you don't have a real phone or e-mail from the user, ask them for it before calling — do not submit fake values. Submitting shares the provided contact details per the TransparentCars privacy policy.
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachabletransparentpt/mcp is public and reachablegithub.com/transparentpt/mcp ↗Pass
- Package names this repository as its sourcetransparentcars-mcp names transparentpt/mcp as sourcenpmjs.com/package/transparentcars-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-11github.com/transparentpt/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from transparentcars-mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model13 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 81 msPass
README
View on GitHubTransparentCars MCP server
An MCP server that lets AI assistants work with TransparentCars — honest used cars in Portugal, and cars imported from Germany to order. Search live stock, check whether a car's asking price is actually fair, work out Portuguese car taxes and the full cost of importing a car from Germany, 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) |
calculate_isv |
Portuguese ISV (registration/import tax) from cc, CO₂, fuel and year |
calculate_import_cost |
Full cost of importing a car from Germany/EU to Portugal: car (net/gross VAT handled), transport, paperwork, service and ISV in one total, IUC/year apart |
calculate_legalization_cost |
Cost to legalise a car already in Portugal: fixed service fee + ISV + state fees (+ COC if missing), with what's included and what's paid separately |
calculate_iuc |
Annual IUC road tax |
estimate_resale_value |
Market value range for a car you own |
list_services |
What TransparentCars does (stock, import, sourcing, auctions, trade-in, calculators) |
request_import_quote |
Ask for a firm import quote for a specific car (needs consent + real 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
TransparentCars MCP questions
How do I add TransparentCars MCP to Claude Code?
Run claude mcp add mcp -- npx -y transparentcars-mcp in your terminal. Add --scope user to make it available in every project.
How do I add TransparentCars MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does TransparentCars MCP provide?
It exposes 13 tools, including search_inventory, get_car, check_fair_price, cost_to_own, list_makes_models.
How do I use the fair-price check?
You can paste a car listing's price to receive a verdict on whether it is fair, above-market, or below-market.
Does this server require an API key?
No, it is a thin wrapper over a public API that requires no keys or complex setup.
Are the price and tax figures guaranteed?
No, the figures provided for fair-price ranges and running costs are estimates intended for guidance rather than formal valuations.