com.finn.www/auto

Official5 tools

FINN Auto - Car Subscription

Search and browse cars for all-inclusive subscription on FINN. Prices, specs, and checkout links.

Search and browse subscription car options with pricing, specifications, and checkout links.

Captured live from the server via tools/list.

search_vehicles

Search available cars on FINN with filters. Returns matching vehicles with prices, images, and links. All filter values use German names (e.g. "Elektro" not "Electric", "Schwarz" not "Black"). IMPORTANT: Always show detail_url as a clickable link for each vehicle. The vehicle_id field is an internal API identifier for get_vehicle_details — never display it to users.

Parameters (19)

brandsarray
Car brands (e.g. ["BMW", "Audi", "Mercedes-Benz"])
modelsarray
Car models (e.g. ["iX1", "3er Limousine"])
cartypesarray
Car types in German (e.g. ["SUV", "Kombi", "Kleinwagen", "Van"])
fuelsarray
Fuel types in German (e.g. ["Elektro", "Benzin", "Diesel", "Plug-In-Hybrid"])
colorsarray
Colors in German (e.g. ["Schwarz", "Weiß", "Blau"])
min_pricenumber
Minimum monthly price in EUR
max_pricenumber
Maximum monthly price in EUR
min_powernumber
Minimum power in kW
max_powernumber
Maximum power in kW
min_ev_rangenumber
Minimum electric range in km
max_ev_rangenumber
Maximum electric range in km
has_hitchboolean
Filter for cars with hitch
is_young_driverboolean
Filter for cars allowing drivers under 23
has_dealsboolean
Filter for cars with special deals/discounts
termsarray
Subscription term lengths in months (available: 1, 6, 12, 18, 24, 36)
available_fromstring
Earliest delivery date (YYYY-MM-DD)
available_tostring
Latest delivery date (YYYY-MM-DD)
sortstring
Sort order: asc/desc by price, availability, or last_added
limitnumber
Number of results (1-10, default 5)

get_vehicle_details

Get full specifications, equipment, all images, and pricing per term for a specific vehicle. Use a vehicle_id from search_vehicles results. IMPORTANT: Always show `detail_url` as a clickable link — it points to the FINN configurator where the user picks term and km. To produce a direct checkout link for a specific term + km combination (and optionally a one-time Fahrzeugbereitstellung), call `get_subscription_pricing` and use the `checkout_url` it returns. Never construct checkout URLs yourself. The `vehicle_id` field is an internal API identifier — never display it to users.

Parameters (1)

vehicle_idstringrequired
The vehicle product ID (e.g. "bmw-ix1-12345-alpinweissuni")

get_available_filters

Discover what's currently available in FINN's fleet. Returns all brands (with nested models), car types, fuel types, colors, subscription terms, gearshifts, and price/power/range bounds. Use this to answer questions like 'What brands does FINN offer?' or to validate filter values before searching.

No parameters.

get_subscription_pricing

Calculate exact monthly subscription price for a specific vehicle, term, and mileage combination. Returns base price, km add-on, total, and a canonical checkout URL. Checkout URL structure (always use the URL returned in `checkout_url` verbatim — do NOT construct your own): https://www.finn.com/de-DE/checkout/cart/{vehicleId}/{term}/{kmPackage} https://www.finn.com/de-DE/checkout/cart/{vehicleId}/{term}/{kmPackage}?downPaymentAmount={amount} The three positional path segments after `/cart` are vehicle id, term in months, and monthly km package — in that order. About `down_payment_amount` (Fahrzeugbereitstellung): - Fahrzeugbereitstellung is a one-time vehicle provisioning fee. - When `down_payment_amount` is provided, it is paid upfront as Einmalzahlung (one-time payment) and the URL includes `?downPaymentAmount={amount}`. - When omitted, the same fee is spread across the term and absorbed into the monthly price; the URL has no query string.

Parameters (4)

vehicle_idstringrequired
The vehicle product ID
term_monthsanyrequired
Subscription term in months (1, 6, 9, 12, 13, 18, 24, 36)
km_packageanyrequired
Monthly km package (500, 1000, 1500, 2000, 2500, 3000, 4000, 5000)
down_payment_amountnumber
Optional one-time Fahrzeugbereitstellung (vehicle provisioning fee) in EUR, paid upfront as Einmalzahlung. When provided, the checkout URL gets `?downPaymentAmount={amount}` and the monthly price drops accordingly. When omitted, the fee is spread across the term inside the monthly price.

get_internal_link_url

Get canonical FINN URLs for a brand and its models — for building internal linking blocks on SEO pages. For each model returns three URLs that target DIFFERENT funnels: `mdp_url` (marketing/brand page), `plp_subscribe_url` (subscription product listing, /de-DE/subscribe/{brand}_{model}), and `plp_leasing_url` (leasing product listing, /de-DE/leasing/{brand}_{model}). Use `plp_leasing_url` when linking from a Leasing advisory, `plp_subscribe_url` when linking from subscription content. If `model` is omitted, returns all currently available models for the brand.

Parameters (2)

brandstringrequired
Brand name (e.g. "Ford", "Mercedes-Benz", "BMW")
modelstring
Optional model name (e.g. "Puma", "iX1"). If omitted, returns all available models for the brand.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "auto": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://www.finn.com/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.