CarDossier Poland Market API — MCP Server
mcp-name: io.github.Joyall-au/cardossier-market-api
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.
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:
pip install cardossier-mcp-server
cardossier-mcp
For more quota, register free — 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 to get 50 free credits (no credit card required), or purchase a paid package starting at $49 for 5,000 credits
Installation
# 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
export CARDOSSIER_API_KEY="your_api_key_here" # omit to use the keyless demo tier
2. Run the server
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
{
"mcpServers": {
"cardossier": {
"command": "cardossier-mcp",
"env": {
"CARDOSSIER_API_KEY": "your_api_key_here"
}
}
}
}
4. Connect to Cursor or Windsurf
Add to your MCP settings:
{
"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
OpenAPI 3.1 spec: car-dossier.com/openapi.yaml
FAQ: 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 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 →
License
MIT License — see LICENSE for details.
About
Built by CarDossier — Poland's leading vehicle history and market data platform.
Metadata
Release files for cardossier-mcp-server 1.0.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cardossier_mcp_server-1.0.4.tar.gz | 6.6 kB | Without provenance | Details for cardossier_mcp_server-1.0.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cardossier_mcp_server-1.0.4-py3-none-any.whl | Python 3 | none | any | Details for cardossier_mcp_server-1.0.4-py3-none-any.whl |
Total release size: 13.9 kB
Release files / cardossier_mcp_server-1.0.4.tar.gz
| Download URL | cardossier_mcp_server-1.0.4.tar.gz |
|---|---|
| Size | 6.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
00c5f13fee258a628b25f3298536e9210fe24286d5b08730e7754c9740465bab
|
|
BLAKE2b-256 checksum How to use checksums |
f8be17e8d90af7a8a1a94d3ae5fceae17e2341e83d5ca2a352545ea34d6ba437
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Release files / cardossier_mcp_server-1.0.4-py3-none-any.whl
| Download URL | cardossier_mcp_server-1.0.4-py3-none-any.whl |
|---|---|
| Size | 7.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d958028091e34938a532375cc23d3c2229f732626dcc021210496fac05446c76
|
|
BLAKE2b-256 checksum How to use checksums |
902c82739b03fc2ea1a1a6e0db58f69d1d791fb20dd322408d4c675e7cca8dd8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.9.6
|
Security for cardossier-mcp-server 1.0.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.