io.github.Joyall-au/cardossier-market-api
Polish used-car market data: valuations, price history, liquidity, regional prices. Keyless demo.
Open source Open in the app JSON README (API)
About
Polish used-car market data: valuations, price history, liquidity, regional prices. Keyless demo.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- joyall-au
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.4
- Last push
- 2026-07-31T06:29:46Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:00
- Updated
- 2026-08-29 03:02:00
- Origin id
io.github.Joyall-au/cardossier-market-api
README
# CarDossier Poland Market API — MCP Server
mcp-name: io.github.Joyall-au/cardossier-market-api
[](LICENSE)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
An **MCP (Model Context Protocol) server** that gives AI assistants — Claude, Cursor, Windsurf, and any MCP-compatible agent — real-time access to Polish used car market data via the [CarDossier Market API](https://car-dossier.com/en/api/).
## What It Does
This server exposes 5 tools that AI agents can call to answer questions like:
- *"What is a 2019 Toyota Corolla worth in Poland right now?"*
- *"Has the price of diesel BMWs been rising or falling over the past 6 months?"*
- *"How quickly do used Volkswagen Golfs sell in Poland?"*
- *"Is a 2020 Audi A4 cheaper in Mazowieckie or Śląskie?"*
- *"How much more does an automatic gearbox add to the price of a 2018 Ford Focus?"*
## Available Tools
| Tool | Description | Credits |
|------|-------------|---------|
| `get_market_valuation` | Average, median, P25 & P75 prices for any make/model/year | 8 |
| `get_price_history` | Monthly price trend for up to 24 months | 10 |
| `get_market_liquidity` | Estimated days-on-market (how fast a car sells) | 6 |
| `get_valuation_factors` | Price impact of gearbox type, fuel type, import status | 12 |
| `get_regional_pricing` | Price comparison across all 16 Polish voivodeships | 8 |
Data source: 1.4M+ active listings from Poland's leading car marketplaces, updated daily.
**Vehicle names are resolved automatically** — `VW Golf`, `BMW 3 Series` / `320d`, `Mercedes C-Class`, `Audi A4`, `XC60` all work; responses show exactly which marketplace models were aggregated. Failed calls are auto-refunded.
## 🚀 Try It Without a Key
The API serves **5 keyless demo calls per IP per day** with full real data, so this server works the moment you install it:
```bash
pip install cardossier-mcp-server
cardossier-mcp
```
For more quota, [register free](https://car-dossier.com/en/api) — 50 credits via email OTP, no credit card — and set `CARDOSSIER_API_KEY`.
## Prerequisites
- Python 3.9+
- Optional: a CarDossier API key — [register for free](https://car-dossier.com/en/api/pricing) to get **50 free credits** (no credit card required), or purchase a paid package starting at $49 for 5,000 credits
## Installation
```bash
# From PyPI (recommended)
pip install cardossier-mcp-server
# Or from source
git clone https://github.com/Joyall-au/cardossier-mcp-server.git
cd cardossier-mcp-server
pip install mcp requests
```
## Usage
### 1. (Optional) Set your API key
```bash
export CARDOSSIER_API_KEY="your_api_key_here" # omit to use the keyless demo tier
```
### 2. Run the server
```bash
cardossier-mcp
# or from a source checkout: python mcp_server.py
```
### 3. Connect to Claude Desktop
Add the following to your Claude Desktop config file:
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"cardossier": {
"command": "cardossier-mcp",
"env": {
"CARDOSSIER_API_KEY": "your_api_key_here"
}
}
}
}
```
### 4. Connect to Cursor or Windsurf
Add to your MCP settings:
```json
{
"cardossier": {
"command": "cardossier-mcp",
"env": {
"CARDOSSIER_API_KEY": "your_api_key_here"
}
}
}
```
## Example Interactions
Once connected, you can ask your AI assistant:
> **"What's the current market value of a 2020 BMW 3 Series diesel in Poland?"**
The agent will call `get_market_valuation` with `make=BMW, model=3 Series, year=2020, fuel_type=diesel` and return the statistical distribution of prices.
> **"Show me how Toyota Corolla prices have changed over the last year"**
The agent will call `get_price_history` with `months=12` and return a monthly price trend.
> **"Compare used Skoda Octavia prices across Polish regions"**
The agent will call `get_regional_pricing` and return a breakdown by voivodeship.
## API Reference
Full API documentation: [car-dossier.com/en/api/docs](https://car-dossier.com/en/api/docs)
OpenAPI 3.1 spec: [car-dossier.com/openapi.yaml](https://car-dossier.com/openapi.yaml)
FAQ: [car-dossier.com/en/api/faq/](https://car-dossier.com/en/api/faq/)
## Pricing
The CarDossier Market API uses a pay-as-you-go credit system. Credits never expire.
> **Free Trial:** Register at [car-dossier.com/en/api/pricing](https://car-dossier.com/en/api/pricing) to receive **50 free credits** instantly — no credit card required. Enough for ~6 market valuation calls.
| Package | Price | Credits | ~Valuation calls |
|--------------|-------|----------|------------------|
| **Free Trial** | **$0** | **50** | **~6** |
| Starter | $49 | 5,000 | ~625 |
| Growth | $129 | 15,000 | ~1,875 |
| Pro | $299 | 40,000 | ~5,000 |
| Business | $699 | 100,000 | ~12,500 |
[Start for free — get 50 credits →](https://car-dossier.com/en/api/pricing)
## License
MIT License — see [LICENSE](LICENSE) for details.
## About
Built by [CarDossier](https://car-dossier.com) — Poland's leading vehicle history and market data platform.