Claracarspt

io.github.claracarspt由 GitHub 账号 claracarspt 发布v0.1.3更新于 Oct 24, 2026

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

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

让助手搜索葡萄牙的二手与进口车源、估算 ISV/IUC 税费与转售价值,并提交联系或进口报价请求。

可以做什么
  • 搜索与查看车源:按品牌、车型、燃料、变速箱和价格筛选库存,查看单车详情,列出可用的规范品牌与车型
  • 估算葡萄牙税费:根据排量、二氧化碳、燃料和年份估算 ISV 进口税与年度 IUC 路税
  • 评估车价:判断要价是否合理,并依据可比车源估算转售价值
  • 估算用车成本:给出含 IUC 的年度最低养车成本
  • 联系与咨询:发送联系请求或进口报价请求,并列出商家提供的服务
适用场景
适合在葡萄牙选购二手车、向葡萄牙进口车辆,或在联系车商前快速估算 ISV、IUC 和转售价值时使用。
运行要求
可作为远程 Streamable HTTP 端点使用,也可通过 npx 在本地运行(需 Node.js)。无需 API 密钥或账号。可选环境变量用于设置 API 地址、回复语言(pt/en/ru/ua)以及本地 HTTP 端口和路径。
安装前请注意
contact_me 和 request_import_quote 会把用户提供的姓名和电话或邮箱发送给 Clara Carros,仅在用户明确同意时调用。税费与估值均为估算,并非官方报价。该服务器是某车商公开 API 的封装,结果反映该车商的库存与挂牌信息。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Claracarspt,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.claracarspt%2Fmcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "claracarspt": {
      "type": "http",
      "url": "https://claracars.pt/mcp"
    }
  }
}

README

[Clara Carros]

Clara Carros MCP server

[MCP] [License: MIT]

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:

json
{  "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

bash
npm installnpm run buildnode dist/index.js        # stdionpm 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.

Related

  • 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

来源:README.md,提交 fcad7f1

工具

11

search_inventory

Search TransparentCars' current stock of budget used cars in Portugal — honestly listed, everyday cars for the local market. Filter by make, model, fuel, gearbox and max price. Returns matching cars with price, year, mileage and a link. IMPORTANT — pass make/model canonically in Latin, as the Portuguese market lists them: make = full brand name ('BMW', 'Mercedes-Benz' not 'Mercedes', 'Volkswagen' not 'VW'); model = the short series/model WITHOUT the engine or trim suffix ('Golf' not 'Golf 1.5 TSI', 'Clio' not 'Clio dCi'). Put the fuel in the fuel field, not the model. If unsure of the spelling, call list_makes_models first.

输入参数fuelmakelimitmodelgearboxmin_yearmax_price

get_car

Get full details for one car in TransparentCars stock by its slug (from a search_inventory link, e.g. 'renault-clio-2016').

输入参数slug必填

check_fair_price

Check whether a car's asking price is fair for the Portuguese market — the TransparentCars transparency check. Given make, model, year and mileage, it returns the range comparable cars actually sell for (low / typical / high), built from real listings. If you pass asking_price, it also gives a plain verdict: fair, above market, or below market — so a buyer knows before they walk in. Works for ANY car (a listing you found elsewhere, or one of ours). IMPORTANT — pass make/model canonically in Latin: make = full brand name ('Renault', 'Volkswagen' not 'VW'); model = short name WITHOUT engine/trim ('Clio' not 'Clio dCi', 'Golf' not 'Golf 1.5 TSI'). If unsure of spelling, call list_makes_models first.

输入参数hpkm必填fuelmake必填year必填model必填gearboxasking_price

cost_to_own

Estimate a car's yearly running-cost floor in Portugal — the annual IUC road tax (Imposto Único de Circulação) every owner pays, plus a plain running-cost framing. Needs engine displacement (cc), CO₂ (g/km), fuel and first-registration year. Use this to help a buyer budget the true cost of keeping a car, beyond the sticker price.

输入参数cc必填co2必填fuel必填usedyear必填month

list_makes_models

List the exact canonical car makes (brands) TransparentCars can search and price — or, given a make, that brand's models — using the exact strings the other tools expect. Call this FIRST (or whenever unsure of spelling) and pass the returned values verbatim into search_inventory / check_fair_price. No make = the list of brands; with a make = that brand's models.

输入参数make

contact_me

Send a contact request to TransparentCars so a human gets in touch. Only call this when the user explicitly asks to be contacted, provides their own name and a phone or email, AND agrees to share those details — pass consent=true only then. Never invent, guess, or use placeholder / example / test contact details: pass ONLY the real name and real phone or e-mail the user gave you in this conversation. If you don't have a real phone or e-mail from the user, ask them for it before calling — do not submit fake values. Submitting shares the provided contact details per the TransparentCars privacy policy.

输入参数name必填consent必填contact必填message

calculate_isv

Estimate Portuguese car import tax (ISV, Imposto Sobre Veículos) from the official ISV formula (engine-cc + CO₂ components, with age reduction for used cars). A maintained estimate: it matches the AT (Finanças) simulator to the cent on the common WLTP cases, but is not the official figure and may differ on edge cases (NEDC, light-commercial, month rounding) — confirm the final amount on the official AT simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year.

输入参数ccco2fuelusedyear必填axlesconfigfrom_eupeso_brutosuspensionutilizacaovehicle_type另有 3 个

calculate_iuc

Estimate the Portuguese annual road tax (IUC, Imposto Único de Circulação) for a car — the yearly tax an owner pays — from the official IUC table. A maintained estimate; confirm on the official AT simulator. Needs engine displacement (cc), CO₂ (g/km), fuel and registration year.

输入参数ccco2fuelyear必填axlesconfigpeso_brutosuspensionutilizacaovehicle_typetractor_axlestrailer_axles另有 1 个

estimate_resale_value

Estimate what a car is worth on the Portuguese market (the range comparable cars are listed for), based on real comparable listings. Needs make, model, year, mileage and fuel. TransparentCars also BUYS cars directly — after giving the estimate, offer to connect the user for a firm buy-out offer (via contact_me or the /sell page). IMPORTANT — pass make/model canonically in Latin, as the Portuguese market lists them: make = full brand name ('BMW', 'Mercedes-Benz' not 'Mercedes', 'Volkswagen' not 'VW'); model = the short series/model WITHOUT the engine or trim suffix (BMW: '320','330' not '320d'; Mercedes: 'C 220','A 250' not 'C220d'; others: 'Golf','Corolla','3008'). If unsure of the spelling, call list_makes_models first.

输入参数km必填fuelmake必填year必填model必填

list_services

List what TransparentCars offers (buying stock cars, importing to order, sourcing, auction buying, selling/trading in your car, ISV/IUC calculators).

无需输入参数。

request_import_quote

Ask TransparentCars to source & quote a specific car to import (from German/EU auctions). Only call when the user wants an import quote, provides the wanted model plus their own name and a phone or email, AND agrees to be contacted — pass consent=true only then. Never invent, guess, or use placeholder / example / test contact details: pass ONLY the real name and real phone or e-mail the user gave you in this conversation. If you don't have a real phone or e-mail from the user, ask them for it before calling — do not submit fake values. Submitting shares the provided contact details per the TransparentCars privacy policy.

输入参数name必填model必填budgetconsent必填contact必填

版本历史

1
  1. v0.1.3最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分