MCP Model Context Protocol

Janah MCP

Give your AI agent live flight search and booking for Saudi Arabia, powered by the same engine behind janah.sa, exposed over the Model Context Protocol.

What is Janah MCP

Janah MCP is a public Model Context Protocol server at api.janah.sa/mcp. AI clients like Claude Desktop and Cursor can search real, live-priced flights, turn plain-language requests (Arabic or English) into structured searches, and create a booking against a live offer.

Every result is priced exactly like the website: per-adult totals after Janah pricing, cheapest first. What an agent finds is what a traveler pays. Payment always happens through a link a human opens; an agent can create a booking but never completes payment on its own.

Tools

search_flights

Live one-way or round-trip search. Origin and destination are IATA airport codes (JED, RUH, DXB), dates are YYYY-MM-DD. Optional per-leg departure/arrival time bounds and cabin class. Returns offers with per-adult total amounts.

parse_trip_request

Turns free-text trip requests into a structured search, for example "رحلة من جدة إلى الرياض الخميس الساعة 5 مساءً لشخصين" or "flights from Jeddah to Dubai next Friday at 9am for two". Relative dates and weekdays resolve against Asia/Riyadh; missing details come back as a clarification question.

create_booking

Creates a booking from a live offer id and opens a Streampay checkout link. Passengers must match the offer's passenger counts, names in Latin script. Never charges anything by itself; a human has to open the link to pay.

get_booking_status

Looks up a booking by reference and contact email. Returns its status, and a fresh checkout link when it is still payable.

Get a key

Sign in with your Janah account to create a personal key. It's shown in full once, right after you create it, and you can revoke it any time.

Get a key

Configure a client

Example for Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "janah": {
      "type": "http",
      "url": "https://api.janah.sa/mcp",
      "headers": { "Authorization": "Bearer janah_your_key_here" }
    }
  }
}

Cursor, Windsurf, and other MCP clients read the same mcpServers JSON. Only the config file location differs.

Endpointhttps://api.janah.sa/mcp

AuthenticationAuthorization: Bearer <key>

MCP is an AI integration point. Payment always happens through a link a human opens, never inside the agent. You can also book directly on janah.sa at any time.