KeyFlight PNR Converter

io.keyflightPublished by keyflight.ioOfficial publisherv1.0.0Updated Oct 28, 2026

Decode Amadeus, Sabre, Galileo and Worldspan PNRs into itineraries, JSON and PRO ticket PDFs.

VerifiedStreamable HTTPWeb executableLocation & LifestyleDeveloper Tools

Overview

AI-generated overview

Hosted MCP server that decodes Amadeus, Sabre, Galileo and Worldspan PNRs into readable itineraries, JSON, and PRO ticket PDFs.

What you can do
  • Decode a raw GDS booking into a readable itinerary text and structured JSON with passengers, flights, airports, terminals, local times, duration and airline locators, choosing layout, time and date formats
  • Generate a PRO ticket PDF from a PNR with optional passenger names, booking code, cabin class, price, currency and logo, returning a link to the PDF
When to use it
Useful for travel agents and agencies working with GDS bookings, or developers adding PNR decoding to a booking tool, CRM, chat bot or e-mail flow, who want an assistant to turn pasted booking text into an itinerary or a traveller-facing ticket PDF.
Requirements
Remote Streamable HTTP endpoint at keyflight.io/mcp, POST only, no local install. A paid KeyFlight subscription is required (no free tier) and an API key sent as the Authorization header in the form Bearer kfp_…; keys are created on the subscription page and shown once. Claude Desktop connects through mcp-remote, which needs Node.js.
Before you install
The Authorization header carries a secret API key; it is shown once and up to two keys can exist per subscription. Every decode that finds flights counts against a monthly quota of 3,000 shared by both keys and the HTTP API, and tickets are capped at 30 an hour per key. The PRO ticket is a traveller document, not an airline ticket, and its PNR is not checked against airline systems. Requests from other websites' pages are refused.

Installation

In SourceWeft

  1. Open KeyFlight PNR Converter in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.keyflight%2Fpnr/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "keyflight-pnr-converter": {
      "type": "http",
      "url": "https://keyflight.io/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

[KeyFlight PNR API & MCP: decode Amadeus, Sabre, Galileo and Worldspan PNRs in Claude, Cursor or your code]

KeyFlight PNR Converter: MCP server and PNR API

Paste a raw booking from a GDS (Amadeus, Sabre, Galileo, Worldspan) into Claude, Cursor or another AI assistant and get a readable itinerary, the booking as JSON, or a PRO ticket PDF.

KeyFlight runs a hosted Model Context Protocol server at https://keyflight.io/mcp and an HTTP API at https://keyflight.io/api/v1/pnr/decode. Both use the same decoder as the free PNR converter on keyflight.io.

This repository holds the documentation and examples. The server itself is hosted by KeyFlight: there is nothing to install or run. Full reference: keyflight.io/pnr-api.

Who it is for: travel agents and agencies who work with GDS bookings, and developers who add PNR decoding to a booking tool, CRM, chat bot or e-mail flow.

Get an API key

The MCP server and the PNR API take the same key, kfp_ followed by 43 letters, digits, - and _.

  1. Get the KeyFlight subscription (the subscription for travel agents).
  2. On the same page use "Already subscribed?", open the link we e-mail you and press "Create API key".
  3. Copy the key: it is shown once. A subscription can have 2 keys at a time; you revoke a key on the same page.

While the subscription is not active, the key answers 403 subscription_inactive. There is no free tier for the API or the MCP server. The PNR converter on the website is free for everyone, with no key.

Connect an AI assistant (MCP)

Server URLhttps://keyflight.io/mcp
TransportStreamable HTTP, POST only, no sessions and no server-sent event stream
Authenticationheader Authorization: Bearer kfp_…
Protocol versions2025-06-18, 2025-03-26, 2024-11-05

Claude Code

bash
claude mcp add --transport http keyflight https://keyflight.io/mcp --header "Authorization: Bearer kfp_…"

Cursor (.cursor/mcp.json)

json
{  "mcpServers": {    "keyflight": {      "url": "https://keyflight.io/mcp",      "headers": {        "Authorization": "Bearer kfp_…"      }    }  }}

Claude Desktop (claude_desktop_config.json, needs Node.js)

Claude Desktop connects through mcp-remote:

json
{  "mcpServers": {    "keyflight": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://keyflight.io/mcp",        "--header",        "Authorization: Bearer kfp_…"      ]    }  }}

Cline (cline_mcp_settings.json)

In Cline open MCP Servers → Configure MCP Servers and add:

json
{  "mcpServers": {    "keyflight": {      "type": "streamableHttp",      "url": "https://keyflight.io/mcp",      "headers": {        "Authorization": "Bearer kfp_…"      },      "disabled": false,      "autoApprove": []    }  }}

Step-by-step notes for AI agents that install the server: llms-install.md.

Then ask, for example: "Decode this PNR and make a PRO ticket with a price of 850 EUR" and paste the booking.

Other clients: any MCP client that supports Streamable HTTP and custom headers. Requests sent from web pages of other sites (with a browser Origin header) are refused with 403 origin_not_allowed, so connect from a desktop app, a CLI or your server. Without a client, see examples/mcp/raw-jsonrpc.sh: one JSON-RPC message per POST, JSON back.

MCP tools

decode_pnr: decode a PNR

Turns a raw PNR into a readable itinerary (text) and structured JSON: passengers, flights, airports, terminals, local times, flight duration, airline locators.

ArgumentTypeDefaultDescription
textstring, requiredThe PNR as the GDS shows it, up to 20,000 characters. The format is recognised from the text.
viewtable, lines2, lines3, whatsapptableLayout of the itinerary text.
time_format"24", "12""24"24 or 12 hour time.
date_format"short", "numeric""short"short: 3 May 2026, numeric: 03.05.2026.

Returns the itinerary text, then JSON: and the same JSON as the PNR API answer. Clients that read structuredContent get that JSON there.

Each decode that finds flights counts towards the monthly decodes of the subscription, like an API call. A text without flights returns an error and does not count. When the decodes of the month are used up, the tool returns an error until the 1st (UTC).

make_ticket: make a PRO ticket PDF

Makes a PRO ticket PDF (PNR, airline logos, class, optional price) from a raw PNR and returns a link to the PDF. Included in the KeyFlight subscription.

The ticket is a document for the traveller: it is not an airline ticket and its PNR is not checked against airline systems.

ArgumentTypeDefaultDescription
textstring, requiredThe PNR, up to 20,000 characters. Every flight needs a date and times.
passengersarray of strings, up to 20the names in the PNRPassenger names as on the ticket, e.g. "SMITH/JOHN MR".
pnrstringthe code in the text, or a random oneBooking code printed on the ticket, 5–8 letters and digits.
booking_classEconomy, Premium Economy, Business, First Classthe cabin of the first flight's booking classClass on the ticket.
pricestringno price on the ticketTotal price printed on the ticket, e.g. "1200.50".
currencystring, up to 10 characters"$"Currency next to the price, e.g. "USD", "€".
logonone, expeditionnoneLogo in the ticket header.
time_format"24", "12""24"24 or 12 hour time.
date_format"short", "numeric"short or numeric.

Returns a line PRO ticket PDF: https://keyflight.io/tickets/….pdf with the PNR, the number of flights and the passengers, and as structuredContent:

json
{ "url": "https://keyflight.io/tickets/….pdf", "pnr": "PQ7XNR", "passengers": ["JOHNSON JOHN", "JOHNSON JANE"], "segments": 2 }

Tickets do not count towards the monthly decodes; one key can make up to 30 tickets an hour.

Errors (no flights in the text, a flight without a date or time, no passenger names, a wrong pnr or option, more than 30 tickets in an hour) come back as tool results with isError: true, so the assistant can read them and fix the call.

PNR API over HTTP

POST https://keyflight.io/api/v1/pnr/decode with Content-Type: application/json and Authorization: Bearer kfp_…. The body is { "text": "…", "options": { … } }. The HTTP API returns data and the itinerary as text and HTML; PRO ticket PDFs come from the MCP tool make_ticket. The examples below send the Amadeus booking from examples/pnr-amadeus.txt.

curl

bash
curl https://keyflight.io/api/v1/pnr/decode \  -H "Authorization: Bearer $KEYFLIGHT_API_KEY" \  -H "Content-Type: application/json" \  -d '{  "text": "RP/LHRBA/LHRBA            BA/BA  26APR26/1200Z   PQ7XNR\nPQ7XNR/BA QLHR 03MAY\n1.JOHNSON JOHN\n2.JOHNSON JANE\n3  BA 178 Y 03MAY 7 LHRJFK HK2  0855 1205  03MAY  E  BA/PQ7XNR\n4  BA 117 Y 10MAY 7 JFKLHR HK2  1830 0640  11MAY  E  BA/PQ7XNR\n5 TKT/TIME LIMIT\n6 OPC LHRBA-10MAY:1900/1S2/Q TKT/T-BA\n7 FA PAX 125-2196837482/ETBA/GBP560.20/03MAY26/LHRBA2104/00390755/S3-4",  "options": {    "view": "table"  }}'

Node.js 18+

examples/api/decode.mjs:

js
// Node.js 18+ (fetch is built in), in an ES module or an async functionconst text = `RP/LHRBA/LHRBA            BA/BA  26APR26/1200Z   PQ7XNRPQ7XNR/BA QLHR 03MAY1.JOHNSON JOHN2.JOHNSON JANE3  BA 178 Y 03MAY 7 LHRJFK HK2  0855 1205  03MAY  E  BA/PQ7XNR4  BA 117 Y 10MAY 7 JFKLHR HK2  1830 0640  11MAY  E  BA/PQ7XNR5 TKT/TIME LIMIT6 OPC LHRBA-10MAY:1900/1S2/Q TKT/T-BA7 FA PAX 125-2196837482/ETBA/GBP560.20/03MAY26/LHRBA2104/00390755/S3-4`;
const response = await fetch('https://keyflight.io/api/v1/pnr/decode', {  method: 'POST',  headers: {    Authorization: `Bearer ${process.env.KEYFLIGHT_API_KEY}`,    'Content-Type': 'application/json',  },  body: JSON.stringify({ text, options: { "view": "table" } }),});const data = await response.json();if (response.ok) {  data.segments.forEach((s) => console.log(s.airlineCode, s.flightNumber, s.departure.date));} else {  console.error(response.status, data.error, data.message);}

Python

examples/api/decode.py (needs requests):

python
import osimport requests
text = """RP/LHRBA/LHRBA            BA/BA  26APR26/1200Z   PQ7XNRPQ7XNR/BA QLHR 03MAY1.JOHNSON JOHN2.JOHNSON JANE3  BA 178 Y 03MAY 7 LHRJFK HK2  0855 1205  03MAY  E  BA/PQ7XNR4  BA 117 Y 10MAY 7 JFKLHR HK2  1830 0640  11MAY  E  BA/PQ7XNR5 TKT/TIME LIMIT6 OPC LHRBA-10MAY:1900/1S2/Q TKT/T-BA7 FA PAX 125-2196837482/ETBA/GBP560.20/03MAY26/LHRBA2104/00390755/S3-4"""
response = requests.post(    "https://keyflight.io/api/v1/pnr/decode",    headers={"Authorization": f"Bearer {os.environ['KEYFLIGHT_API_KEY']}"},    json={"text": text, "options": { "view": "table" }},    timeout=30,)data = response.json()if response.ok:    for s in data["segments"]:        print(s["airlineCode"], s["flightNumber"], s["departure"]["date"])else:    print(response.status_code, data["error"], data["message"])

Options

FieldValuesDefault
textRequired. The booking as the GDS shows it, up to 20,000 characters.
options.viewtable, lines2, lines3, whatsapp: the layout of itinerary.table
options.timeFormat"24" (18:30), "12" (6:30 PM)"24"
options.dateFormat"short" (3 May 2026), "numeric" (03.05.2026)"short"
options.show.logotrue / false. Airline logos (HTML only).true
options.show.airportstrue / false. Airport names and terminals next to the city.true
options.show.cabintrue / false. Cabin and booking class: Economy (Y).false
options.show.statustrue / false. Segment status: Confirmed, Waitlisted.false
options.show.passengerstrue / false. Passenger names above the flights.false
options.show.pnrtrue / false. The booking reference and the airlines' references above the flights.false

An unknown option or a wrong value answers 400 invalid_option with the field and the allowed values.

Response

The full answer to the example above: examples/api/response-example.json (itinerary.html shortened). Main fields:

FieldMeaning
pnrCodeThe booking reference found in the text, or null.
passengers[].nameA passenger name as the PNR writes it.
segments[].airlineCode, airlineName, flightNumberAirline and flight number ("950" for UA0950).
segments[].bookingClass, cabinBooking class letter and cabin by it: Economy, Premium Economy, Business, First Class.
segments[].status, statusTextStatus code as in the PNR ("HK2") and Confirmed, Waitlisted or the code itself.
segments[].logoUrlAirline logo, 64×64 PNG.
segments[].durationFlight time in minutes across the two airports' time zones, or null.
segments[].distance{ km, miles } between the airports, or null.
segments[].aircraftCode, aircraftAircraft type when the PNR shows it, or null.
segments[].operatedByOperating airline as the PNR prints it (OPERATED BY …), or null.
segments[].airlineLocator{ airlineCode, code }: the airline's own booking reference, or null.
segments[].departure, arrivalcode, city, airport, terminal, local date (YYYY-MM-DD) and time (HH:MM).
itineraryview, text and html (e-mail HTML with tables and inline styles; null for whatsapp).

itinerary.html of the example in the table view, with options.show.logo: false, as the free converter shows it:

[Decoded itinerary of the example booking: BA 178 London (LHR) to New York (JFK) on 3 May 2026, BA 117 New York (JFK) to London (LHR) on 10 May 2026]

Limits

LimitValue
PNR textup to 20,000 characters; JSON body up to 100kb
Requests per key60 a minute on the API and 60 a minute on the MCP server; over it 429 too_many_requests with Retry-After
Requests per IP address120 a minute
Decodes per subscription3,000 a calendar month (UTC), both keys together, API and decode_pnr together. Only decodes that found flights count.
PRO ticket PDFs (make_ticket)30 an hour per key

Answers of the HTTP API carry X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-Monthly-Limit, X-Monthly-Remaining, X-Monthly-Reset.

Errors

PNR API errors are JSON: { "error": "<code>", "message": "…" }.

StatuserrorWhen
400invalid_jsonThe body is not a JSON object.
400text_requiredtext is missing or empty.
400invalid_optionAn unknown option or a wrong value. field names it, allowed lists the values.
401missing_api_keyNo Authorization: Bearer … header.
401invalid_api_keyThe key is not valid or was revoked.
403subscription_inactiveThe subscription of the key is not active.
404not_foundNo such endpoint.
405method_not_allowedThe method is not POST.
413too_longThe text is longer than 20,000 characters (max in the answer).
413payload_too_largeThe body is larger than 100kb.
415unsupported_encodingThe body is not UTF-8.
422no_flightsNo flights in the text. Does not count towards the monthly limit.
429too_many_requestsOver the per-minute limit; wait Retry-After seconds.
429monthly_limit_reachedThe subscription has used its decodes for this month.
500server_errorSomething went wrong on our side.
503service_unavailableThe key cannot be checked right now. Try again in a minute.

Before a tool runs, the MCP server answers in the same JSON: 401 missing_api_key / invalid_api_key, 403 subscription_inactive, 429 too_many_requests and 503 service_unavailable; also 403 origin_not_allowed for requests from web pages of other sites and 405 method_not_allowed for anything but POST. Inside a tool, errors (the monthly limit too) are tool results with isError: true.

Supported GDS formats

Amadeus (1A), Sabre (1B/1S), Galileo (1G) and Worldspan (1P). Send the booking as the GDS shows it; you don't need to say which system it came from. Example bookings for each system: Amadeus, Sabre, Galileo, Worldspan.

Links

License

The examples and documentation in this repository are under the MIT License. The KeyFlight service is not open source; using it needs a KeyFlight subscription.

Source: README.md at commit f0ebd7c

Tools

0
This server asks for a credential such as an API key, so SourceWeft could not read its tools without one and has not indexed them.

Version history

1
  1. v1.0.0LatestOct 20, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts