FINN

MCP server openai

A FINN car subscription is a flexible way to stay mobile anytime - without long-term commitments like buying or leasing a car. With a fixed monthly rate that already includes insurance, maintenance, registration, and even CO₂ offsetting, the car subscription offers full transparency and convenience.

Best of all, you can book online in just a few minutes, and your new car will be delivered straight to your doorstep or you can pick it up at one of our stations.

Homepage: https://www.finn.com/de-DE
Remote URL: https://www.finn.com/api/mcp
Auth: NONE

Tools (5)

Extracted live via the executor SDK.

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