{
  "markdown": "<p align=\"center\">\n  <img src=\"./assets/wordmark.png\" alt=\"TransparentCars\" width=\"320\" />\n</p>\n\n# TransparentCars 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 **[TransparentCars](https://transparent.pt)** — honest, budget used cars for the local Portuguese market. Search live stock, check whether a car's asking price is actually fair, estimate the yearly cost of keeping a car on the road, and get in touch.\n\nIt's a thin, open-source wrapper over the public `transparent.pt` API — no keys, no setup beyond adding the server.\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `search_inventory` | Search current budget stock by make, model, fuel, gearbox, price, year |\n| `get_car` | Full details + specs for one car |\n| `check_fair_price` | The market range a car sells for — plus a fair / above-market / below-market verdict on an asking price |\n| `cost_to_own` | The annual IUC road tax + a plain running-cost framing for budgeting |\n| `list_makes_models` | Canonical brand/model names the other tools expect |\n| `contact_me` | Ask a human to get in touch (needs the user's consent + contact) |\n\nThe **fair-price check** is the point: paste any listing's price and get a straight answer on whether it's a good deal — no sales spin.\n\n## Use it\n\n### Remote (add a URL)\n\n```\nhttps://transparent.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    \"transparentcars\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"transparentcars-mcp\"]\n    }\n  }\n}\n```\n\n## Examples\n\n- \"Find a manual petrol car under €10,000 in TransparentCars stock.\"\n- \"A dealer wants €9,500 for a 2014 Renault Clio with 120,000 km — is that fair?\"\n- \"What's the yearly road tax on a 2016 petrol, 1200 cc, 120 g/km CO₂?\"\n- \"Ask TransparentCars to call me — my name is … and my number is …\"\n\n## Configuration\n\n| Env var | Default | Purpose |\n|---------|---------|---------|\n| `TC_API_BASE` | `https://transparent.pt/api/public` | Public API base |\n| `TC_SITE` | `transparentcars` | Site key the API is scoped to |\n| `TC_LANG` | `en` | Response language (pt/en) |\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 guarantees.** The fair-price range and running-cost figures are estimates built from real comparable listings and the official road-tax table; treat them as guidance, not a formal valuation.\n- **Privacy.** `contact_me` sends the details the user provides to TransparentCars ([privacy policy](https://transparent.pt/en/privacy)); it requires explicit user intent and consent.\n- No business logic or data lives in this repo — it only calls the public API.\n\nMIT © TransparentCars\n",
  "bytes": 3113,
  "sha": "2be96feee7e534a72d0c59bd325c844b5ea2b6211d5f8e4ecd334b1facca2a91",
  "repo_slug": "transparentpt/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_transparentpt_mcp_7e480a3f/readme"
}