{"openapi":"3.1.0","info":{"title":"UK Ireland Used Car Import Agent","description":"Is it cheaper to import this used car from the UK to Ireland? One call compares live UK, Northern Ireland and Irish listings and returns the landed cost (transport, customs duty, VAT, VRT) against the Irish market price. Also: UK and Irish car search, price checks, market stats, depreciation, county prices, below-market deals and VRT/NOx calculators. Pay per request in USDC via x402.\n\n**Payment:** paid `/api/v1/a2a/*` endpoints use the x402 protocol. Call without payment to receive HTTP 402 with payment terms in the PAYMENT-REQUIRED header (USDC on Base); pay with an x402 client and retry. Responses with status 404 (no matching data) are not charged.\n\n**Protocols:** Connect using MCP (streamable HTTP) or the x402 REST API. The /a2a/ URL is a legacy API namespace, not an implementation of the A2A protocol. MCP connectivity alone does not provide a wallet or x402 payment support.\n\n**Data caveat:** analytics are estimates from public listings; VRT and import figures are not tax advice.","version":"0.4.0"},"paths":{"/api/v1/a2a/arbitrage-feed":{"get":{"tags":["paid"],"summary":"Best-value used cars in Ireland right now","description":"Use when you want a ranked list of Irish used-car listings priced below the median of genuinely comparable cars (same make, model, fuel, transmission, within 1 year and 30,000 km). Each result includes the asking price, the market median, number of comparables and the gross margin. Best for dealers, flippers and buying agents looking for opportunities. Use get_new_deals instead for only recently discovered deals, or get_price_drops for listings where the seller has just reduced the asking price.\n\n**Price:** 0.05 USDC per request (x402).","operationId":"get_irish_auto_arbitrage_feed","parameters":[{"name":"min_margin_eur","in":"query","required":false,"schema":{"type":"number","description":"Minimum margin in EUR between market median and asking price (after a cost buffer).","examples":[1500.0],"default":1500.0,"title":"Min Margin Eur"},"description":"Minimum margin in EUR between market median and asking price (after a cost buffer)."},{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only return this make, e.g. BMW.","examples":["BMW"],"title":"Make"},"description":"Only return this make, e.g. BMW."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum results, 1-500.","examples":[20],"default":100,"title":"Limit"},"description":"Maximum results, 1-500."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Irish Auto Arbitrage Feed"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/new-deals":{"get":{"tags":["paid"],"summary":"Newly listed below-market cars since a given time","description":"Use to poll for fresh opportunities: returns deals first seen by us since a timestamp (default: last 24 hours). Call on a schedule with the previous call's time to receive only new deals. Use get_irish_auto_arbitrage_feed instead for the current ranked deal list regardless of first-seen time, or get_price_drops for discount signals.\n\n**Price:** 0.02 USDC per request (x402).","operationId":"get_new_deals","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"ISO 8601 timestamp. Defaults to 24 hours ago.","examples":["2026-10-14T08:00:00Z"],"title":"Since"},"description":"ISO 8601 timestamp. Defaults to 24 hours ago."},{"name":"min_margin_eur","in":"query","required":false,"schema":{"type":"number","description":"Minimum margin in EUR.","examples":[1500.0],"default":1500.0,"title":"Min Margin Eur"},"description":"Minimum margin in EUR."},{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only this make.","examples":["Volkswagen"],"title":"Make"},"description":"Only this make."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum results, 1-500.","examples":[20],"default":100,"title":"Limit"},"description":"Maximum results, 1-500."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get New Deals"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/price-check":{"get":{"tags":["paid"],"summary":"What is this used car worth in Ireland?","description":"Use to value a specific car: median, mean, quartiles and range of comparable Irish listings (same make, model, fuel, transmission if given, within 1 year and 30,000 km). Returns 404 (no charge) if there are fewer than 5 comparables. Use market_stats instead for a broad make/model overview, or analyze_listing when you already have a listing_id.\n\n**Price:** 0.005 USDC per request (x402).","operationId":"price_check","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1950,"description":"Model year.","examples":[2020],"title":"Year"},"description":"Model year."},{"name":"mileage_km","in":"query","required":true,"schema":{"type":"integer","minimum":0,"description":"Odometer reading in km.","examples":[60000],"title":"Mileage Km"},"description":"Odometer reading in km."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Diesel"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: Manual or Automatic.","examples":["Manual"],"title":"Transmission"},"description":"Optional: Manual or Automatic."},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Price Check"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/listing/{source_platform}/{listing_id}":{"get":{"tags":["paid"],"summary":"Is this specific Irish car listing good value?","description":"Use to assess one listing you already have an id for. Use get_irish_auto_arbitrage_feed or get_vehicle_listing_by_id first to find a listing_id. Defaults to source_platform='carzone' when omitted. Returns verdict (below/at/above market), percentage vs the comparable median, margin, up to 10 closest comparable listings and the listing's recorded price history.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"analyze_listing","parameters":[{"name":"source_platform","in":"path","required":true,"schema":{"type":"string","description":"Optional source platform. Defaults to 'carzone'.","examples":["carzone"],"title":"Source Platform"},"description":"Optional source platform. Defaults to 'carzone'."},{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","description":"The listing's id as returned by the other endpoints.","examples":["4577902"],"title":"Listing Id"},"description":"The listing's id as returned by the other endpoints."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Analyze Listing"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/market-stats":{"get":{"tags":["paid"],"summary":"Irish market prices for a make and model","description":"Use for an overview of one model in the Irish used market: listing count, price range, median, and median price and mileage by model year and by fuel type. Use price_check instead to value one specific car with year, mileage, fuel type and optional transmission.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"market_stats","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Market Stats"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/depreciation":{"get":{"tags":["paid"],"summary":"How fast a car model loses value in Ireland","description":"Use to estimate depreciation: median price by model year with year-on-year change, plus price change per 10,000 km. Needs at least 5 listings; otherwise returns 404 and you are not charged. Use market_stats instead for a simple market overview without depreciation calculations.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"depreciation","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"fuel_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: restrict to one fuel type.","examples":["Diesel"],"title":"Fuel Type"},"description":"Optional: restrict to one fuel type."},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Depreciation"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/by-county":{"get":{"tags":["paid"],"summary":"Used-car prices by Irish county","description":"Use to see where a model (or make, or all cars) is cheapest or dearest across Irish counties, relative to the national median. Small counties may have few listings. Use market_stats instead when county comparison is not needed.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"prices_by_county","parameters":[{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional make filter.","examples":["Toyota"],"title":"Make"},"description":"Optional make filter."},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional model filter (use with make).","examples":["Corolla"],"title":"Model"},"description":"Optional model filter (use with make)."},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prices By County"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/price-drops":{"get":{"tags":["paid"],"summary":"Irish used cars whose asking price was recently cut","description":"Use to find motivated sellers: listings whose price dropped within the last N days, with original, previous and current price and the percentage cut. Price history is recorded by us from the first time we see a listing. Use get_irish_auto_arbitrage_feed instead for below-market ranking even when there was no recent price cut.\n\n**Price:** 0.02 USDC per request (x402).","operationId":"get_price_drops","parameters":[{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":60,"minimum":1,"description":"Look-back window in days, 1-60.","examples":[7],"default":7,"title":"Days"},"description":"Look-back window in days, 1-60."},{"name":"min_drop_pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Minimum size of the latest cut, in percent.","examples":[3.0],"default":3.0,"title":"Min Drop Pct"},"description":"Minimum size of the latest cut, in percent."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"Maximum results, 1-500.","examples":[20],"default":100,"title":"Limit"},"description":"Maximum results, 1-500."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Price Drops"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/vrt-estimate":{"get":{"tags":["paid"],"summary":"Irish VRT and NOx levy estimate","description":"Use to estimate Vehicle Registration Tax and the NOx levy for a vehicle registered in Ireland, from its taxable value (OMSP), CO2 emissions and fuel type. Estimate only; verify against Revenue.ie. Use import_calculator instead for a full UK-to-Ireland landed-cost and margin estimate.\n\n**Price:** 0.005 USDC per request (x402).","operationId":"estimate_irish_vrt","parameters":[{"name":"price_eur","in":"query","required":true,"schema":{"type":"number","minimum":0,"description":"Open market selling price (OMSP) in EUR.","examples":[20000.0],"title":"Price Eur"},"description":"Open market selling price (OMSP) in EUR."},{"name":"co2_g_km","in":"query","required":true,"schema":{"type":"integer","maximum":1000,"minimum":0,"description":"WLTP CO2 in g/km.","examples":[125],"title":"Co2 G Km"},"description":"WLTP CO2 in g/km."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Diesel"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"nox_mg_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"NOx in mg/km. Default 40.","examples":[40.0],"default":40.0,"title":"Nox Mg Km"},"description":"NOx in mg/km. Default 40."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Estimate Irish Vrt"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/inventory-summary":{"get":{"tags":["paid"],"summary":"How many used cars are listed in Ireland","description":"Returns one number: the count of active used-car listings in Ireland, with a timestamp. No breakdowns and no prices. Use get_inventory_breakdown instead for county, make, turnover and freshness details.\n\n**Price:** 0.005 USDC per request (x402).","operationId":"get_inventory_summary","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Inventory Summary"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/inventory-breakdown":{"get":{"tags":["paid"],"summary":"Irish used-car inventory by county and make, with turnover and freshness","description":"Use for market coverage and supply analysis: active used-car listings, optionally for one county and/or make, with a county and make breakdown, listings added in the last 24 hours, listings removed in the last 7 days, number of sources and when the data was last refreshed. Counts only; no prices. Use get_inventory_summary instead when you only need the one headline active-listing count.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"get_inventory_breakdown","parameters":[{"name":"county","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional Irish county, e.g. Dublin, Cork, Galway (case-insensitive).","examples":["Dublin"],"title":"County"},"description":"Optional Irish county, e.g. Dublin, Cork, Galway (case-insensitive)."},{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Optional vehicle make, case-insensitive."},{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["IE"],"default":"IE","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Inventory Breakdown"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/vehicle/{listing_id}":{"get":{"tags":["paid","free"],"summary":"Look up one Irish car listing by id","description":"Use when you already have a listing id (from another call or a dealer site) and want that single vehicle: make, model, year, price, mileage, status and days on market, how its price compares with the market median, and an indicative VRT breakdown. Returns one row. For ranked below-market deals across all stock use get_irish_auto_arbitrage_feed. Use analyze_listing instead when you want closest comparables and price history.\n\n**Free:** no payment needed; limited to 10 calls per day per IP.","operationId":"get_vehicle_listing_by_id","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","description":"The listing id as returned by other tools, e.g. a Carzone ad id or a dealer stock id.","examples":["4577902"],"title":"Listing Id"},"description":"The listing id as returned by other tools, e.g. a Carzone ad id or a dealer stock id."},{"name":"source_platform","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional source platform. Only needed when the same id exists on more than one source.","examples":["carzone"],"title":"Source Platform"},"description":"Optional source platform. Only needed when the same id exists on more than one source."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Vehicle Listing By Id"}}}},"404":{"description":"No matching data."},"429":{"description":"Free-tier limit reached for this IP. Retry after the Retry-After seconds, or use the paid MCP tool."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/import-calculator":{"get":{"tags":["paid"],"summary":"UK-to-Ireland car import landed cost and margin","description":"Use to judge a UK import: converts the GBP price and adds shipping, customs duty, import VAT, VRT, NOx levy and a cost buffer to give the landed cost in EUR. Provide make, model, year and mileage to also get the expected margin against the Irish market median. Duty and VAT default to 0 and must be set by the caller; results are estimates. Use estimate_irish_vrt instead when you only need VRT and NOx for an already Irish-valued vehicle.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"import_calculator","parameters":[{"name":"uk_price_gbp","in":"query","required":true,"schema":{"type":"number","exclusiveMinimum":0,"description":"UK asking price in GBP.","examples":[10000.0],"title":"Uk Price Gbp"},"description":"UK asking price in GBP."},{"name":"co2_g_km","in":"query","required":true,"schema":{"type":"integer","maximum":1000,"minimum":0,"description":"WLTP CO2 emissions in g/km (drives the VRT band).","examples":[125],"title":"Co2 G Km"},"description":"WLTP CO2 emissions in g/km (drives the VRT band)."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Diesel"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional; with model, year and mileage_km enables the margin calculation.","examples":["Toyota"],"title":"Make"},"description":"Optional; with model, year and mileage_km enables the margin calculation."},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional.","examples":["Corolla"],"title":"Model"},"description":"Optional."},{"name":"year","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Optional model year.","examples":[2020],"title":"Year"},"description":"Optional model year."},{"name":"mileage_km","in":"query","required":false,"schema":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Optional mileage in km.","examples":[60000],"title":"Mileage Km"},"description":"Optional mileage in km."},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: Manual or Automatic.","examples":["Manual"],"title":"Transmission"},"description":"Optional: Manual or Automatic."},{"name":"shipping_eur","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Shipping/transport cost in EUR. Default 600.","examples":[600.0],"default":600.0,"title":"Shipping Eur"},"description":"Shipping/transport cost in EUR. Default 600."},{"name":"customs_duty_pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Customs duty percent. Default 0 (GB-built cars may attract ~10%).","examples":[0.0],"default":0.0,"title":"Customs Duty Pct"},"description":"Customs duty percent. Default 0 (GB-built cars may attract ~10%)."},{"name":"import_vat_pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Import VAT percent. Default 0; set 23 if it applies.","examples":[0.0],"default":0.0,"title":"Import Vat Pct"},"description":"Import VAT percent. Default 0; set 23 if it applies."},{"name":"gbp_eur_rate","in":"query","required":false,"schema":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"null"}],"description":"GBP to EUR rate. Defaults to the service rate.","examples":[1.17],"title":"Gbp Eur Rate"},"description":"GBP to EUR rate. Defaults to the service rate."},{"name":"nox_mg_km","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"NOx mg/km for the NOx levy. Default 40.","examples":[40.0],"default":40.0,"title":"Nox Mg Km"},"description":"NOx mg/km for the NOx levy. Default 40."},{"name":"other_costs_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Other costs in EUR. Defaults to the service cost buffer (500).","examples":[500.0],"title":"Other Costs Eur"},"description":"Other costs in EUR. Defaults to the service cost buffer (500)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Import Calculator"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/uk-import-check":{"get":{"tags":["paid"],"summary":"Is it cheaper to import this car from the UK or Northern Ireland to Ireland?","description":"Headline call. Use when someone is deciding whether to buy a used car in the UK or Northern Ireland and import it to Ireland. Compares the median price of comparable live UK and Northern Ireland listings (same make, model, fuel, within 1 year and 30,000 km) with the Irish median, adds transport, customs duty and import VAT (Great Britain), Irish VRT and NOx levy, and returns a verdict (IMPORT, MARGINAL or BUY_IN_IRELAND), the saving in EUR, the landed-cost breakdown per route and the three cheapest matching listings. Returns 404 (no charge) if either market has fewer than 5 comparables. Pass co2_g_km for an accurate VRT figure. Estimate only.\n\n**Price:** 0.02 USDC per request (x402).","operationId":"is_it_cheaper_to_import_car_from_uk_to_ireland","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Volkswagen"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Golf"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1950,"description":"Model year.","examples":[2023],"title":"Year"},"description":"Model year."},{"name":"mileage_km","in":"query","required":true,"schema":{"type":"integer","minimum":0,"description":"Odometer reading in km.","examples":[50000],"title":"Mileage Km"},"description":"Odometer reading in km."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Petrol"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: Manual or Automatic. Omit to include both.","title":"Transmission"},"description":"Optional: Manual or Automatic. Omit to include both."},{"name":"co2_g_km","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"description":"WLTP CO2 in g/km for the VRT estimate. Default 130.","examples":[125],"default":130,"title":"Co2 G Km"},"description":"WLTP CO2 in g/km for the VRT estimate. Default 130."},{"name":"origin","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:ANY|GB|NI)$","description":"GB = Great Britain, NI = Northern Ireland, ANY = compare both (default).","examples":["ANY"],"default":"ANY","title":"Origin"},"description":"GB = Great Britain, NI = Northern Ireland, ANY = compare both (default)."},{"name":"shipping_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Transport cost to Ireland in EUR. Default 650.","examples":[650.0],"title":"Shipping Eur"},"description":"Transport cost to Ireland in EUR. Default 650."},{"name":"other_costs_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"NCT, registration and fees in EUR. Default 500.","examples":[500.0],"title":"Other Costs Eur"},"description":"NCT, registration and fees in EUR. Default 500."},{"name":"margin_of_safety_eur","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000.","examples":[1000.0],"default":1000.0,"title":"Margin Of Safety Eur"},"description":"Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000."},{"name":"ni_vat_pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0.","examples":[0.0],"default":0.0,"title":"Ni Vat Pct"},"description":"Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Is It Cheaper To Import Car From Uk To Ireland"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/uk-import-preview":{"get":{"tags":["paid","free"],"summary":"Try a free UK-to-Ireland import comparison","description":"Free limited preview of the import decision, Irish market median and landed costs. Uses the same live data and parameters as the paid import check, but excludes individual listings. Quota is shared across REST and MCP and resets at midnight UTC; failed and no-data attempts also count. Use is_it_cheaper_to_import_car_from_uk_to_ireland for matching listings. Estimates only.\n\n**Free:** no payment needed; limited to 3 calls per day per IP.","operationId":"preview_uk_import_check","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Volkswagen"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Golf"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1950,"description":"Model year.","examples":[2023],"title":"Year"},"description":"Model year."},{"name":"mileage_km","in":"query","required":true,"schema":{"type":"integer","minimum":0,"description":"Odometer reading in km.","examples":[50000],"title":"Mileage Km"},"description":"Odometer reading in km."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Petrol"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: Manual or Automatic. Omit to include both.","title":"Transmission"},"description":"Optional: Manual or Automatic. Omit to include both."},{"name":"co2_g_km","in":"query","required":false,"schema":{"type":"integer","maximum":1000,"minimum":0,"description":"WLTP CO2 in g/km for the VRT estimate. Default 130.","examples":[125],"default":130,"title":"Co2 G Km"},"description":"WLTP CO2 in g/km for the VRT estimate. Default 130."},{"name":"origin","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:ANY|GB|NI)$","description":"GB = Great Britain, NI = Northern Ireland, ANY = compare both (default).","examples":["ANY"],"default":"ANY","title":"Origin"},"description":"GB = Great Britain, NI = Northern Ireland, ANY = compare both (default)."},{"name":"shipping_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Transport cost to Ireland in EUR. Default 650.","examples":[650.0],"title":"Shipping Eur"},"description":"Transport cost to Ireland in EUR. Default 650."},{"name":"other_costs_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"NCT, registration and fees in EUR. Default 500.","examples":[500.0],"title":"Other Costs Eur"},"description":"NCT, registration and fees in EUR. Default 500."},{"name":"margin_of_safety_eur","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000.","examples":[1000.0],"default":1000.0,"title":"Margin Of Safety Eur"},"description":"Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000."},{"name":"ni_vat_pct","in":"query","required":false,"schema":{"type":"number","minimum":0,"description":"Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0.","examples":[0.0],"default":0.0,"title":"Ni Vat Pct"},"description":"Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Preview Uk Import Check"}}}},"404":{"description":"No matching data."},"429":{"description":"Free-tier limit reached for this IP. Retry after the Retry-After seconds, or use the paid MCP tool."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/listings":{"get":{"tags":["paid"],"summary":"Search used cars for sale in Ireland, the UK and Northern Ireland","description":"Use to find live used-car listings across Ireland, the UK and Northern Ireland in one query: filter by make, model, year range, maximum price, maximum mileage, fuel type and county, sorted by price, newest or mileage. Each listing has its price in the local currency and in EUR, mileage in km, source and URL. Use uk_import_check instead to decide whether importing is cheaper. Returns 404 (no charge) when nothing matches.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"search_car_listings","parameters":[{"name":"country","in":"query","required":false,"schema":{"type":"string","pattern":"^(?i:IE|GB|ALL)$","description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate).","examples":["ALL"],"default":"ALL","title":"Country"},"description":"Market to query: IE = Ireland (default), GB = UK including Northern Ireland, ALL = both. Prices are always also given in EUR (GBP converted at the live ECB rate)."},{"name":"make","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Optional vehicle make, case-insensitive."},{"name":"model","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Optional vehicle model, case-insensitive."},{"name":"year_min","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1950},{"type":"null"}],"description":"Optional earliest model year.","examples":[2018],"title":"Year Min"},"description":"Optional earliest model year."},{"name":"year_max","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","maximum":2100,"minimum":1950},{"type":"null"}],"description":"Optional latest model year.","examples":[2023],"title":"Year Max"},"description":"Optional latest model year."},{"name":"max_price_eur","in":"query","required":false,"schema":{"anyOf":[{"type":"number","minimum":0},{"type":"null"}],"description":"Optional maximum asking price in EUR.","examples":[20000.0],"title":"Max Price Eur"},"description":"Optional maximum asking price in EUR."},{"name":"max_mileage_km","in":"query","required":false,"schema":{"anyOf":[{"type":"integer","minimum":0},{"type":"null"}],"description":"Optional maximum mileage in km.","examples":[100000],"title":"Max Mileage Km"},"description":"Optional maximum mileage in km."},{"name":"fuel_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional fuel type.","examples":["Diesel"],"title":"Fuel Type"},"description":"Optional fuel type."},{"name":"county","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional county or area, e.g. Dublin or Antrim (case-insensitive).","examples":["Antrim"],"title":"County"},"description":"Optional county or area, e.g. Dublin or Antrim (case-insensitive)."},{"name":"sort","in":"query","required":false,"schema":{"type":"string","pattern":"^(price_asc|price_desc|newest|mileage_asc)$","description":"price_asc (default), price_desc, newest or mileage_asc.","examples":["price_asc"],"default":"price_asc","title":"Sort"},"description":"price_asc (default), price_desc, newest or mileage_asc."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Maximum listings to return (1-100).","examples":[20],"default":20,"title":"Limit"},"description":"Maximum listings to return (1-100)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Search Car Listings"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/uk/price-check":{"get":{"tags":["paid"],"summary":"What is this used car worth in the UK or Northern Ireland?","description":"Use to value a specific car on the UK and Northern Ireland market: median, mean, quartiles and range of comparable live UK listings in EUR (same make, model, fuel, within 1 year and 30,000 km), plus the median in GBP. Returns 404 (no charge) with fewer than 5 comparables. Use price_check for Ireland or uk_import_check for the import decision.\n\n**Price:** 0.005 USDC per request (x402).","operationId":"uk_price_check","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Vehicle model, case-insensitive."},{"name":"year","in":"query","required":true,"schema":{"type":"integer","maximum":2100,"minimum":1950,"description":"Model year.","examples":[2020],"title":"Year"},"description":"Model year."},{"name":"mileage_km","in":"query","required":true,"schema":{"type":"integer","minimum":0,"description":"Odometer reading in km.","examples":[60000],"title":"Mileage Km"},"description":"Odometer reading in km."},{"name":"fuel_type","in":"query","required":true,"schema":{"type":"string","description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.","examples":["Diesel"],"title":"Fuel Type"},"description":"Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."},{"name":"transmission","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional: Manual or Automatic.","examples":["Manual"],"title":"Transmission"},"description":"Optional: Manual or Automatic."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Uk Price Check"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/a2a/uk/market-stats":{"get":{"tags":["paid"],"summary":"UK and Northern Ireland used-car market for a make and model","description":"Use for an overview of one make and model on the UK and Northern Ireland market: listing count, price range, median (EUR), medians by model year and fuel type, and how quickly cars sell. Use market_stats for Ireland or uk_import_check to compare the two markets.\n\n**Price:** 0.01 USDC per request (x402).","operationId":"uk_market_stats","parameters":[{"name":"make","in":"query","required":true,"schema":{"type":"string","description":"Vehicle make, case-insensitive.","examples":["Toyota"],"title":"Make"},"description":"Vehicle make, case-insensitive."},{"name":"model","in":"query","required":true,"schema":{"type":"string","description":"Vehicle model, case-insensitive.","examples":["Corolla"],"title":"Model"},"description":"Vehicle model, case-insensitive."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Uk Market Stats"}}}},"402":{"description":"Payment required. Decode the PAYMENT-REQUIRED header for x402 payment terms (USDC on Base); the body may be empty."},"404":{"description":"No matching data. You are NOT charged for 404 responses."},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/use-cases/uk-to-ireland-car-import":{"get":{"tags":["discovery"],"summary":"UK-to-Ireland buying-agent guide","operationId":"import_guide_use_cases_uk_to_ireland_car_import_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/examples.json":{"get":{"tags":["discovery"],"summary":"Static versioned integration examples","operationId":"examples_examples_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Examples Examples Json Get"}}}}}}},"/":{"get":{"tags":["discovery"],"summary":"Service overview, endpoints and prices","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["discovery"],"summary":"Health check","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/integrations/vscode-mcp.json":{"get":{"tags":["discovery"],"summary":"Download VS Code MCP configuration","operationId":"vscode_config_integrations_vscode_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/integrations/cursor-mcp.json":{"get":{"tags":["discovery"],"summary":"Download Cursor MCP configuration","operationId":"cursor_config_integrations_cursor_mcp_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/llms-full.txt":{"get":{"tags":["discovery"],"summary":"Complete public integration handbook","operationId":"handbook_llms_full_txt_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"tags":[{"name":"free","description":"Free endpoint (capped per IP per day)."},{"name":"paid","description":"Paid endpoints (x402, USDC on Base)."},{"name":"discovery","description":"Free service information."}]}