# UK Ireland Used Car Import Agent buyer quickstart

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.

Buying-agent guide: https://irish-auto-arbitrage-production.up.railway.app/use-cases/uk-to-ireland-car-import
Static synthetic examples (no live calls or payments): https://irish-auto-arbitrage-production.up.railway.app/examples.json
Complete integration handbook: https://irish-auto-arbitrage-production.up.railway.app/llms-full.txt
VS Code config: https://irish-auto-arbitrage-production.up.railway.app/integrations/vscode-mcp.json (merge into .vscode\mcp.json)
Cursor config: https://irish-auto-arbitrage-production.up.railway.app/integrations/cursor-mcp.json (merge into .cursor\mcp.json)
Merge entries, do not overwrite existing servers. Operators must review/trust the server and tools. Downloads never connect, auto-install or authorize payment. Generic Cursor and VS Code MCP clients do NOT supply a wallet or x402 payment support. Free preview works within quota; paid calls return terms until a separate explicit payment client is integrated. These remote HTTP configs are not Claude Desktop local command JSON. Framework paid tools require operator policy, not model consent.

## Start free

curl -i "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"
Or call MCP tool preview_uk_import_check. Allowance: 3 attempts per UTC day per IP shared across REST and MCP. Includes the verdict and costs, excludes individual listings. HTTP 429 includes Retry-After; do not immediately retry. No-data and invalid attempts also count.
This example returned a result on 2026-10-16; live inventory can change.

## Runnable car-import assistant

Public MIT-licensed client: https://github.com/LKennedyShare/irish-car-import-assistant
python -m pip install irish-car-import-assistant
car-import-assistant --demo
# Synthetic offline example only: no live listings, network or wallet.
car-import-assistant --interactive
# Guided free comparison; enter the actual car details/CO2 and type compare. No automatic payment upgrade.
car-import-assistant --make Volkswagen --model Golf --year 2023 --mileage-km 50000 --fuel-type Petrol --co2-g-km 125 --json
Append --full to inspect a paid quote without spending; --full --pay --max-usdc 0.02 explicitly authorizes one capped retry for full results. Use a locally configured throwaway wallet as described below. The assistant never buys a car or executes an import, and does not require an LLM key.
Reusable Python: from irish_car_import_assistant import compare_car; call with the same structured vehicle fields. Defaults to free preview; payment additionally requires full=True and pay=True. Requests identify as car-import-assistant. Quota failures never trigger paid upgrades.

## LangChain and OpenAI Agents SDK

python -m pip install "irish-car-import-assistant[langchain,openai]>=0.2.0"
from irish_car_import_assistant import CarImportTools
session = CarImportTools()
langchain_tools = session.as_langchain_tools()
openai_tools = session.as_openai_tools()
Default tools: offline_demo, preview, quote. No paid tool is exposed without an operator-defined approval_policy. The model cannot supply payment approval, budget, wallet or endpoint parameters. Retain one instance across calls: reservations are capped at 0.02 USDC total per instance, one paid attempt by default, and failures do not refund the reservation. Restarting resets this in-memory limit; use durable external policy/budgets for production. Framework/model usage has separate costs and privacy settings.
Runnable offline framework examples: https://github.com/LKennedyShare/irish-car-import-assistant/tree/main/examples

Use this service when an AI buying agent needs UK, Northern Ireland or Irish used-car market data, or needs to know whether importing a car from the UK to Ireland is cheaper, and can pay per result with x402.
There is no account setup. Paid REST endpoints return HTTP 402 with USDC-on-Base payment requirements; pay with an x402 client, retry the same request, and receive the result. No-data 404 responses are not charged.

## Highest-ROI flows

0. Full import comparison, including matching listings: GET /api/v1/a2a/uk-import-check?make=Volkswagen&model=Golf&year=2023&mileage_km=50000&fuel_type=Petrol&co2_g_km=125
1. Find undervalued cars: GET /api/v1/a2a/arbitrage-feed?min_margin_eur=2000&limit=20
2. Check a specific car value: GET /api/v1/a2a/price-check?make=Toyota&model=Corolla&year=2020&mileage_km=60000&fuel_type=Petrol
3. Monitor fresh deals: GET /api/v1/a2a/new-deals?since=2026-10-14T08:00:00Z&min_margin_eur=1500
4. Inspect one listing from a feed: GET /api/v1/a2a/listing/carzone/4577902

## REST payment loop

curl -i "https://irish-auto-arbitrage-production.up.railway.app/api/v1/a2a/arbitrage-feed?min_margin_eur=2000&limit=20"
# Response: 402 Payment Required with PAYMENT-REQUIRED and x402 price headers.
# Create a valid x402 payment for the returned requirements, retry with PAYMENT-SIGNATURE, and parse JSON.
The 402 body may be empty: decode PAYMENT-REQUIRED using the official x402 SDK, not a hard-coded body schema.

## Runnable Python payment client

Install the standalone public client from https://github.com/LKennedyShare/irish-car-import-assistant; no backend checkout is needed.
python -m irish_car_import_assistant.payments https://irish-auto-arbitrage-production.up.railway.app
# Inspection only: decodes the challenge, requires no wallet and never signs a payment.
For payment, set X402_CLIENT_PRIVATE_KEY in your local shell to a throwaway wallet containing only a small USDC balance. Never put it in a file, prompt, source code or log.
python -m irish_car_import_assistant.payments https://irish-auto-arbitrage-production.up.railway.app --pay --max-usdc 0.02 --path "/api/v1/a2a/uk-import-check?make=Volkswagen&model=Golf&year=2023&mileage_km=50000&fuel_type=Petrol&co2_g_km=125"
# --pay explicitly authorizes one capped paid retry; Base mainnet uses real USDC.
The client checks exact USDC on Base/Base Sepolia, rejects redirects and enforces the cap before signing. Successful JSON is separate from settlement confirmation: check the payment response; missing settlement metadata is reported as unconfirmed. Payment rejection does not trigger another automatic retry.

## MCP / agent flow

Streamable HTTP MCP endpoint: https://mcp-production-f77f.up.railway.app/mcp
Recommended prompt: Find Irish used cars with at least EUR 2,000 estimated margin and explain the top 5.
Recommended prompt: Check whether listing 4577902 is below market and show closest comparables.
Recommended prompt: Monitor new below-market BMW listings since yesterday.

## Tool selection

- is_it_cheaper_to_import_car_from_uk_to_ireland: the import decision for one car, with landed cost per route.
- preview_uk_import_check: the free limited import decision and costs, without individual listings.
- search_car_listings: live listings in IE, GB (UK and Northern Ireland) or both.
- uk_price_check / uk_market_stats: value and overview of a model on the UK and NI market.
- get_irish_auto_arbitrage_feed: current ranked opportunities.
- get_new_deals: incremental polling since a timestamp.
- get_price_drops: motivated-seller discount signals.
- price_check: valuation for one hypothetical car.
- get_vehicle_listing_by_id: cheap/free single-listing lookup.
- analyze_listing: paid deep dive for one listing id, closest comparables and price history.

## Retry guidance

If you get no data, broaden make/model filters, lower min_margin_eur, increase limit, or call market_stats first to confirm enough live listings exist for that model.
For import comparisons, omit transmission or try a different year/mileage with better coverage. Do not invent a valuation when fewer than 5 comparables exist. The suggested search and market tools are paid.