Cardossier Market

Name: Cardossier Market
Author: joyall-au

@joyall-auMCP server · External

Polish used-car market data: valuations, price history, liquidity, regional prices. Keyless demo.

Cars & vehiclesv1.0.4MITPython

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

At most: only reads or looks up information.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

PyPIcardossier-mcp-serverv1.0.4

Run

uvx cardossier-mcp-server

MCP client config

{
  "mcpServers": {
    "cardossier-market": {
      "command": "uvx",
      "args": [
        "cardossier-mcp-server"
      ]
    }
  }
}

README3 min readView on GitHub

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:

bash

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

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
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.