io.github.transparentpt/mcp is an MCP server published by io.github.transparentpt, hosted at transparent.pt. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 13 tools, including search_inventory, get_car, check_fair_price, cost_to_own, list_makes_models.
Budget used cars in Portugal: fair-price check, running-cost (IUC) estimate, stock search, contact.
1 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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' 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.
| Parameter | Type | Description |
|---|---|---|
| fuel | string | Fuel: petrol, diesel, hybrid, phev, electric, lpg |
| make | string | Full brand name in Latin, as the market lists it — 'Renault', 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'. |
| limit | integer | Max results (default 20) |
| model | string | Short model name WITHOUT engine or trim — 'Clio' (not 'Clio 1.5 dCi'), 'Golf' (not 'Golf TSI'). |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| gearbox | string | Gearbox: manual or automatic |
| min_year | number | Earliest registration year |
| max_price | number | Maximum price in EUR |
{
"name": "search_inventory",
"description": "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' 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, phev, electric, lpg"
},
"make": {
"type": "string",
"description": "Full brand name in Latin, as the market lists it — 'Renault', 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Max results (default 20)"
},
"model": {
"type": "string",
"description": "Short model name WITHOUT engine or trim — 'Clio' (not 'Clio 1.5 dCi'), 'Golf' (not 'Golf TSI')."
},
"gearbox": {
"type": "string",
"description": "Gearbox: manual or automatic"
},
"min_year": {
"type": "number",
"description": "Earliest registration year"
},
"max_price": {
"type": "number",
"description": "Maximum price in EUR"
}
},
"additionalProperties": false
}
}Get full details for one car in TransparentCars stock by its slug (from a search_inventory link, e.g. 'renault-clio-2016').
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Car slug from a search_inventory result URL |
{
"name": "get_car",
"description": "Get full details for one car in TransparentCars stock by its slug (from a search_inventory link, e.g. 'renault-clio-2016').",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Car slug from a search_inventory result URL"
}
},
"additionalProperties": false
}
}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 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.
| Parameter | Type | Description |
|---|---|---|
| hp | integer | Power in hp (sharpens the comparison) |
| km * | integer | Mileage in km |
| fuel | string | Fuel: petrol, diesel, hybrid, electric |
| make * | string | Full brand name in Latin — 'Renault', 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'. |
| year * | integer | Registration year |
| model * | string | Short model name WITHOUT engine or trim — 'Clio' (not 'Clio 1.5 dCi'), 'Golf' (not 'Golf TSI'). |
| gearbox | string | Gearbox: manual or automatic |
| asking_price | number | The price being asked for THIS car, in EUR — pass it to get a fair / above-market / below-market verdict. |
{
"name": "check_fair_price",
"description": "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 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"make",
"model",
"year",
"km"
],
"properties": {
"hp": {
"type": "integer",
"description": "Power in hp (sharpens the comparison)"
},
"km": {
"type": "integer",
"description": "Mileage in km"
},
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, electric"
},
"make": {
"type": "string",
"description": "Full brand name in Latin — 'Renault', 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'."
},
"year": {
"type": "integer",
"description": "Registration year"
},
"model": {
"type": "string",
"description": "Short model name WITHOUT engine or trim — 'Clio' (not 'Clio 1.5 dCi'), 'Golf' (not 'Golf TSI')."
},
"gearbox": {
"type": "string",
"description": "Gearbox: manual or automatic"
},
"asking_price": {
"type": "number",
"description": "The price being asked for THIS car, in EUR — pass it to get a fair / above-market / below-market verdict."
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| cc * | integer | Engine displacement in cm³, e.g. 1200 |
| co2 * | number | CO₂ emissions in g/km, e.g. 120 |
| fuel * | string | Fuel: petrol, diesel, hybrid, phev, electric, lpg |
| used | boolean | Used vehicle (true, default) |
| year * | integer | First registration year, e.g. 2016 |
| month | integer | First-registration month (1-12), refines the CO₂ regime |
{
"name": "cost_to_own",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cc",
"co2",
"fuel",
"year"
],
"properties": {
"cc": {
"type": "integer",
"description": "Engine displacement in cm³, e.g. 1200"
},
"co2": {
"type": "number",
"description": "CO₂ emissions in g/km, e.g. 120"
},
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, phev, electric, lpg"
},
"used": {
"type": "boolean",
"description": "Used vehicle (true, default)"
},
"year": {
"type": "integer",
"description": "First registration year, e.g. 2016"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "First-registration month (1-12), refines the CO₂ regime"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| make | string | Brand to list models for, e.g. 'Renault'. Omit to get the list of brands. |
{
"name": "list_makes_models",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"make": {
"type": "string",
"description": "Brand to list models for, e.g. 'Renault'. Omit to get the list of brands."
}
},
"additionalProperties": false
}
}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 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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The person's name (as they gave it) |
| consent * | boolean | Set true ONLY if the user explicitly agreed to share their contact details and be contacted |
| contact * | string | A phone number or email where they can be reached |
| message | string | What they want / their question |
{
"name": "contact_me",
"description": "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 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"name",
"contact",
"consent"
],
"properties": {
"name": {
"type": "string",
"description": "The person's name (as they gave it)"
},
"consent": {
"type": "boolean",
"description": "Set true ONLY if the user explicitly agreed to share their contact details and be contacted"
},
"contact": {
"type": "string",
"description": "A phone number or email where they can be reached"
},
"message": {
"type": "string",
"description": "What they want / their question"
}
},
"additionalProperties": false
}
}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 official AT simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year.
| Parameter | Type | Description |
|---|---|---|
| cc | integer | Engine displacement in cm³, e.g. 1950 (not needed for heavy goods/buses) |
| co2 | number | CO₂ emissions in g/km (WLTP), e.g. 130 (passenger/motorhome only) |
| fuel | string | Fuel: petrol, diesel, hybrid, hybrid_diesel (diesel MHEV/HEV), phev, electric (irrelevant for heavy goods/buses) |
| used | boolean | Used vehicle (true, default) or new (false) |
| year * | integer | First registration year, e.g. 2016 |
| axles | integer | Heavy rigid goods ≥12t: axles (2/3/4). |
| config | string | Heavy goods ≥12t: rigido or articulado (tractor+trailer). |
| from_eu | boolean | Registered in an EU member state (true, default). Set FALSE for non-EU imports (Switzerland, UK, USA, Japan…) — non-EU used cars get NO age reduction, so the ISV is the FULL amount (plus customs duty ~10% and VAT 23%, which this tool does not compute). |
| peso_bruto | integer | Gross weight (kg). REQUIRED for goods vehicles (van_10/commercial_*/pesados_mercadorias): their IUC is weight-based (Cat C/D). |
| suspension | string | Heavy goods ≥12t: driven-axle suspension. |
| utilizacao | string | Goods use: particular (Cat C, default) or publico/rental (Cat D). |
| vehicle_type | string | Category (default passenger). Goods van → van_10/commercial_*; heavy goods >3500kg → pesados_mercadorias; bus → pesados_passageiros; motorhome → autocaravana; motorcycle → motorcycle. |
| tractor_axles | integer | Articulated ≥12t: tractor axles (2/3). |
| trailer_axles | integer | Articulated ≥12t: trailer axles (1/2/3). |
| regiao_autonoma | boolean | Used exclusively in Açores/Madeira → −50% IUC (Cat C/D). |
{
"name": "calculate_isv",
"description": "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 official AT simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year"
],
"properties": {
"cc": {
"type": "integer",
"description": "Engine displacement in cm³, e.g. 1950 (not needed for heavy goods/buses)"
},
"co2": {
"type": "number",
"description": "CO₂ emissions in g/km (WLTP), e.g. 130 (passenger/motorhome only)"
},
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, hybrid_diesel (diesel MHEV/HEV), phev, electric (irrelevant for heavy goods/buses)"
},
"used": {
"type": "boolean",
"description": "Used vehicle (true, default) or new (false)"
},
"year": {
"type": "integer",
"description": "First registration year, e.g. 2016"
},
"axles": {
"type": "integer",
"description": "Heavy rigid goods ≥12t: axles (2/3/4)."
},
"config": {
"enum": [
"rigido",
"articulado"
],
"type": "string",
"description": "Heavy goods ≥12t: rigido or articulado (tractor+trailer)."
},
"from_eu": {
"type": "boolean",
"description": "Registered in an EU member state (true, default). Set FALSE for non-EU imports (Switzerland, UK, USA, Japan…) — non-EU used cars get NO age reduction, so the ISV is the FULL amount (plus customs duty ~10% and VAT 23%, which this tool does not compute)."
},
"peso_bruto": {
"type": "integer",
"description": "Gross weight (kg). REQUIRED for goods vehicles (van_10/commercial_*/pesados_mercadorias): their IUC is weight-based (Cat C/D)."
},
"suspension": {
"enum": [
"pneumatica",
"outro"
],
"type": "string",
"description": "Heavy goods ≥12t: driven-axle suspension."
},
"utilizacao": {
"enum": [
"particular",
"publico"
],
"type": "string",
"description": "Goods use: particular (Cat C, default) or publico/rental (Cat D)."
},
"vehicle_type": {
"enum": [
"passenger",
"van_10",
"commercial_15",
"commercial_50",
"commercial_100",
"motorcycle",
"autocaravana",
"pesados_mercadorias",
"pesados_passageiros"
],
"type": "string",
"description": "Category (default passenger). Goods van → van_10/commercial_*; heavy goods >3500kg → pesados_mercadorias; bus → pesados_passageiros; motorhome → autocaravana; motorcycle → motorcycle."
},
"tractor_axles": {
"type": "integer",
"description": "Articulated ≥12t: tractor axles (2/3)."
},
"trailer_axles": {
"type": "integer",
"description": "Articulated ≥12t: trailer axles (1/2/3)."
},
"regiao_autonoma": {
"type": "boolean",
"description": "Used exclusively in Açores/Madeira → −50% IUC (Cat C/D)."
}
},
"additionalProperties": false
}
}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% 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.
| Parameter | Type | Description |
|---|---|---|
| cc | integer | Engine displacement in cm³ (0 for electric) |
| co2 | number | CO₂ g/km (WLTP) |
| vat | string | How to read price: final (default; private seller / margin scheme, no VAT line), gross (dealer price incl. deductible seller-country VAT), net (price without VAT) |
| fuel | string | petrol, diesel, hybrid, hybrid_diesel, phev, electric, lpg |
| used | boolean | Used (true, default) or new (false: up to 6 months / 6,000 km) |
| year * | integer | First registration year, e.g. 2021 |
| month | integer | First registration month 1-12 |
| price * | number | Price on the listing in EUR, e.g. 19500 |
| range_km | integer | Electric range in km (plug-in hybrids: >=50 km gives the 75% ISV reduction) |
| vat_rate | number | Seller-country VAT % for vat=gross (DE 19 default, AT 20, IT 22, ES 21, FR 20, NL 21, BE 21) |
{
"name": "calculate_import_cost",
"description": "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% 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"price",
"year"
],
"properties": {
"cc": {
"type": "integer",
"description": "Engine displacement in cm³ (0 for electric)"
},
"co2": {
"type": "number",
"description": "CO₂ g/km (WLTP)"
},
"vat": {
"enum": [
"final",
"gross",
"net"
],
"type": "string",
"description": "How to read price: final (default; private seller / margin scheme, no VAT line), gross (dealer price incl. deductible seller-country VAT), net (price without VAT)"
},
"fuel": {
"type": "string",
"description": "petrol, diesel, hybrid, hybrid_diesel, phev, electric, lpg"
},
"used": {
"type": "boolean",
"description": "Used (true, default) or new (false: up to 6 months / 6,000 km)"
},
"year": {
"type": "integer",
"description": "First registration year, e.g. 2021"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "First registration month 1-12"
},
"price": {
"type": "number",
"description": "Price on the listing in EUR, e.g. 19500",
"exclusiveMinimum": 0
},
"range_km": {
"type": "integer",
"description": "Electric range in km (plug-in hybrids: >=50 km gives the 75% ISV reduction)"
},
"vat_rate": {
"type": "number",
"description": "Seller-country VAT % for vat=gross (DE 19 default, AT 20, IT 22, ES 21, FR 20, NL 21, BE 21)"
}
},
"additionalProperties": false
}
}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 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.
| Parameter | Type | Description |
|---|---|---|
| cc | integer | Engine displacement in cm³ (0 for electric) |
| co2 | number | CO₂ g/km (WLTP) |
| fuel | string | petrol, diesel, hybrid, hybrid_diesel, phev, electric, lpg |
| year * | integer | First registration year, e.g. 2019 |
| month | integer | First registration month 1-12 |
| has_coc | boolean | Does the car have its COC (certificate of conformity)? Default true; false adds the COC cost range |
| range_km | integer | Electric range in km (plug-in hybrids) |
{
"name": "calculate_legalization_cost",
"description": "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 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year"
],
"properties": {
"cc": {
"type": "integer",
"description": "Engine displacement in cm³ (0 for electric)"
},
"co2": {
"type": "number",
"description": "CO₂ g/km (WLTP)"
},
"fuel": {
"type": "string",
"description": "petrol, diesel, hybrid, hybrid_diesel, phev, electric, lpg"
},
"year": {
"type": "integer",
"description": "First registration year, e.g. 2019"
},
"month": {
"type": "integer",
"maximum": 12,
"minimum": 1,
"description": "First registration month 1-12"
},
"has_coc": {
"type": "boolean",
"description": "Does the car have its COC (certificate of conformity)? Default true; false adds the COC cost range"
},
"range_km": {
"type": "integer",
"description": "Electric range in km (plug-in hybrids)"
}
},
"additionalProperties": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| cc | integer | Engine displacement in cm³, e.g. 1950 (not needed for goods vehicles) |
| co2 | number | CO₂ emissions in g/km, e.g. 130 (passenger/motorhome only) |
| fuel | string | Fuel: petrol, diesel, hybrid, hybrid_diesel (diesel MHEV/HEV), phev, electric (irrelevant for heavy goods/buses) |
| year * | integer | First registration year, e.g. 2016 |
| axles | integer | Heavy rigid goods ≥12t: axles (2/3/4). |
| config | string | Heavy goods ≥12t: rigido or articulado (tractor+trailer). |
| peso_bruto | integer | Gross weight (kg). REQUIRED for goods vehicles (van_10/commercial_*/pesados_mercadorias): their IUC is weight-based (Cat C/D). |
| suspension | string | Heavy goods ≥12t: driven-axle suspension. |
| utilizacao | string | Goods use: particular (Cat C, default) or publico/rental (Cat D). |
| vehicle_type | string | Category (default passenger). Goods van → van_10/commercial_*; heavy goods >3500kg → pesados_mercadorias; bus → pesados_passageiros; motorhome → autocaravana; motorcycle → motorcycle. |
| tractor_axles | integer | Articulated ≥12t: tractor axles (2/3). |
| trailer_axles | integer | Articulated ≥12t: trailer axles (1/2/3). |
| regiao_autonoma | boolean | Used exclusively in Açores/Madeira → −50% IUC (Cat C/D). |
{
"name": "calculate_iuc",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"year"
],
"properties": {
"cc": {
"type": "integer",
"description": "Engine displacement in cm³, e.g. 1950 (not needed for goods vehicles)"
},
"co2": {
"type": "number",
"description": "CO₂ emissions in g/km, e.g. 130 (passenger/motorhome only)"
},
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, hybrid_diesel (diesel MHEV/HEV), phev, electric (irrelevant for heavy goods/buses)"
},
"year": {
"type": "integer",
"description": "First registration year, e.g. 2016"
},
"axles": {
"type": "integer",
"description": "Heavy rigid goods ≥12t: axles (2/3/4)."
},
"config": {
"enum": [
"rigido",
"articulado"
],
"type": "string",
"description": "Heavy goods ≥12t: rigido or articulado (tractor+trailer)."
},
"peso_bruto": {
"type": "integer",
"description": "Gross weight (kg). REQUIRED for goods vehicles (van_10/commercial_*/pesados_mercadorias): their IUC is weight-based (Cat C/D)."
},
"suspension": {
"enum": [
"pneumatica",
"outro"
],
"type": "string",
"description": "Heavy goods ≥12t: driven-axle suspension."
},
"utilizacao": {
"enum": [
"particular",
"publico"
],
"type": "string",
"description": "Goods use: particular (Cat C, default) or publico/rental (Cat D)."
},
"vehicle_type": {
"enum": [
"passenger",
"van_10",
"commercial_15",
"commercial_50",
"commercial_100",
"motorcycle",
"autocaravana",
"pesados_mercadorias",
"pesados_passageiros"
],
"type": "string",
"description": "Category (default passenger). Goods van → van_10/commercial_*; heavy goods >3500kg → pesados_mercadorias; bus → pesados_passageiros; motorhome → autocaravana; motorcycle → motorcycle."
},
"tractor_axles": {
"type": "integer",
"description": "Articulated ≥12t: tractor axles (2/3)."
},
"trailer_axles": {
"type": "integer",
"description": "Articulated ≥12t: trailer axles (1/2/3)."
},
"regiao_autonoma": {
"type": "boolean",
"description": "Used exclusively in Açores/Madeira → −50% IUC (Cat C/D)."
}
},
"additionalProperties": false
}
}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 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.
| Parameter | Type | Description |
|---|---|---|
| km * | integer | Mileage in km |
| fuel | string | Fuel: petrol, diesel, hybrid, electric |
| make * | string | Full brand name in Latin, e.g. 'BMW', 'Mercedes-Benz', 'Volkswagen', 'Peugeot'. |
| year * | integer | Registration year |
| model * | string | Short model/series WITHOUT engine or trim. BMW: '320','330','116'. Mercedes: 'C 220','E 220','A 250'. Others: 'Golf','Corolla','3008'. |
{
"name": "estimate_resale_value",
"description": "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 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"make",
"model",
"year",
"km"
],
"properties": {
"km": {
"type": "integer",
"description": "Mileage in km"
},
"fuel": {
"type": "string",
"description": "Fuel: petrol, diesel, hybrid, electric"
},
"make": {
"type": "string",
"description": "Full brand name in Latin, e.g. 'BMW', 'Mercedes-Benz', 'Volkswagen', 'Peugeot'."
},
"year": {
"type": "integer",
"description": "Registration year"
},
"model": {
"type": "string",
"description": "Short model/series WITHOUT engine or trim. BMW: '320','330','116'. Mercedes: 'C 220','E 220','A 250'. Others: 'Golf','Corolla','3008'."
}
},
"additionalProperties": false
}
}List what TransparentCars offers (buying stock cars, importing to order, sourcing, auction buying, selling/trading in your car, ISV/IUC calculators).
No parameters.
{
"name": "list_services",
"description": "List what TransparentCars offers (buying stock cars, importing to order, sourcing, auction buying, selling/trading in your car, ISV/IUC calculators).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}
}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 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.
| Parameter | Type | Description |
|---|---|---|
| name * | string | The person's name |
| model * | string | Wanted car, e.g. 'BMW 320d Touring 2021' |
| budget | number | Budget in EUR |
| consent * | boolean | Set true ONLY if the user explicitly agreed to share their contact details and be contacted |
| contact * | string | A phone number or email where they can be reached |
{
"name": "request_import_quote",
"description": "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 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.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"model",
"name",
"contact",
"consent"
],
"properties": {
"name": {
"type": "string",
"description": "The person's name"
},
"model": {
"type": "string",
"description": "Wanted car, e.g. 'BMW 320d Touring 2021'"
},
"budget": {
"type": "number",
"description": "Budget in EUR"
},
"consent": {
"type": "boolean",
"description": "Set true ONLY if the user explicitly agreed to share their contact details and be contacted"
},
"contact": {
"type": "string",
"description": "A phone number or email where they can be reached"
}
},
"additionalProperties": false
}
}Names, descriptions and schemas were written by the server and are shown as data.