Flight ARB MCP API

Search for regional flight price arbitrage opportunities programmatically

🔑 Authentication

All MCP API endpoints require an API key. Generate your API key from your dashboard.

Include your API key in requests using one of these methods:

X-API-Key Header (Recommended)

X-API-Key: fa_your_api_key_here

Authorization Bearer

Authorization: Bearer fa_your_api_key_here

💰 Credits System

✓New accounts receive 100 free MCP API credits
✓Each flight search consumes 1 credit
✓Credits are only deducted for successful searches
!When credits are exhausted, API returns 402 Payment Required

📡 Endpoints

GET/api/mcp/flights

Search for flight prices across 5 regions and find arbitrage opportunities.

Query Parameters

Parameter	Type	Required	Description
departure	string	Yes	Departure airport code (e.g., "JFK")
arrival	string	Yes	Arrival airport code (e.g., "LHR")
date	string	Yes	Flight date in YYYY-MM-DD format

Example Request

curl -H "X-API-Key: fa_your_api_key" \
  "https://flightarb.com/api/mcp/flights?departure=JFK&arrival=LHR&date=2026-03-15"

Example Response

{
  "success": true,
  "query": {
    "departure": "JFK",
    "arrival": "LHR",
    "date": "2026-03-15"
  },
  "results": {
    "bestRegion": "uk",
    "bestPrice": 680,
    "worstPrice": 800,
    "savings": 120,
    "savingsPercent": 15,
    "regionalPrices": [
      { "region": "us", "price": 800, "currency": "USD" },
      { "region": "uk", "price": 680, "currency": "GBP" },
      { "region": "de", "price": 720, "currency": "EUR" },
      { "region": "ca", "price": 750, "currency": "CAD" },
      { "region": "au", "price": 760, "currency": "AUD" }
    ]
  },
  "creditsRemaining": 99,
  "creditsUsed": 1
}

GET/api/mcp/credits

Check your remaining MCP API credits and usage statistics.

Example Request

curl -H "X-API-Key: fa_your_api_key" \
  "https://flightarb.com/api/mcp/credits"

Example Response

{
  "credits": 95,
  "totalRequestsMade": 5,
  "hasCredits": true
}

POST/api/mcp/key/regenerate

Generate or regenerate your MCP API key. Requires session authentication (not API key).

⚠️ Warning: Regenerating your API key will invalidate your existing key. The new key is only shown once.

Example Response

{
  "success": true,
  "apiKey": "fa_aBcDeFgHiJkLmNoPqRsTuVwXyZ123456",
  "message": "Store this API key securely. It will not be shown again.",
  "usage": {
    "header": "X-API-Key: fa_aBcDeFgHiJkLmNoPqRsTuVwXyZ123456",
    "curlExample": "curl -H \"X-API-Key: fa_...\""
  }
}

⚠️ Error Codes

Status	Description
200	Success
400	Bad Request - Missing or invalid parameters
401	Unauthorized - Invalid or missing API key
402	Payment Required - No credits remaining
404	Not Found - No flights found (credit not deducted)
500	Server Error - Something went wrong

🤖 MCP Tool Configuration

To use Flight ARB as an MCP tool with AI assistants, add this configuration:

{
  "name": "flight_arb_search",
  "description": "Search for flight price arbitrage opportunities across different regions",
  "input_schema": {
    "type": "object",
    "properties": {
      "departure": {
        "type": "string",
        "description": "Departure airport code (e.g., JFK, LAX)"
      },
      "arrival": {
        "type": "string",
        "description": "Arrival airport code (e.g., LHR, CDG)"
      },
      "date": {
        "type": "string",
        "description": "Flight date in YYYY-MM-DD format"
      }
    },
    "required": ["departure", "arrival", "date"]
  }
}