FINN Auto - Car Subscription

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "FINN Auto - Car Subscription": {
      "url": "https://www.finn.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• search_vehicles read-only

  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:

  • sort — string — Sort order: asc/desc by price, availability, or last_added
  • fuels — array — Fuel types in German (e.g. ["Elektro", "Benzin", "Diesel", "Plug-In-Hybrid"])
  • limit — number — Number of results (1-10, default 5)
  • terms — array — Subscription term lengths in months (available: 1, 6, 12, 18, 24, 36)
  • brands — array — Car brands (e.g. ["BMW", "Audi", "Mercedes-Benz"])
  • colors — array — Colors in German (e.g. ["Schwarz", "Weiß", "Blau"])
  • models — array — Car models (e.g. ["iX1", "3er Limousine"])
  • cartypes — array — Car types in German (e.g. ["SUV", "Kombi", "Kleinwagen", "Van"])
  • has_deals — boolean — Filter for cars with special deals/discounts
  • has_hitch — boolean — Filter for cars with hitch
  • max_power — number — Maximum power in kW
  • max_price — number — Maximum monthly price in EUR
  • min_power — number — Minimum power in kW
  • min_price — number — Minimum monthly price in EUR
  • available_to — string — Latest delivery date (YYYY-MM-DD)
  • max_ev_range — number — Maximum electric range in km
  • min_ev_range — number — Minimum electric range in km
  • available_from — string — Earliest delivery date (YYYY-MM-DD)
  • is_young_driver — boolean — Filter for cars allowing drivers under 23

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_vehicle_details read-only

  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:

  • vehicle_id (required) — string — The vehicle product ID (e.g. "bmw-ix1-12345-alpinweissuni")

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_available_filters read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_subscription_pricing read-only

  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:

  • vehicle_id (required) — string — The vehicle product ID
  • term_months (required) — Subscription term in months (1, 6, 9, 12, 13, 18, 24, 36)
  • km_package (required) — Monthly km package (500, 1000, 1500, 2000, 2500, 3000, 4000, 5000)
  • down_payment_amount — number — 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_internal_link_url read-only

  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:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.