Clara Carros - used & imported cars in Portugal

by claracarspt

182 downloads

Not rated

GitHub Website

Other
API

About

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

Details

Author: claracarspt
Downloads: 182
Categories: Other, API

- "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 …"
- No business logic or data lives in this repo — it only calls the public API

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Clara Carros - used & imported cars in Portugal

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

From the repository

The README includes setup instructions such as "command": "npx",.

`search_inventory`

Search Clara Carros' current stock of used cars in Portugal. Filter by make, model, fuel, max price and min year. 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 — 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'); other brands: plain model name ('Golf','Corolla','3008', not 'Golf 1.5 TSI'). Put the engine/fuel in the fuel field, not the model. If unsure of the exact spelling, call list_makes_models first.

`get_car`

Get full details for one car by its slug (from search_inventory links, e.g. 'mercedes-benz-e-klasse-2016').

`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 official AT simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year.

`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.

`list_makes_models`

List the exact canonical car makes (brands) Clara Carros can value/find — or, given a make, that brand's models — using the exact strings the other tools expect. Call this FIRST (or whenever unsure of the spelling) and pass the returned values verbatim into estimate_resale_value / search_inventory. No make = the list of brands; with a make = that brand's models.

`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. Clara Carros 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: series number only ('320','330','116', not '330e'/'320d'/'3 Series'); Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'); other brands: plain model name ('Golf','Corolla','3008', not 'Golf 1.5 TSI'). Put the engine/fuel in the fuel field, not the model. If unsure of the exact spelling, call list_makes_models first.

`list_services`

List what Clara Carros offers (buying stock cars, importing to order, sourcing, auction buying, selling your car, ISV calculator).

`contact_me`

Send a contact request to Clara Carros so a human gets in touch. Only call this when the user explicitly asks to be contacted, provides their own name and phone or email, AND agrees to share those details with Clara Carros — pass consent=true only then. Submitting shares the provided contact details per Clara Carros' privacy policy.

`request_import_quote`

Ask Clara Carros 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 phone or email, AND agrees to be contacted — pass consent=true only then. Submitting shares the provided contact details per Clara Carros' privacy policy.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "clara carros - used & imported cars in portugal": {
            "claracars": {
                "url": "https://claracars.pt/mcp"
            }
        }
    }
}

McpServers

{
    "claracars": {
        "url": "https://claracars.pt/mcp"
    }
}

Clara Carros — used & imported cars in Portugal (ISV/IUC, live stock, resale)

Thin, open-source (MIT) wrapper over the public claracars.pt API — no API keys, no auth, no setup. Remote (recommended): https://claracars.pt/mcp (streamable-http) or npx claracars-mcp

AnMCPserver that lets AI assistants work withClara 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 publicclaracars.ptAPI — no keys, no setup beyond adding the server.

Cline / one-click install:see llms-install.md— the machine-readable setup guide.

Add it in any client that supports remote/Streamable HTTP MCP servers.

Claude Desktop / Cline / Continue config:

{ "mcpServers": { "claracars": { "command": "npx", "args": ["-y", "claracars-mcp"] } } }

npm install npm run build node dist/index.js # stdio npm run start:http # remote HTTP on :8099/mcp

- 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.

- Calculators:the ISV/IUC tax logic this server calls is open-source at claracarspt/calcs— a zero-dependency Python library + key-free API.

API marketplace giving AI agents instant access to 100 services (web search, image gen, code sandbox, TTS, NASA, recipes, Pokemon, and 90+ more) through a single MCP server. One API key, $1.00 free credits, 87 free services.

Global postal code lookups, validation, and city search for 70+ countries. Sub-10ms responses.

Connect to any financial, utility, billing accounts; retrieve balance, transactions, payment and identity data instantly.

MCP server for 402 Index: discover 15,000+ paid API endpoints across L402, x402, and MPP

A healthcare MCP server for EMRs like Cerner and Epic, providing tools to interact with FHIR data and medical resources.

AI agent API marketplace-discover, call, and pay for services with USDC payments. List your own AI services and earn money per call.

65+ AI tools as an MCP server. Research, write, code, scrape, translate, analyze, agent memory, workflows. Pay per call from $0.006.

Real-time flight tracking, airport schedules, delays, and reference data for airlines, airports, aircraft, and routes via the AirLabs API.

MCP server that connects to the Airplanes.live API to provide real-time flight and aircraft data for analysis or visualization.

A Model Context Protocol (MCP) server that provides comprehensive access to the ALMA (Atacama Large Millimeter/submillimeter Array) archive through a clean, extensible architecture.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

Clara Carros - used & imported cars in Portugal

About

Details

Jump to

Setting up with Highlight

Setting up with Cursor

JSON

JSON

JSON

Setting up with Claude Desktop

JSON

JSON

JSON

Setting up with Windsurf

JSON

JSON

JSON

Setting up with Cline

JSON

JSON

JSON

Setting up with Goose

JSON

JSON

JSON

From the repository

`search_inventory`

`get_car`

`calculate_isv`

`calculate_iuc`

`list_makes_models`

`estimate_resale_value`

`list_services`

`contact_me`

`request_import_quote`

Claude Desktop / Cursor

McpServers

Clara Carros — used & imported cars in Portugal (ISV/IUC, live stock, resale)

Install

About

Details

Jump to

Setting up with Highlight

From the repository

search_inventory

get_car

calculate_isv

calculate_iuc

list_makes_models

estimate_resale_value

list_services

contact_me

request_import_quote

Claude Desktop / Cursor

McpServers

Clara Carros — used & imported cars in Portugal (ISV/IUC, live stock, resale)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

GitLab

Reactive Resume

`search_inventory`

`get_car`

`calculate_isv`

`calculate_iuc`

`list_makes_models`

`estimate_resale_value`

`list_services`

`contact_me`

`request_import_quote`