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?

Install io.github.claracarspt/mcp via npm from https://registry.npmjs.org, then add the server config to your MCP client (Claude Desktop, Cursor, or VS Code).

Is io.github.claracarspt/mcp open source?

Yes, io.github.claracarspt/mcp is open source under the MIT license. Source code is available at https://github.com/claracarspt/mcp.

What category does io.github.claracarspt/mcp belong to?

io.github.claracarspt/mcp is listed under Developer Tools MCP servers on MCPFind.

io.github.claracarspt/mcp — MCP Server for Developer Tools

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

Tool	What it does
`search_inventory`	Search current stock by make, model, fuel, price, year
`get_car`	Full details + specs for one car
`calculate_isv`	Estimate Portuguese car import tax (ISV)
`calculate_iuc`	Estimate Portuguese annual road tax (IUC)
`list_makes_models`	Canonical brand/model names the other tools expect
`estimate_resale_value`	Market value range for a car in Portugal
`list_services`	What Clara Carros offers
`contact_me`	Ask a human to get in touch (needs the user's consent + contact)
`request_import_quote`	Ask 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 var	Default	Purpose
`CLARACARS_API_BASE`	`https://claracars.pt/api/public`	Public API base
`CLARACARS_LANG`	`en`	Response language (pt/en/ru/ua)
`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 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.

Set up in your AI client

AI clientOperating system

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Compatible MCP Clients

io.github.claracarspt/mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.

Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.

VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.

Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.

Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

io.github.claracarspt/mcp