Skip to content
MCP server

MCP

Fair-price check, tax and import calculators, and stock search for Portuguese used cars

Install
Pricing
Open source
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.3.0
Listing updated
3 days ago

About MCP

MCP is an open-source MCP server for e-commerce. It can run locally on your machine or as a hosted remote server.

TransparentCars sells budget used cars in Portugal and imports cars from Germany to order, and this server wraps its public API with no key needed. Its headline tool is a fair-price check: paste an asking price and get a market range plus a fair, above-market or below-market verdict. The README stresses these figures are estimates built from comparable listings and the official road-tax table, not a formal valuation.

The Portugal-specific calculators are what set it apart: calculate_isv for registration or import tax from engine size, CO2, fuel and year, calculate_iuc for annual road tax, calculate_import_cost for a total landed cost from Germany or the EU, and calculate_legalization_cost for a car already in Portugal. search_inventory and get_car query current stock.

Two tools send details to the company, contact_me and request_import_quote, and both need the user's consent and real contact information. It runs remotely at transparent.pt/mcp or locally over stdio with the transparentcars-mcp npm package; responses can be in Portuguese or English.

Install

Run in a terminal

claude mcp add --transport http mcp https://transparent.pt/mcp

Add to Settings → Connectors → Add custom connector

https://transparent.pt/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://transparent.pt/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://transparent.pt/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://transparent.pt/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://transparent.pt/mcp"
    }
  }
}

Tools this server provides (13)

Read directly from the server.

search_inventory
Search 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'
get_car
Get full details for one car in TransparentCars stock by its slug (from a search_inventory link, e.g. 'renault-clio-2016').
check_fair_price
Check 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
cost_to_own
Estimate 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_models
List 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_me
Send 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 conversati
calculate_isv
Estimate 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 offici
calculate_import_cost
Full 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%
calculate_legalization_cost
Cost 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 off
calculate_iuc
Estimate 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_value
Estimate 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
list_services
List what TransparentCars offers (buying stock cars, importing to order, sourcing, auction buying, selling/trading in your car, ISV/IUC calculators).
request_import_quote
Ask 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

What it does

Fair-price verdict
Compares an asking price to the market range for a car.
Portuguese tax calculators
ISV registration tax and annual IUC road tax.
Import cost total
Car, transport, paperwork, service and ISV in one figure.
Stock search
Filter live stock by make, model, fuel, gearbox, price and year.
Resale estimate
Market value range for a car you own.
Consent-gated contact
Contact and quote requests require explicit user consent.

Good for

  • Check whether a dealer's asking price is fair
  • Work out the yearly IUC on a specific car
  • Estimate the full cost of importing a car from Germany
  • Find a manual petrol car under a budget in stock

Pricing

Open source

Free, MIT licence

Prices change. Check transparent.pt before you buy.

MCP FAQ

Do I need an API key?

No. The README says there are no keys and no setup beyond adding the server.

How accurate are the price ranges?

The README calls them estimates from comparable listings and says to treat them as guidance, not a formal valuation.

Can it run locally?

Yes, over stdio with npx -y transparentcars-mcp, or remotely at transparent.pt/mcp.

What language are responses in?

Portuguese or English, set by TC_LANG, defaulting to English.

Is MCP free?

Yes. MCP is open source, so you can use and self-host it for free.

How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://transparent.pt/mcp

What are the best alternatives to MCP?

The closest alternatives to MCP are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, O'So MCP Server for PrestaShop, Budget Tracker and SecureCloud.

Alternatives to MCP

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  4. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  6. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce