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": "[email protected]",
    "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": "[email protected]"
  },
  "duration": "51 minutes",
  "meeting_point": {
    "name": "Heathrow T5",
    "instructions": "Our driver will hold a board with your name inside the terminal..."
  },
  "message": "Booking confirmed."
}

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)
• 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": "[email protected]",
            "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": "[email protected]",
  "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."
}