{"schema_version":"1.0","reviewed_at":"2026-10-16","example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"notice":"Static examples only. No market, model, wallet or payment calls are made by this document.","links":{"guide":"https://irish-auto-arbitrage-production.up.railway.app/use-cases/uk-to-ireland-car-import","service":"https://irish-auto-arbitrage-production.up.railway.app/","examples":"https://irish-auto-arbitrage-production.up.railway.app/examples.json","docs":"https://irish-auto-arbitrage-production.up.railway.app/docs","openapi":"https://irish-auto-arbitrage-production.up.railway.app/openapi.json","buyers":"https://irish-auto-arbitrage-production.up.railway.app/buyers.txt","llms":"https://irish-auto-arbitrage-production.up.railway.app/llms.txt","pypi":"https://pypi.org/project/irish-car-import-assistant/","repository":"https://github.com/LKennedyShare/irish-car-import-assistant","llms_full":"https://irish-auto-arbitrage-production.up.railway.app/llms-full.txt","vscode_mcp":"https://irish-auto-arbitrage-production.up.railway.app/integrations/vscode-mcp.json","cursor_mcp":"https://irish-auto-arbitrage-production.up.railway.app/integrations/cursor-mcp.json","client_examples":"https://github.com/LKennedyShare/irish-car-import-assistant/tree/main/examples","revenue":"https://www.revenue.ie/en/vrt/"},"protocols":{"note":"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.","mcp_endpoint":"https://mcp-production-f77f.up.railway.app/mcp","mcp_arguments":"Vehicle fields are flat inside params.arguments, not inside an extra input or params object.","mcp_call_example":{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"preview_uk_import_check","arguments":{"make":"Volkswagen","model":"Golf","year":2023,"mileage_km":50000,"fuel_type":"Petrol","co2_g_km":125}}}},"client":{"minimum_framework_version":"0.2.0","install":"python -m pip install irish-car-import-assistant","optional_extras_install":"python -m pip install \"irish-car-import-assistant[langchain,openai]>=0.2.0\"","offline_demo":"car-import-assistant --demo","free_structured_cli":"car-import-assistant --make Volkswagen --model Golf --year 2023 --mileage-km 50000 --fuel-type Petrol --co2-g-km 125 --json","quote_only_cli":"car-import-assistant --make Volkswagen --model Golf --year 2023 --mileage-km 50000 --fuel-type Petrol --co2-g-km 125 --json --full","explicit_paid_cli":"car-import-assistant --make Volkswagen --model Golf --year 2023 --mileage-km 50000 --fuel-type Petrol --co2-g-km 125 --json --full --pay --max-usdc 0.02","framework_example":"from irish_car_import_assistant import CarImportTools\nsession = CarImportTools()\nlangchain_tools = session.as_langchain_tools()\nopenai_tools = session.as_openai_tools()","safety":["The structured free CLI needs no LLM or wallet. --full inspects a quote without paying.","Only explicit --full --pay authorizes a capped paid retry; nothing here runs it.","Default framework tools are offline_demo, preview, quote. Paid tools are hidden by default.","Paid framework tools require an operator-defined approval_policy; model output cannot authorize spending.","Retain one CarImportTools instance: default session limit 0.02 USDC and one paid attempt.","Reservations are in memory; failures do not refund them and restarts reset them. Production needs durable external policy and budgets.","Never put wallet keys in prompts, inline examples or logs. Frameworks have separate model costs and privacy settings.","No automatic model calls, payment upgrades or spending; MCP connectivity is not payment authorization."]},"selection":{"import":"Use the free preview for a buy-in-Ireland versus import decision; use the paid full import check only for individual matching listings.","valuation":"Use price_check for a specific Irish valuation or uk_price_check for UK/NI, not for landed costs.","search":"Use search_car_listings for candidate listings, not a valuation or an import recommendation.","coverage":"At least 5 comparables within filters: same make/model/fuel, within 1 year and 30,000 km, plus optional transmission. Import needs Irish and qualifying origin coverage. Otherwise no_data, never an invented valuation.","vehicle":"Supply actual make, model, year, mileage in km, fuel type and measured WLTP CO2; do not guess hybrid fuel or CO2.","origin":"Import origin GB means Great Britain; NI means Northern Ireland; ANY compares qualifying routes. Search country=GB includes NI, unlike import origin=GB. Check vehicle history, origin and tax treatment with Revenue."},"preview_quota":{"attempts_per_ip_per_utc_day":3,"shared_across":["REST","MCP"],"resets":"midnight UTC","excludes":"individual listings","invalid_and_no_data_attempts_count":true},"input_examples":[{"id":"free_preview","tool":"preview_uk_import_check","input":{"make":"Volkswagen","model":"Golf","year":2023,"mileage_km":50000,"fuel_type":"Petrol","co2_g_km":125},"rest":{"method":"GET","url":"https://irish-auto-arbitrage-production.up.railway.app/api/v1/a2a/uk-import-preview?make=Volkswagen&model=Golf&year=2023&mileage_km=50000&fuel_type=Petrol&co2_g_km=125","price_usdc":"0"}},{"id":"full_import_check","tool":"is_it_cheaper_to_import_car_from_uk_to_ireland","input":{"make":"Volkswagen","model":"Golf","year":2023,"mileage_km":50000,"fuel_type":"Petrol","co2_g_km":125},"rest":{"method":"GET","url":"https://irish-auto-arbitrage-production.up.railway.app/api/v1/a2a/uk-import-check?make=Volkswagen&model=Golf&year=2023&mileage_km=50000&fuel_type=Petrol&co2_g_km=125","price_usdc":"0.02"}},{"id":"irish_valuation","tool":"price_check","input":{"make":"Volkswagen","model":"Golf","year":2023,"mileage_km":50000,"fuel_type":"Petrol"},"rest":{"method":"GET","url":"https://irish-auto-arbitrage-production.up.railway.app/api/v1/a2a/price-check?make=Volkswagen&model=Golf&year=2023&mileage_km=50000&fuel_type=Petrol","price_usdc":"0.005"}},{"id":"listing_search","tool":"search_car_listings","input":{"make":"Volkswagen","model":"Golf","country":"ALL","year_min":2022,"year_max":2024,"limit":3},"rest":{"method":"GET","url":"https://irish-auto-arbitrage-production.up.railway.app/api/v1/a2a/listings?make=Volkswagen&model=Golf&country=ALL&year_min=2022&year_max=2024&limit=3","price_usdc":"0.01"}}],"response_examples":[{"example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"id":"preview","status":200,"body":{"example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"query":{"make":"Volkswagen","model":"Golf","year":2023,"mileage_km":50000,"fuel_type":"Petrol","co2_g_km":125},"irish_market":{"comparable_count":68,"median_price_eur":29950.0,"p25_price_eur":24971.25,"p75_price_eur":32218.25},"verdict":{"cheaper_to_import":false,"recommendation":"BUY_IN_IRELAND","best_origin":"GB","saving_eur":-8060.6,"summary":"SYNTHETIC_ILLUSTRATION: buying in Ireland costs less in this invented example."},"assumptions":["SYNTHETIC_ILLUSTRATION: all prices, counts, FX and costs are illustrative, not current market observations.","Illustrative GBP/EUR rate 1.1819; route costs are estimates, not tax advice.","No current availability, achievable savings or individual listings are represented."],"estimate_only":true,"disclaimer":"Indicative estimate; confirm duty, VAT and VRT with Revenue before buying.","routes":[{"origin":"GB","comparable_count":23,"median_uk_price_gbp":19645.0,"median_uk_price_eur":23218.43,"landed_cost":{"vehicle_price_eur":23218.43,"shipping_eur":650.0,"customs_duty_eur":2386.84,"import_vat_eur":6038.71,"vrt_eur":5016.62,"nox_levy_eur":200.0,"other_costs_eur":500.0,"total_landed_cost_eur":38010.6},"saving_vs_irish_median_eur":-8060.6,"cheaper_to_import":false,"recommendation":"BUY_IN_IRELAND"}],"preview":{"full_result_path":"/api/v1/a2a/uk-import-check","full_result_tool":"is_it_cheaper_to_import_car_from_uk_to_ireland","note":"Free preview excludes individual listings. Use the paid import check for matching listings."}}},{"example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"id":"insufficient_coverage","status":404,"outcome":"no_data","body":{"detail":{"message":"No data found for UK import comparison; you were not charged.","suggestion":"Omit transmission or check GB and IE coverage using search_car_listings. Do not substitute invented values; coverage tools are paid."}}},{"example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"id":"quota_exhausted","status":429,"headers":{"Retry-After":"3600","X-RateLimit-Limit":"3","X-RateLimit-Remaining":"0"},"body":{"detail":"Free import preview is capped at 3 attempts per UTC day per IP; retry after the reset."},"note":"Illustrative Retry-After seconds, not a current quota observation. Wait; do not auto-upgrade."},{"example_kind":"SYNTHETIC_ILLUSTRATION","live_data":false,"payment_made":false,"id":"paid_challenge","status":402,"headers":{"PAYMENT-REQUIRED":"<informational placeholder: decode the real header with an x402 client>"},"body":null,"price_usdc":"0.02","asset":"USDC","note":"Informational only, not a signed or usable challenge. A real 402 body may be empty. Reading this requires no wallet; no_data 404 is not charged."}],"estimate_only":true,"disclaimer":"All response examples are SYNTHETIC_ILLUSTRATION, not current market calls or tax advice. Confirm treatment with Revenue before buying."}