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 分