Get available car types and prices for a transfer. Use this to show pricing to your customers before they book.

Request Body

curl -X POST https://mcp.airport-pickups-london.com/api/quote \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "origin": "Heathrow Terminal 5",
    "destination": "10 Downing Street, London, SW1A 2AA",
    "passengers": 2,
    "suitcases": 2,
    "transfer_date": "2026-03-15",
    "transfer_time": "14:30"
  }'

{
  "pickup": "London Heathrow Airport, Terminal 5",
  "dropoff": "10 Downing Street, Downing Street, London SW1A 2AA, UK",
  "transfer_date": "2026-03-15",
  "transfer_time": "14:30",
  "passengers": 2,
  "recommended_car_type": "Saloon",
  "duration": "51 minutes",
  "cars": [
    {
      "car_type": "Saloon",
      "price_gbp": 88,
      "max_passengers": 3,
      "max_bags": 3
    },
    {
      "car_type": "People Carrier",
      "price_gbp": 98,
      "max_passengers": 5,
      "max_bags": 5
    },
    {
      "car_type": "8 Seater",
      "price_gbp": 119,
      "max_passengers": 8,
      "max_bags": 8
    }
  ],
  "meeting_point": {
    "name": "Heathrow T5",
    "instructions": "Our driver will hold a board with your name inside the terminal..."
  }
}

Create a confirmed transfer booking. This creates a real reservation — only call after your customer confirms.

Request Body

curl -X POST https://mcp.airport-pickups-london.com/api/book \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "origin": "Heathrow Terminal 5",
    "destination": "10 Downing Street, London, SW1A 2AA",
    "transfer_date": "2026-03-15",
    "transfer_time": "14:30",
    "passengers": 2,
    "suitcases": 2,
    "car_type": "Saloon",
    "passenger_name": "John Smith",
    "passenger_phone": "+447123456789",
    "passenger_email": "john@example.com",
    "door_number": "10",
    "flight_number": "BA2534",
    "special_requests": "Child seat needed"
  }'

{
  "booking_ref": "APL-X7K9M2",
  "external_ref": 954226,
  "status": "confirmed",
  "pickup": "London Heathrow Airport, Terminal 5",
  "dropoff": "10 Downing Street, Downing Street, London SW1A 2AA, UK",
  "date": "2026-03-15",
  "time": "14:30",
  "car_type": "Saloon",
  "price_gbp": 88,
  "passengers": 2,
  "passenger": {
    "name": "John Smith",
    "phone": "+447123456789",
    "email": "john@example.com"
  },
  "duration": "51 minutes",
  "manage_booking_url": "https://www.airport-pickups-london.com/manage-booking.html?reservationId=954226&email=john%40example.com",
  "meeting_point": {
    "name": "Heathrow T5",
    "instructions": "Our driver will hold a board with your name inside the terminal..."
  },
  "flight_info": {
    "airline": "British Airways",
    "flight_number": "BA2534",
    "arrival_airport": "Heathrow",
    "arrival_terminal": "T5",
    "arrival_time": "14:30",
    "departure_airport": "DXB"
  },
  "message": "Booking confirmed! You can pay the driver in cash on the day, or if you prefer to pay by card, Apple Pay, or Google Pay, use the manage booking link."
}

Response Fields

Retrieve the current status and details of an existing booking.

Verification required. External and partner agents must supply both the booking reference and the passenger email that is on file — the same verification a passenger performs on the "Manage Booking" page. Requests missing either field return 400.

Request Body

curl -X POST https://mcp.airport-pickups-london.com/api/lookup-booking \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "booking_ref": "APL-X7K9M2",
    "email": "john@example.com"
  }'

{
  "booking_ref": "APL-X7K9M2",
  "status": "confirmed",
  "pickup": "London Heathrow Airport, Terminal 5",
  "dropoff": "10 Downing Street, London SW1A 2AA",
  "date": "2026-03-15",
  "time": "14:30",
  "car_type": "Saloon",
  "price_gbp": 88,
  "passenger": {
    "name": "John Smith",
    "phone": "+447123456789",
    "email": "john@example.com"
  },
  "driver": {
    "name": "David Johnson",
    "phone": "+447900123456"
  },
  "manage_booking_url": "https://www.airport-pickups-london.com/manage-booking.html?reservationId=954226&email=john%40example.com"
}

Response Fields

Amend details on an existing booking. You can update one or more fields at a time — only include the fields you want to change.

Verification required. External and partner agents must supply both the booking reference and the passenger email on file (case-insensitive match). passenger_email itself cannot be changed via this endpoint — it is the customer's key to the booking; email corrections go to info@aplcars.com from the address used at booking.

Request Body

Amendable Fields (inside changes)

curl -X POST https://mcp.airport-pickups-london.com/api/amend-booking \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "booking_ref": "APL-X7K9M2",
    "email": "john@example.com",
    "changes": {
      "passenger_phone": "+447999888777",
      "flight_number": "BA2590",
      "transfer_time": "15:00"
    }
  }'

{
  "success": true,
  "booking_ref": "APL-X7K9M2",
  "amended_fields": ["passenger_phone", "flight_number", "transfer_time"]
}

Response Fields

Cancel an existing booking. Free cancellation is available 12 or more hours before the scheduled pickup time.

Verification required. External and partner agents must supply both the booking reference and the passenger email on file.

Request Body

curl -X POST https://mcp.airport-pickups-london.com/api/cancel-booking \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "booking_ref": "APL-X7K9M2",
    "email": "john@example.com",
    "reason": "Flight cancelled"
  }'

{
  "success": true,
  "booking_ref": "APL-X7K9M2",
  "status": "cancelled",
  "hours_before_pickup": 26.5,
  "admin_fee": 0
}

Response Fields

Get live driver location and vehicle details for an active booking. Returns the assigned driver’s information, GPS coordinates, heading, speed, and estimated time of arrival.

Verification required. External and partner agents must supply both the booking reference and the passenger email on file.

Request Body

curl -X POST https://mcp.airport-pickups-london.com/api/track \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "booking_ref": "APL-X7K9M2",
    "email": "john@example.com"
  }'

{
  "booking_ref": "APL-X7K9M2",
  "driver": {
    "name": "David Johnson",
    "photo_url": "https://api.london-tech.com/drivers/photos/8042.jpg",
    "phone": "+447900123456",
    "pco_licence": "012345"
  },
  "vehicle": {
    "make": "Mercedes-Benz",
    "model": "E-Class",
    "colour": "Black",
    "registration": "AB12 CDE"
  },
  "position": {
    "latitude": 51.4700,
    "longitude": -0.4543,
    "heading": 85,
    "speed_mph": 42,
    "is_interpolated": false
  },
  "eta_minutes": 8
}

Response Fields

Returns the Agent Card describing APL's capabilities, skills, and authentication requirements. No API key required.

curl https://mcp.airport-pickups-london.com/.well-known/agent.json

Returns a JSON Agent Card with:

• name — Agent identifier (airport-pickups-london)
• supported_interfaces — A2A endpoint URL and protocol version
• skills — Available skills with descriptions, tags, and examples
• security_schemes — How to authenticate (API key in x-api-key header, optional — anonymous access is allowed)
• capabilities — Supported features (streaming, push notifications)

Send a message to the APL agent. The agent processes the message, executes the appropriate skill, and returns a task with the result.

Task States

Option 1: DataPart (Recommended)

Send structured JSON data with a skill field for explicit routing, or omit it for auto-detection.

curl -X POST https://mcp.airport-pickups-london.com/a2a \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{
          "type": "data",
          "mimeType": "application/json",
          "data": {
            "skill": "get_quote",
            "origin": "Heathrow",
            "destination": "W1K 1LN",
            "passengers": 2,
            "transfer_date": "2026-04-01",
            "transfer_time": "14:00"
          }
        }]
      }
    }
  }'

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "id": "a1b2c3d4-...",
    "status": { "state": "completed" },
    "artifacts": [{
      "name": "quote",
      "parts": [{
        "type": "data",
        "mimeType": "application/json",
        "data": {
          "hub": "LHR",
          "zone": "W1",
          "direction": "from_hub",
          "recommended_car_type": "Saloon",
          "from_hub": [
            { "car_type": "Saloon", "price_gbp": 75, "max_passengers": 3 },
            { "car_type": "People Carrier", "price_gbp": 90, "max_passengers": 5 }
          ]
        }
      }]
    }]
  }
}

curl -X POST https://mcp.airport-pickups-london.com/a2a \
  -H "Content-Type: application/json" \
  -H "x-api-key: your-api-key" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{
          "type": "data",
          "mimeType": "application/json",
          "data": {
            "skill": "create_booking",
            "origin": "Heathrow Terminal 5",
            "destination": "10 Downing Street, SW1A 2AA",
            "transfer_date": "2026-04-01",
            "transfer_time": "14:00",
            "passenger_name": "John Smith",
            "passenger_phone": "+447123456789",
            "passenger_email": "john@example.com",
            "passengers": 2,
            "car_type": "Saloon",
            "flight_number": "BA2534",
            "door_number": "10"
          }
        }]
      }
    }
  }'

Option 2: TextPart (Natural Language)

Send plain text. The agent will return input-required with the expected JSON schema.

{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "message/send",
    "params": {
      "message": {
        "role": "user",
        "parts": [{
          "type": "text",
          "text": "How much is a ride from Heathrow to central London?"
        }]
      }
    }
  }

Auto-Detection

If you omit the skill field from a DataPart, the agent auto-detects:

• Has passenger_name? → routes to create_booking
• Has origin / destination? → routes to get_quote

Retrieve a previously created task by its ID. Tasks are stored in memory for 1 hour.

{
  "jsonrpc": "2.0",
  "id": 4,
  "method": "tasks/get",
  "params": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Returns the full task object with status, artifacts, and history. Returns error code -32001 if the task is not found or has expired.

Cancel a task that is still in progress. Only tasks in submitted, working, or input-required states can be canceled.

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tasks/cancel",
  "params": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Returns the updated task with status.state: "canceled", or error code -32002 if the task has already completed.

Public endpoint — no authentication needed. Rate limited to 3 registrations per IP per hour.

Request Body

Example Request

{
  "name": "TravelBot AI",
  "email": "dev@travelbot.com",
  "url": "https://travelbot.com"
}

Example Response (201 Created)

{
  "agent_name": "TravelBot AI",
  "api_key": "a1b2c3d4e5f6...",
  "message": "API key created. Use this key in the x-api-key header for all A2A, REST API, and MCP requests."
}

Public endpoint — no authentication needed. Rate limited to 3 per IP per hour. Your API key is issued but inactive until approved.

Request Body

Example Request

{
  "company_name": "TravelTech AI Ltd",
  "company_reg_number": "12345678",
  "vat_number": "GB123456789",
  "company_address": "100 Innovation Way, London EC2A 1NT",
  "contact_name": "Sarah Johnson",
  "email": "sarah@traveltech-ai.com",
  "phone": "+44 20 7123 4567",
  "accounts_payable_email": "ap@traveltech-ai.com",
  "estimated_monthly_volume": 500,
  "estimated_monthly_spend": 25000,
  "preferred_vehicles": "Saloon, Executive, MPV",
  "primary_routes": "Heathrow, Gatwick, Central London hotels",
  "billing_type": "invoice",
  "payment_terms": 30,
  "url": "https://traveltech-ai.com"
}

Example Response (201 Created — Pending)

{
  "status": "pending",
  "company_name": "TravelTech AI Ltd",
  "message": "Corporate account application received. Our team will review your application and contact you within 1-2 business days. Your API key will be activated upon approval.",
  "contact": "corporate@aplcars.com"
}