English Français العربية

io.github.claracarspt/mcp

Official registry Search and web

Used & imported cars in Portugal: search stock, ISV/IUC tax calc, resale value, contact.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-claracarspt-mcp 'https://claracars.pt/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-claracarspt-mcp": {
            "type": "http",
            "url": "https://claracars.pt/mcp"
        }
    }
}
NPM package claracars-mcp
Claude Code 
claude mcp add io-github-claracarspt-mcp -- npx -y claracars-mcp@0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "io-github-claracarspt-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "claracars-mcp@0.1.3"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Clara Carros MCP server
  2. Tools
  3. Use it
  4. Examples
  5. Configuration
  6. Develop
  7. Notes
  8. Related

Clara Carros MCP server

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, open-source wrapper over the public claracars.pt API — no keys, no setup beyond adding the server.

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

Tools

ToolWhat it does
search_inventorySearch current stock by make, model, fuel, price, year
get_carFull details + specs for one car
calculate_isvEstimate Portuguese car import tax (ISV)
calculate_iucEstimate Portuguese annual road tax (IUC)
list_makes_modelsCanonical brand/model names the other tools expect
estimate_resale_valueMarket value range for a car in Portugal
list_servicesWhat Clara Carros offers
contact_meAsk a human to get in touch (needs the user's consent + contact)
request_import_quoteAsk Clara Carros to source & quote a car to import

Use it

Remote (add a URL)
https://claracars.pt/mcp

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

Local (stdio, via npx)

Claude Desktop / Cline / Continue config:

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

Examples

  • "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 …"

Configuration

Env varDefaultPurpose
CLARACARS_API_BASEhttps://claracars.pt/api/publicPublic API base
CLARACARS_LANGenResponse language (pt/en/ru/ua)
PORT / MCP_PATH8099 / /mcpHTTP 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 quotes. ISV and resale figures are estimates; the official ISV is assessed by the Portuguese tax authority.
  • Privacy. contact_me / request_import_quote send 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.

MIT © Clara Carros

Frequently asked questions

What is io.github.claracarspt/mcp?

Used & imported cars in Portugal: search stock, ISV/IUC tax calc, resale value, contact.

How do I install io.github.claracarspt/mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http io-github-claracarspt-mcp 'https://claracars.pt/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.claracarspt/mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.claracarspt/mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.claracarspt/mcp?

It is published by claracarspt. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.