Servers Playground How we check Add a server Log in

UK Ireland Used Car Import Agent

Down since Oct 25

io.github.LKennedyShare/irish-used-car-datav0.9.0

Free Irish car counts and asking prices by brand/model/year/county. Paid listings and import checks.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp-production-f77f.up.railway.app/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

analyze_listing Read-only

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. Costs 0.01 USDC per call via x402; no-data results are free.

listing_idstring, required

The listing's id as returned by the other endpoints.

source_platformstring

Optional source platform. Defaults to 'carzone'.

UK Ireland Used Car Import Agent MCP server | mcptry

Tools (21)

analyze_listing

read-only

Argument	Type	Description
listing_id*	string	The listing's id as returned by the other endpoints.
source_platform	string	Optional source platform. Defaults to 'carzone'.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "listing_id": {
      "type": "string",
      "default": "4577902",
      "example": "4577902",
      "examples": [
        "4577902"
      ],
      "description": "The listing's id as returned by the other endpoints."
    },
    "source_platform": {
      "enum": [
        "carzone",
        "joeduffy",
        "windsor",
        "frankkeane",
        "spirit",
        "denismahony"
      ],
      "type": "string",
      "default": "carzone",
      "example": "carzone",
      "examples": [
        "carzone"
      ],
      "description": "Optional source platform. Defaults to 'carzone'."
    }
  }
}

average_car_price

Free average, median, quartiles and price range by optional brand, model, exact year and area (county). Model requires brand. Exact case-insensitive make/model/county matching; omit all filters for Ireland. At least 5 valid positive finite asking prices are required: zero returns no_records and a clear no-records message; 1-4 returns limited_records and states the exact count, with null price stats. 10 attempts per UTC day per IP, shared across REST/MCP/A2A, separate from inventory and preview; invalid attempts count. After the limit, wait until midnight UTC; no automatic paid calls. Optional paid matching listings require explicit approval and x402 payment. Asking prices of recorded active fresh listings in Ireland (IE), not transaction prices or the whole market. Listings are not unique vehicles across sources. Area is an exact Irish county, not a town. Broad brand/model averages mix model years, fuels and trims and are not a vehicle valuation. Free (limited to 10 attempts per UTC day per IP, shared with REST; separate from inventory and preview).

read-only

Argument	Type	Description
area	string	Optional exact Irish county, not a town.
year	integer	Optional exact model year, not a year range.
brand	string	Optional exact vehicle make, case-insensitive.
model	string	Optional exact model, case-insensitive; requires brand.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "area": {
      "type": "string",
      "example": "Dublin",
      "pattern": "\\S",
      "examples": [
        "Dublin"
      ],
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional exact Irish county, not a town."
    },
    "year": {
      "type": "integer",
      "example": 2001,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2001
      ],
      "description": "Optional exact model year, not a year range."
    },
    "brand": {
      "type": "string",
      "example": "BMW",
      "pattern": "\\S",
      "examples": [
        "BMW"
      ],
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional exact vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "example": "3 Series",
      "pattern": "\\S",
      "examples": [
        "3 Series"
      ],
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional exact model, case-insensitive; requires brand."
    }
  },
  "additionalProperties": false
}

count_available_cars

Free live inventory entrypoint: count recorded active fresh Irish listings by area (exact county) and/or brand (exact make), case-insensitive. Omit both for national Ireland coverage. Zero matches returns a successful count of 0 with last_seen_at=null. The separate daily count quota is shared across REST, MCP and the A2A pilot; invalid attempts also count. Does not resolve towns or return listings, prices or deep analysis. Recorded active listings seen within the configured freshness window, in Ireland (IE) only. Area means an exact county, not a town. This is not the entire market or a count of unique vehicles; the same vehicle may appear across sources. Free (limited to 20 calls per UTC day per IP, shared with REST; separate from import preview).

read-only

Argument	Type	Description
area	string	Optional Irish county, exact case-insensitive match; not a town.
brand	string	Optional vehicle make, exact case-insensitive match.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "area": {
      "type": "string",
      "example": "Dublin",
      "pattern": "\\S",
      "examples": [
        "Dublin"
      ],
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional Irish county, exact case-insensitive match; not a town."
    },
    "brand": {
      "type": "string",
      "example": "BMW",
      "pattern": "\\S",
      "examples": [
        "BMW"
      ],
      "maxLength": 64,
      "minLength": 1,
      "description": "Optional vehicle make, exact case-insensitive match."
    }
  },
  "additionalProperties": false
}

depreciation

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
model*	string	Vehicle model, case-insensitive.
country	string	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).
fuel_type	string	Optional: restrict to one fuel type.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Optional: restrict to one fuel type."
    }
  }
}

estimate_irish_vrt

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. Free (limited to 10 calls per day per IP).

read-only

Argument	Type	Description
co2_g_km*	integer	WLTP CO2 in g/km.
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.
nox_mg_km	number	NOx in mg/km. Default 40.
price_eur*	number	Open market selling price (OMSP) in EUR.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "price_eur",
    "co2_g_km",
    "fuel_type"
  ],
  "properties": {
    "co2_g_km": {
      "type": "integer",
      "default": 125,
      "example": 125,
      "maximum": 1000,
      "minimum": 0,
      "examples": [
        125
      ],
      "description": "WLTP CO2 in g/km."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "nox_mg_km": {
      "type": "number",
      "default": 40,
      "example": 40,
      "minimum": 0,
      "examples": [
        40
      ],
      "description": "NOx in mg/km. Default 40."
    },
    "price_eur": {
      "type": "number",
      "default": 20000,
      "example": 20000,
      "minimum": 0,
      "examples": [
        20000
      ],
      "description": "Open market selling price (OMSP) in EUR."
    }
  }
}

get_inventory_breakdown

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Optional vehicle make, case-insensitive.
county	string	Optional Irish county, e.g. Dublin, Cork, Galway (case-insensitive).
country	string	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).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Optional vehicle make, case-insensitive."
    },
    "county": {
      "type": "string",
      "default": "Dublin",
      "example": "Dublin",
      "examples": [
        "Dublin"
      ],
      "description": "Optional Irish county, e.g. Dublin, Cork, Galway (case-insensitive)."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    }
  }
}

get_inventory_summary

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. Costs 0.005 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
country	string	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).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    }
  }
}

get_irish_auto_arbitrage_feed

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. Costs 0.05 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Only return this make, e.g. BMW.
limit	integer	Maximum results, 1-500.
min_margin_eur	number	Minimum margin in EUR between market median and asking price (after a cost buffer).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "make": {
      "type": "string",
      "default": "BMW",
      "example": "BMW",
      "examples": [
        "BMW"
      ],
      "description": "Only return this make, e.g. BMW."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "example": 20,
      "maximum": 500,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum results, 1-500."
    },
    "min_margin_eur": {
      "type": "number",
      "default": 1500,
      "example": 1500,
      "examples": [
        1500
      ],
      "description": "Minimum margin in EUR between market median and asking price (after a cost buffer)."
    }
  }
}

get_new_deals

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. Costs 0.02 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Only this make.
limit	integer	Maximum results, 1-500.
since	string	ISO 8601 timestamp. Defaults to 24 hours ago.
min_margin_eur	number	Minimum margin in EUR.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "make": {
      "type": "string",
      "default": "Volkswagen",
      "example": "Volkswagen",
      "examples": [
        "Volkswagen"
      ],
      "description": "Only this make."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "example": 20,
      "maximum": 500,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum results, 1-500."
    },
    "since": {
      "type": "string",
      "default": "2026-10-14T08:00:00Z",
      "example": "2026-10-14T08:00:00Z",
      "examples": [
        "2026-10-14T08:00:00Z"
      ],
      "description": "ISO 8601 timestamp. Defaults to 24 hours ago."
    },
    "min_margin_eur": {
      "type": "number",
      "default": 1500,
      "example": 1500,
      "examples": [
        1500
      ],
      "description": "Minimum margin in EUR."
    }
  }
}

get_price_drops

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. Costs 0.02 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
days	integer	Look-back window in days, 1-60.
limit	integer	Maximum results, 1-500.
min_drop_pct	number	Minimum size of the latest cut, in percent.

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "days": {
      "type": "integer",
      "default": 7,
      "example": 7,
      "maximum": 60,
      "minimum": 1,
      "examples": [
        7
      ],
      "description": "Look-back window in days, 1-60."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "example": 20,
      "maximum": 500,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum results, 1-500."
    },
    "min_drop_pct": {
      "type": "number",
      "default": 3,
      "example": 3,
      "examples": [
        3
      ],
      "description": "Minimum size of the latest cut, in percent."
    }
  }
}

get_service_info

Describes this service: what data it has, every tool with its price, and how payment works. Free.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_vehicle_listing_by_id

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. Costs 0.005 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
listing_id*	string	The listing id as returned by other tools, e.g. a Carzone ad id or a dealer stock id.
source_platform	string	Optional source platform. Only needed when the same id exists on more than one source.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "listing_id": {
      "type": "string",
      "default": "4577902",
      "example": "4577902",
      "examples": [
        "4577902"
      ],
      "description": "The listing id as returned by other tools, e.g. a Carzone ad id or a dealer stock id."
    },
    "source_platform": {
      "enum": [
        "carzone",
        "joeduffy",
        "windsor",
        "frankkeane",
        "spirit",
        "denismahony"
      ],
      "type": "string",
      "default": "carzone",
      "example": "carzone",
      "examples": [
        "carzone"
      ],
      "description": "Optional source platform. Only needed when the same id exists on more than one source."
    }
  }
}

import_calculator

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Optional; with model, year and mileage_km enables the margin calculation.
year	integer	Optional model year.
model	string	Optional.
co2_g_km*	integer	WLTP CO2 emissions in g/km (drives the VRT band).
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.
nox_mg_km	number	NOx mg/km for the NOx levy. Default 40.
mileage_km	integer	Optional mileage in km.

is_it_cheaper_to_import_car_from_uk_to_ireland

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. Costs 0.02 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
year*	integer	Model year.
model*	string	Vehicle model, case-insensitive.
origin	string	GB = Great Britain, NI = Northern Ireland, ANY = compare both (default).
co2_g_km	integer	WLTP CO2 in g/km for the VRT estimate. Default 130.
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.

market_stats

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
model*	string	Vehicle model, case-insensitive.
country	string	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).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    }
  }
}

preview_uk_import_check

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. Free (limited to 3 calls per UTC day per IP, shared with REST).

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
year*	integer	Model year.
model*	string	Vehicle model, case-insensitive.
origin	string	GB = Great Britain, NI = Northern Ireland, ANY = compare both (default).
co2_g_km	integer	WLTP CO2 in g/km for the VRT estimate. Default 130.
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.
mileage_km*	integer	Odometer reading in km.

price_check

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. Costs 0.005 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
year*	integer	Model year.
model*	string	Vehicle model, case-insensitive.
country	string	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).
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.
mileage_km*	integer	Odometer reading in km.
transmission	string	Optional: Manual or Automatic.

prices_by_county

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Optional make filter.
model	string	Optional model filter (use with make).
country	string	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).

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Optional make filter."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Optional model filter (use with make)."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    }
  }
}

search_car_listings

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make	string	Optional vehicle make, case-insensitive.
sort	string	price_asc (default), price_desc, newest or mileage_asc.
limit	integer	Maximum listings to return (1-100).
model	string	Optional vehicle model, case-insensitive.
county	string	Optional county or area, e.g. Dublin or Antrim (case-insensitive).
country	string	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).
year_max	integer	Optional latest model year.

uk_market_stats

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. Costs 0.01 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
model*	string	Vehicle model, case-insensitive.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Vehicle model, case-insensitive."
    }
  }
}

uk_price_check

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. Costs 0.005 USDC per call via x402; no-data results are free.

read-only

Argument	Type	Description
make*	string	Vehicle make, case-insensitive.
year*	integer	Model year.
model*	string	Vehicle model, case-insensitive.
fuel_type*	string	Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid.
mileage_km*	integer	Odometer reading in km.
transmission	string	Optional: Manual or Automatic.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model",
    "year",
    "mileage_km",
    "fuel_type"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "year": {
      "type": "integer",
      "default": 2020,
      "example": 2020,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2020
      ],
      "description": "Model year."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "mileage_km": {
      "type": "integer",
      "default": 60000,
      "example": 60000,
      "minimum": 0,
      "examples": [
        60000
      ],
      "description": "Odometer reading in km."
    },
    "transmission": {
      "enum": [
        "Manual",
        "Automatic",
        "manual",
        "automatic"
      ],
      "type": "string",
      "default": "Manual",
      "example": "Manual",
      "examples": [
        "Manual"
      ],
      "description": "Optional: Manual or Automatic."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "uk_price_gbp",
    "co2_g_km",
    "fuel_type"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Optional; with model, year and mileage_km enables the margin calculation."
    },
    "year": {
      "type": "integer",
      "default": 2020,
      "example": 2020,
      "examples": [
        2020
      ],
      "description": "Optional model year."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Optional."
    },
    "co2_g_km": {
      "type": "integer",
      "default": 125,
      "example": 125,
      "examples": [
        125
      ],
      "description": "WLTP CO2 emissions in g/km (drives the VRT band)."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "nox_mg_km": {
      "type": "number",
      "default": 40,
      "example": 40,
      "examples": [
        40
      ],
      "description": "NOx mg/km for the NOx levy. Default 40."
    },
    "mileage_km": {
      "type": "integer",
      "default": 60000,
      "example": 60000,
      "examples": [
        60000
      ],
      "description": "Optional mileage in km."
    },
    "gbp_eur_rate": {
      "type": "number",
      "default": 1.17,
      "example": 1.17,
      "examples": [
        1.17
      ],
      "description": "GBP to EUR rate. Defaults to the service rate."
    },
    "shipping_eur": {
      "type": "number",
      "default": 600,
      "example": 600,
      "examples": [
        600
      ],
      "description": "Shipping/transport cost in EUR. Default 600."
    },
    "transmission": {
      "enum": [
        "Manual",
        "Automatic",
        "manual",
        "automatic"
      ],
      "type": "string",
      "default": "Manual",
      "example": "Manual",
      "examples": [
        "Manual"
      ],
      "description": "Optional: Manual or Automatic."
    },
    "uk_price_gbp": {
      "type": "number",
      "default": 10000,
      "example": 10000,
      "examples": [
        10000
      ],
      "description": "UK asking price in GBP."
    },
    "import_vat_pct": {
      "type": "number",
      "default": 0,
      "example": 0,
      "examples": [
        0
      ],
      "description": "Import VAT percent. Default 0; set 23 if it applies."
    },
    "other_costs_eur": {
      "type": "number",
      "default": 500,
      "example": 500,
      "examples": [
        500
      ],
      "description": "Other costs in EUR. Defaults to the service cost buffer (500)."
    },
    "customs_duty_pct": {
      "type": "number",
      "default": 0,
      "example": 0,
      "examples": [
        0
      ],
      "description": "Customs duty percent. Default 0 (GB-built cars may attract ~10%)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model",
    "year",
    "mileage_km",
    "fuel_type"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Volkswagen",
      "example": "Volkswagen",
      "examples": [
        "Volkswagen"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "year": {
      "type": "integer",
      "default": 2023,
      "example": 2023,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2023
      ],
      "description": "Model year."
    },
    "model": {
      "type": "string",
      "default": "Golf",
      "example": "Golf",
      "examples": [
        "Golf"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "origin": {
      "enum": [
        "ANY",
        "GB",
        "NI"
      ],
      "type": "string",
      "default": "ANY",
      "example": "ANY",
      "examples": [
        "ANY"
      ],
      "description": "GB = Great Britain, NI = Northern Ireland, ANY = compare both (default)."
    },
    "co2_g_km": {
      "type": "integer",
      "default": 125,
      "example": 125,
      "maximum": 1000,
      "minimum": 0,
      "examples": [
        125
      ],
      "description": "WLTP CO2 in g/km for the VRT estimate. Default 130."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Petrol",
      "example": "Petrol",
      "examples": [
        "Petrol"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "mileage_km": {
      "type": "integer",
      "default": 50000,
      "example": 50000,
      "minimum": 0,
      "examples": [
        50000
      ],
      "description": "Odometer reading in km."
    },
    "ni_vat_pct": {
      "type": "number",
      "default": 0,
      "example": 0,
      "minimum": 0,
      "examples": [
        0
      ],
      "description": "Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0."
    },
    "shipping_eur": {
      "type": "number",
      "default": 650,
      "example": 650,
      "minimum": 0,
      "examples": [
        650
      ],
      "description": "Transport cost to Ireland in EUR. Default 650."
    },
    "transmission": {
      "enum": [
        "Manual",
        "Automatic",
        "manual",
        "automatic"
      ],
      "type": "string",
      "description": "Optional: Manual or Automatic. Omit to include both."
    },
    "other_costs_eur": {
      "type": "number",
      "default": 500,
      "example": 500,
      "minimum": 0,
      "examples": [
        500
      ],
      "description": "NCT, registration and fees in EUR. Default 500."
    },
    "margin_of_safety_eur": {
      "type": "number",
      "default": 1000,
      "example": 1000,
      "minimum": 0,
      "examples": [
        1000
      ],
      "description": "Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model",
    "year",
    "mileage_km",
    "fuel_type"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Volkswagen",
      "example": "Volkswagen",
      "examples": [
        "Volkswagen"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "year": {
      "type": "integer",
      "default": 2023,
      "example": 2023,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2023
      ],
      "description": "Model year."
    },
    "model": {
      "type": "string",
      "default": "Golf",
      "example": "Golf",
      "examples": [
        "Golf"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "origin": {
      "enum": [
        "ANY",
        "GB",
        "NI"
      ],
      "type": "string",
      "default": "ANY",
      "example": "ANY",
      "examples": [
        "ANY"
      ],
      "description": "GB = Great Britain, NI = Northern Ireland, ANY = compare both (default)."
    },
    "co2_g_km": {
      "type": "integer",
      "default": 125,
      "example": 125,
      "maximum": 1000,
      "minimum": 0,
      "examples": [
        125
      ],
      "description": "WLTP CO2 in g/km for the VRT estimate. Default 130."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Petrol",
      "example": "Petrol",
      "examples": [
        "Petrol"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "mileage_km": {
      "type": "integer",
      "default": 50000,
      "example": 50000,
      "minimum": 0,
      "examples": [
        50000
      ],
      "description": "Odometer reading in km."
    },
    "ni_vat_pct": {
      "type": "number",
      "default": 0,
      "example": 0,
      "minimum": 0,
      "examples": [
        0
      ],
      "description": "Irish VAT % to apply to Northern Ireland purchases (0 for private or margin-scheme sales). Default 0."
    },
    "shipping_eur": {
      "type": "number",
      "default": 650,
      "example": 650,
      "minimum": 0,
      "examples": [
        650
      ],
      "description": "Transport cost to Ireland in EUR. Default 650."
    },
    "transmission": {
      "enum": [
        "Manual",
        "Automatic",
        "manual",
        "automatic"
      ],
      "type": "string",
      "description": "Optional: Manual or Automatic. Omit to include both."
    },
    "other_costs_eur": {
      "type": "number",
      "default": 500,
      "example": 500,
      "minimum": 0,
      "examples": [
        500
      ],
      "description": "NCT, registration and fees in EUR. Default 500."
    },
    "margin_of_safety_eur": {
      "type": "number",
      "default": 1000,
      "example": 1000,
      "minimum": 0,
      "examples": [
        1000
      ],
      "description": "Minimum saving to recommend IMPORT rather than MARGINAL. Default 1000."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "make",
    "model",
    "year",
    "mileage_km",
    "fuel_type"
  ],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Vehicle make, case-insensitive."
    },
    "year": {
      "type": "integer",
      "default": 2020,
      "example": 2020,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2020
      ],
      "description": "Model year."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Vehicle model, case-insensitive."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "IE",
      "example": "IE",
      "examples": [
        "IE"
      ],
      "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)."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Fuel type, e.g. Petrol, Diesel, Electric, Petrol Hybrid, Petrol Plug-in Hybrid."
    },
    "mileage_km": {
      "type": "integer",
      "default": 60000,
      "example": 60000,
      "minimum": 0,
      "examples": [
        60000
      ],
      "description": "Odometer reading in km."
    },
    "transmission": {
      "enum": [
        "Manual",
        "Automatic",
        "manual",
        "automatic"
      ],
      "type": "string",
      "default": "Manual",
      "example": "Manual",
      "examples": [
        "Manual"
      ],
      "description": "Optional: Manual or Automatic."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [],
  "properties": {
    "make": {
      "type": "string",
      "default": "Toyota",
      "example": "Toyota",
      "examples": [
        "Toyota"
      ],
      "description": "Optional vehicle make, case-insensitive."
    },
    "sort": {
      "enum": [
        "price_asc",
        "price_desc",
        "newest",
        "mileage_asc"
      ],
      "type": "string",
      "default": "price_asc",
      "example": "price_asc",
      "examples": [
        "price_asc"
      ],
      "description": "price_asc (default), price_desc, newest or mileage_asc."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "example": 20,
      "maximum": 100,
      "minimum": 1,
      "examples": [
        20
      ],
      "description": "Maximum listings to return (1-100)."
    },
    "model": {
      "type": "string",
      "default": "Corolla",
      "example": "Corolla",
      "examples": [
        "Corolla"
      ],
      "description": "Optional vehicle model, case-insensitive."
    },
    "county": {
      "type": "string",
      "default": "Antrim",
      "example": "Antrim",
      "examples": [
        "Antrim"
      ],
      "description": "Optional county or area, e.g. Dublin or Antrim (case-insensitive)."
    },
    "country": {
      "enum": [
        "IE",
        "GB",
        "ALL"
      ],
      "type": "string",
      "default": "ALL",
      "example": "ALL",
      "examples": [
        "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)."
    },
    "year_max": {
      "type": "integer",
      "default": 2023,
      "example": 2023,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2023
      ],
      "description": "Optional latest model year."
    },
    "year_min": {
      "type": "integer",
      "default": 2018,
      "example": 2018,
      "maximum": 2100,
      "minimum": 1950,
      "examples": [
        2018
      ],
      "description": "Optional earliest model year."
    },
    "fuel_type": {
      "enum": [
        "Petrol",
        "Diesel",
        "Electric",
        "Petrol Hybrid",
        "Diesel Hybrid",
        "Petrol Plug-in Hybrid",
        "Diesel Plug-in Hybrid",
        "petrol",
        "diesel",
        "electric",
        "petrol hybrid",
        "diesel hybrid",
        "petrol plug-in hybrid",
        "diesel plug-in hybrid"
      ],
      "type": "string",
      "default": "Diesel",
      "example": "Diesel",
      "examples": [
        "Diesel"
      ],
      "description": "Optional fuel type."
    },
    "max_price_eur": {
      "type": "number",
      "default": 20000,
      "example": 20000,
      "minimum": 0,
      "examples": [
        20000
      ],
      "description": "Optional maximum asking price in EUR."
    },
    "max_mileage_km": {
      "type": "integer",
      "default": 100000,
      "example": 100000,
      "minimum": 0,
      "examples": [
        100000
      ],
      "description": "Optional maximum mileage in km."
    }
  }
}