# io.github.claracarspt/mcp (npm · claracars-mcp)

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

- Trust score: 63/100 (medium)
- Change this week: +20
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `claracars.pt`: 67/100, [markdown](https://verifymcp.io/servers/claracarspt-mcp/claracars.md), [page](https://verifymcp.io/servers/claracarspt-mcp/claracars)
- npm · `claracars-mcp`: 63/100 (this document), [markdown](https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp.md), [page](https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp)

## Channel facts

- Registry: `npm`
- Package: `claracars-mcp`
- Version: `0.1.3`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 19 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1697 tokens (~188/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add claracarspt-mcp -- npx -y claracars-mcp
```

### Codex

```bash
codex mcp add claracarspt-mcp -- npx -y claracars-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "claracarspt-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "claracars-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add claracarspt-mcp --command npx --arg -y --arg claracars-mcp
```

### Hermes

```yaml
mcp_servers:
  claracarspt-mcp:
    command: "npx"
    args: ["-y", "claracars-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "claracarspt-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claracars-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 63, +29)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional] Licence: MIT

### 2026-08-02 (score 34, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-08-01 (score 19, −6)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-31 (score 25, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 43)

First indexed and scored.

## MCP tools (9)

### `search_inventory` (~405 tokens)

Search Clara Carros' current stock of used cars in Portugal. Filter by make, model, fuel, max price and min year. 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 — BMW: series number only ('320','330','116', not '330e'/'320d'/'3 Series'); Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'); other brands: plain model name ('Golf','Corolla','3008', not 'Golf 1.5 TSI'). Put the engine/fuel in the fuel field, not the model. If unsure of the exact spelling, call list_makes_models first.

Input parameters:

- `fuel` (string): Fuel: petrol, diesel, hybrid, phev, electric, lpg
- `limit` (integer): Max results (default 20)
- `make` (string): Full brand name in Latin, as the market lists it — 'BMW', 'Mercedes-Benz' (not 'Mercedes'), 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'.
- `max_price` (number): Maximum price in EUR
- `min_year` (number): Earliest registration year
- `model` (string): Short model/series WITHOUT engine or trim. BMW: series number only ('320','330','116', not '330e'/'320d'/'3 Series'). Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'). Others…

### `get_car` (~53 tokens)

Get full details for one car by its slug (from search_inventory links, e.g. 'mercedes-benz-e-klasse-2016').

Input parameters:

- `slug` (string, required): Car slug from a search_inventory result URL

### `calculate_isv` (~203 tokens)

Calculate Portuguese car import tax (ISV, Imposto Sobre Veículos) using the official Portuguese formula (engine-cc + CO₂ components, with age reduction for used cars) — accurate to the cent vs the AT (Finanças) simulator. Needs engine displacement (cc), CO₂ (g/km, WLTP), fuel and registration year. The result is exact for those inputs; the final amount depends only on the exact CO₂/cc on the car's COC document.

Input parameters:

- `cc` (integer, required): Engine displacement in cm³, e.g. 1950
- `co2` (number, required): CO₂ emissions in g/km (WLTP), e.g. 130
- `fuel` (string, required): Fuel: petrol, diesel, hybrid, phev, electric
- `used` (boolean): Used vehicle (true, default) or new (false)
- `year` (integer, required): First registration year, e.g. 2016

### `calculate_iuc` (~144 tokens)

Calculate the Portuguese annual road tax (IUC, Imposto Único de Circulação) for a car — the yearly tax an owner pays — using the official IUC table. Needs engine displacement (cc), CO₂ (g/km), fuel and registration year. Exact for the given inputs.

Input parameters:

- `cc` (integer, required): Engine displacement in cm³, e.g. 1950
- `co2` (number, required): CO₂ emissions in g/km, e.g. 130
- `fuel` (string, required): Fuel: petrol, diesel, hybrid, phev, electric
- `year` (integer, required): First registration year, e.g. 2016

### `list_makes_models` (~117 tokens)

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

Input parameters:

- `make` (string): Brand to list models for, e.g. 'BMW'. Omit to get the list of brands.

### `estimate_resale_value` (~414 tokens)

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. Clara Carros 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: series number only ('320','330','116', not '330e'/'320d'/'3 Series'); Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'); other brands: plain model name ('Golf','Corolla','3008', not 'Golf 1.5 TSI'). Put the engine/fuel in the fuel field, not the model. If unsure of the exact spelling, call list_makes_models first.

Input parameters:

- `fuel` (string): Fuel: petrol, diesel, hybrid, electric
- `km` (integer, required): Mileage in km
- `make` (string, required): Full brand name in Latin, as the market lists it — 'BMW', 'Mercedes-Benz' (not 'Mercedes'), 'Volkswagen' (not 'VW'), 'Peugeot', 'Seat'.
- `model` (string, required): Short model/series WITHOUT engine or trim. BMW: series number only ('320','330','116', not '330e'/'320d'/'3 Series'). Mercedes: class + number ('C 220','E 220','A 250', not 'C220d'/'C-Class'). Others…
- `year` (integer, required): Registration year

### `list_services` (~37 tokens)

List what Clara Carros offers (buying stock cars, importing to order, sourcing, auction buying, selling your car, ISV calculator).

### `contact_me` (~154 tokens)

Send a contact request to Clara Carros so a human gets in touch. Only call this when the user explicitly asks to be contacted, provides their own name and phone or email, AND agrees to share those details with Clara Carros — pass consent=true only then. Submitting shares the provided contact details per Clara Carros' privacy policy.

Input parameters:

- `consent` (boolean, required): Set true ONLY if the user explicitly agreed to share their contact details and be contacted
- `email` (string): Email (phone OR email required)
- `message` (string): What they want / their question
- `name` (string, required): The person's name (as they gave it)
- `phone` (string): Phone number (phone OR email required)

### `request_import_quote` (~170 tokens)

Ask Clara Carros 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 phone or email, AND agrees to be contacted — pass consent=true only then. Submitting shares the provided contact details per Clara Carros' privacy policy.

Input parameters:

- `budget` (number): Budget in EUR
- `consent` (boolean, required): Set true ONLY if the user explicitly agreed to share their contact details and be contacted
- `email` (string): Email (phone OR email required)
- `model` (string, required): Wanted car, e.g. 'BMW 320d Touring 2021'
- `name` (string, required): The person's name
- `phone` (string): Phone (phone OR email required)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp#diagnostics

## Score history

- 2026-08-03: 63
- 2026-08-02: 34
- 2026-08-01: 19
- 2026-07-31: 25
- 2026-07-30: 43
- 2026-07-28: 43
- 2026-07-27: 43

## Links

- npm package: https://www.npmjs.com/package/claracars-mcp
- Socket report: https://socket.dev/npm/package/claracars-mcp
- Repository: https://github.com/claracarspt/mcp
- Website: https://claracars.pt/
- Changelog RSS feed: https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/claracarspt-mcp/claracars-mcp