Server definition
- Hash
- sha256:ff58d74021e02ad454e2618792a4999ef7129b28e87b0fcc9d8e0200ccce0f41
- What it is
- What a remote MCP server returned when asked what it offers: 5 tools
The blob, as servednamed by its sha256
{
"instructions": null,
"tools": [
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_available_filters",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"brand": {
"description": "Brand name (e.g. \"Ford\", \"Mercedes-Benz\", \"BMW\")",
"maxLength": 100,
"minLength": 1,
"type": "string"
},
"model": {
"description": "Optional model name (e.g. \"Puma\", \"iX1\"). If omitted, returns all available models for the brand.",
"maxLength": 100,
"minLength": 1,
"type": "string"
}
},
"required": [
"brand"
],
"type": "object"
},
"name": "get_internal_link_url",
"outputSchema": null
},
{
"description": "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.\n\nCheckout URL structure (always use the URL returned in `checkout_url` verbatim — do NOT construct your own):\n https://www.finn.com/de-DE/checkout/cart/{vehicleId}/{term}/{kmPackage}\n https://www.finn.com/de-DE/checkout/cart/{vehicleId}/{term}/{kmPackage}?downPaymentAmount={amount}\n\nThe three positional path segments after `/cart` are vehicle id, term in months, and monthly km package — in that order.\n\nAbout `down_payment_amount` (Fahrzeugbereitstellung):\n- Fahrzeugbereitstellung is a one-time vehicle provisioning fee.\n- When `down_payment_amount` is provided, it is paid upfront as Einmalzahlung (one-time payment) and the URL includes `?downPaymentAmount={amount}`.\n- When omitted, the same fee is spread across the term and absorbed into the monthly price; the URL has no query string.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"down_payment_amount": {
"description": "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.",
"minimum": 0,
"type": "number"
},
"km_package": {
"description": "Monthly km package (500, 1000, 1500, 2000, 2500, 3000, 4000, 5000)"
},
"term_months": {
"description": "Subscription term in months (1, 6, 9, 12, 13, 18, 24, 36)"
},
"vehicle_id": {
"description": "The vehicle product ID",
"maxLength": 200,
"pattern": "^[a-zA-Z0-9-]+$",
"type": "string"
}
},
"required": [
"vehicle_id",
"term_months",
"km_package"
],
"type": "object"
},
"name": "get_subscription_pricing",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"vehicle_id": {
"description": "The vehicle product ID (e.g. \"bmw-ix1-12345-alpinweissuni\")",
"maxLength": 200,
"pattern": "^[a-zA-Z0-9-]+$",
"type": "string"
}
},
"required": [
"vehicle_id"
],
"type": "object"
},
"name": "get_vehicle_details",
"outputSchema": null
},
{
"description": "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.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"available_from": {
"description": "Earliest delivery date (YYYY-MM-DD)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"available_to": {
"description": "Latest delivery date (YYYY-MM-DD)",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"type": "string"
},
"brands": {
"description": "Car brands (e.g. [\"BMW\", \"Audi\", \"Mercedes-Benz\"])",
"items": {
"type": "string"
},
"type": "array"
},
"cartypes": {
"description": "Car types in German (e.g. [\"SUV\", \"Kombi\", \"Kleinwagen\", \"Van\"])",
"items": {
"type": "string"
},
"type": "array"
},
"colors": {
"description": "Colors in German (e.g. [\"Schwarz\", \"Weiß\", \"Blau\"])",
"items": {
"type": "string"
},
"type": "array"
},
"fuels": {
"description": "Fuel types in German (e.g. [\"Elektro\", \"Benzin\", \"Diesel\", \"Plug-In-Hybrid\"])",
"items": {
"type": "string"
},
"type": "array"
},
"has_deals": {
"description": "Filter for cars with special deals/discounts",
"type": "boolean"
},
"has_hitch": {
"description": "Filter for cars with hitch",
"type": "boolean"
},
"is_young_driver": {
"description": "Filter for cars allowing drivers under 23",
"type": "boolean"
},
"limit": {
"description": "Number of results (1-10, default 5)",
"maximum": 10,
"minimum": 1,
"type": "number"
},
"max_ev_range": {
"description": "Maximum electric range in km",
"type": "number"
},
"max_power": {
"description": "Maximum power in kW",
"type": "number"
},
"max_price": {
"description": "Maximum monthly price in EUR",
"type": "number"
},
"min_ev_range": {
"description": "Minimum electric range in km",
"type": "number"
},
"min_power": {
"description": "Minimum power in kW",
"type": "number"
},
"min_price": {
"description": "Minimum monthly price in EUR",
"type": "number"
},
"models": {
"description": "Car models (e.g. [\"iX1\", \"3er Limousine\"])",
"items": {
"type": "string"
},
"type": "array"
},
"sort": {
"description": "Sort order: asc/desc by price, availability, or last_added",
"enum": [
"asc",
"desc",
"availability",
"last_added"
],
"type": "string"
},
"terms": {
"description": "Subscription term lengths in months (available: 1, 6, 12, 18, 24, 36)",
"items": {
"type": "number"
},
"type": "array"
}
},
"type": "object"
},
"name": "search_vehicles",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:ff58d74021e02ad454e2618792a4999ef7129b28e87b0fcc9d8e0200ccce0f41 | sha256sum