KeyFlight PNR Converter

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
• Connect an AI assistant (MCP)
• MCP tools
• PNR API over HTTP
• Limits
• Errors
• Supported GDS formats

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)

Claude Code

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

Cursor (.cursor/mcp.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:

{

"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:

{

"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.

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.

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

{ "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

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:

// Node.js 18+ (fetch is built in), in an ES module or an async function

const text = RP/LHRBA/LHRBA BA/BA 26APR26/1200Z PQ7XNR PQ7XNR/BA QLHR 03MAY 1.JOHNSON JOHN 2.JOHNSON JANE 3 BA 178 Y 03MAY 7 LHRJFK HK2 0855 1205 03MAY E BA/PQ7XNR 4 BA 117 Y 10MAY 7 JFKLHR HK2 1830 0640 11MAY E BA/PQ7XNR 5 TKT/TIME LIMIT 6 OPC LHRBA-10MAY:1900/1S2/Q TKT/T-BA 7 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):

import os

import requests

text = """RP/LHRBA/LHRBA BA/BA 26APR26/1200Z PQ7XNR PQ7XNR/BA QLHR 03MAY 1.JOHNSON JOHN 2.JOHNSON JANE 3 BA 178 Y 03MAY 7 LHRJFK HK2 0855 1205 03MAY E BA/PQ7XNR 4 BA 117 Y 10MAY 7 JFKLHR HK2 1830 0640 11MAY E BA/PQ7XNR 5 TKT/TIME LIMIT 6 OPC LHRBA-10MAY:1900/1S2/Q TKT/T-BA 7 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") else: print(response.status_code, data["error"], data["message"])

Options

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:

| segments[].duration | Flight time in minutes across the two airports' time zones, or null