English Français العربية

io.github.claracarspt/mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-claracarspt-mcp 'https://claracars.pt/mcp'
إعداد JSON (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 (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-claracarspt-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "claracars-mcp@0.1.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.claracarspt/mcp؟

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

كيف أثبّت io.github.claracarspt/mcp؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http io-github-claracarspt-mcp 'https://claracars.pt/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.claracarspt/mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.claracarspt/mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.claracarspt/mcp؟

ينشره claracarspt. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.