---

name: runrelay description: "Search and book flights, hotels, and travel via RunRelay API. Covers 300+ airlines including low-cost carriers (Ryanair, Wizz Air, EasyJet) that no other API offers. Use when: (1) user asks about flights or hotels, (2) user wants to plan or book a trip, (3) user needs LCC coverage, (4) travel agent or concierge tasks. MCP-compatible, OpenAI-compatible."

RunRelay — Travel API for AI Agents

The only travel API that covers low-cost carriers (Ryanair, Wizz Air, EasyJet = 33% of EU flights) alongside 300+ GDS airlines. Human-in-the-loop booking for LCCs, instant API for GDS.

Setup

# Add to ~/.openclaw/.env
RUNRELAY_API_KEY=rr_live_your_key_here

Get key: https://app.runrelay.io

Base URL

https://api.runrelay.io

Auth: Authorization: Bearer $RUNRELAY_API_KEY

Search Flights

curl -X POST https://api.runrelay.io/api/search-flights \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $RUNRELAY_API_KEY" \
  -d '{
    "origin": "DXB",
    "destination": "LHR",
    "departureDate": "2026-03-15",
    "passengers": {"adults": 1}
  }'

Response: Array of offers sorted by 30% time + 30% price + 20% airline + 15% layover.

Tiers

• Tier 1 (Instant): Duffel/GDS — 300+ airlines, instant results
• Tier 2 (HITL): Human operators — Ryanair, Wizz Air, EasyJet. 3-8 min async. Polling via GET /api/search-status/:id

Search Hotels

curl -X POST https://runrelay-hotels.fly.dev/api/search-hotels \
  -H "Content-Type: application/json" \
  -d '{
    "city": "London",
    "checkin": "2026-03-15",
    "checkout": "2026-03-20",
    "guests": 2
  }'

Provider: RateHawk (700K+ properties worldwide).

Book Flight

curl -X POST https://api.runrelay.io/api/book-flight \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $RUNRELAY_API_KEY" \
  -d '{
    "offerId": "off_abc123",
    "passengers": [{
      "firstName": "John",
      "lastName": "Doe",
      "email": "john@example.com",
      "phone": "+44123456789",
      "birthDate": "1990-01-15",
      "gender": "male"
    }]
  }'

Multi-Agent Trip Planning

Orchestrate parallel flight + hotel + activity searches:

curl -X POST https://prefy.com/api/v1/orchestrate \
  -H "Content-Type: application/json" \
  -d '{
    "destination": "LHR",
    "origin": "DXB",
    "date": "2026-03-15",
    "nights": 5
  }'

Returns combined results from 3 parallel agents.

MCP Server

RunRelay also works as an MCP server for Claude, Cursor, and other MCP clients:

• Endpoint: https://api.runrelay.io
• Protocol: MCP (Model Context Protocol)
• Tools: search_flights, search_hotels, book_flight, get_booking

Endpoints

Endpoint	Method	Description
/api/search-flights	POST	Search flights (GDS + LCC)
/api/search-status/:id	GET	Poll HITL search status
/api/flights/:id	GET	Flight offer details
/api/book-flight	POST	Book a flight
/api/bookings	GET	List bookings
/api/search-hotels	POST	Search hotels (RateHawk)
/api/v1/orchestrate	POST	Multi-agent trip planning

Why RunRelay

• Only API with LCC coverage — Ryanair, Wizz = 33% of EU market
• Human-in-the-loop — real operators book what APIs can't
• MCP native — first travel MCP server
• OpenAI-compatible — drop-in for any AI agent
• B2B ready — white-label, API keys, usage dashboard