{
  "markdown": "<img src=\"./assets/logo-400.png\" alt=\"Clara Carros\" width=\"96\" align=\"right\" />\n\n# Clara Carros MCP server\n\n[![MCP](https://img.shields.io/badge/MCP-server-blue)](https://modelcontextprotocol.io) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n\nAn [MCP](https://modelcontextprotocol.io) server that lets AI assistants work with **[Clara Carros](https://claracars.pt)** — used & imported cars in Portugal. Search live stock, estimate the Portuguese import tax (**ISV**), estimate a car's resale value, and get in touch.\n\nIt's a thin, open-source wrapper over the public `claracars.pt` API — no keys, no setup beyond adding the server.\n\n> **Cline / one-click install:** see [`llms-install.md`](./llms-install.md) — the machine-readable setup guide.\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `search_inventory` | Search current stock by make, model, fuel, price, year |\n| `get_car` | Full details + specs for one car |\n| `calculate_isv` | Estimate Portuguese car import tax (ISV) |\n| `calculate_iuc` | Estimate Portuguese annual road tax (IUC) |\n| `list_makes_models` | Canonical brand/model names the other tools expect |\n| `estimate_resale_value` | Market value range for a car in Portugal |\n| `list_services` | What Clara Carros offers |\n| `contact_me` | Ask a human to get in touch (needs the user's consent + contact) |\n| `request_import_quote` | Ask Clara Carros to source & quote a car to import |\n\n## Use it\n\n### Remote (add a URL)\n\n```\nhttps://claracars.pt/mcp\n```\n\nAdd it in any client that supports remote/Streamable HTTP MCP servers.\n\n### Local (stdio, via npx)\n\nClaude Desktop / Cline / Continue config:\n\n```json\n{\n  \"mcpServers\": {\n    \"claracars\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"claracars-mcp\"]\n    }\n  }\n}\n```\n\n## Examples\n\n- \"Find diesel wagons under €20,000 in Clara Carros stock.\"\n- \"What's the ISV and annual IUC road tax on a 2016 diesel, 1950 cc, 130 g/km CO₂?\"\n- \"What's my 2018 VW Golf, 100,000 km worth in Portugal?\"\n- \"Ask Clara Carros to source a BMW 320d Touring 2021, my name is … and phone …\"\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `CLARACARS_API_BASE` | `https://claracars.pt/api/public` | Public API base |\n| `CLARACARS_LANG` | `en` | Response language (pt/en/ru/ua) |\n| `PORT` / `MCP_PATH` | `8099` / `/mcp` | HTTP server (remote mode) |\n\n## Develop\n\n```bash\nnpm install\nnpm run build\nnode dist/index.js        # stdio\nnpm run start:http        # remote HTTP on :8099/mcp\n```\n\n## Notes\n\n- **Estimates, not quotes.** ISV and resale figures are estimates; the official ISV is assessed by the Portuguese tax authority.\n- **Privacy.** `contact_me` / `request_import_quote` send the details the user provides to Clara Carros ([privacy policy](https://claracars.pt/en/privacy)); they're rate-limited and require explicit user intent.\n- No business logic or data lives in this repo — it only calls the public API.\n\n## Related\n\n- **Calculators:** the ISV/IUC tax logic this server calls is open-source at [claracarspt/calcs](https://github.com/claracarspt/calcs) — a zero-dependency Python library + key-free API.\n\nMIT © Clara Carros\n",
  "bytes": 3171,
  "sha": "5bee72ef21b8c1bf9943cbbc3637aa32a06aa3484c952290ac343d2fcd6275e7",
  "repo_slug": "claracarspt/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_claracarspt_mcp_b9b25c4d/readme"
}