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 lin...
This record as markdown: /tools/com-finn-www-auto/get-vehicle-details.md
What get_vehicle_details does on FINN Auto - Car Subscription
AI agents call get_vehicle_details to retrieve information from FINN Auto - Car Subscription without modifying anything. It is typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.
| Parameter | Type | Required | Description |
|---|---|---|---|
vehicle_id | string | Yes | The vehicle product ID (e.g. "bmw-ix1-12345-alpinweissuni") |
Parameters from the server's own tool schema.
Why get_vehicle_details is rated Low
This tool performs data retrieval operations only. It returns vehicle details and generates URLs for user navigation but does not execute transactions, modify data, or trigger external operations. The actual checkout and pricing commitment happen via separate tools (get_subscription_pricing, checkout_url).
From the tool's definition Tool retrieves vehicle specifications, equipment, images, and pricing data. Verbs used: 'Get full specifications', 'points to', 'returns'.
Attacks that exploit this kind of access
The rule that runs get_vehicle_details safely
PolicyLayer is an MCP gateway: it sits between your AI agents and FINN Auto - Car Subscription, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For get_vehicle_details, this is the rule to start with:
get_vehicle_details is read-only, so it stays allowed. Everything else on the server is denied unless you say otherwise.
The button opens the PolicyLayer dashboard: create your workspace, connect FINN Auto - Car Subscription, apply this rule, and every get_vehicle_details call is checked against it from then on.
Questions about 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. It is categorised as a Read tool in the FINN Auto - Car Subscription MCP Server, which means it retrieves data without modifying state.
get_vehicle_details accepts 1 parameter: vehicle_id. Required: vehicle_id. The full parameter table on this page comes from the server's own tool schema.
Register the FINN Auto - Car Subscription MCP server in PolicyLayer and add a rule for get_vehicle_details: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches FINN Auto - Car Subscription. Nothing to install.
get_vehicle_details is a Read tool with low risk. Read-only tools are generally safe to allow by default.
Yes. Add a rate_limit block to the get_vehicle_details rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.
Set action: deny in the PolicyLayer policy for get_vehicle_details. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.
get_vehicle_details is provided by the FINN Auto - Car Subscription MCP server (https://www.finn.com/api/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on FINN Auto - Car Subscription, and thousands of servers like it.
This server
Across the catalogue