faa-airmen-registry-mcp-server

v0.2.0 pre-1.0

Search FAA airmen certificates, ratings, and informational medical records via MCP. STDIO or Streamable HTTP.

public 6 tools protocol 2026-07-28 github cyanheads/faa-airmen-registry-mcp-server
faa-airmen-registry.caseyjhand.com/mcp 
claude mcp add --transport http faa-airmen-registry-mcp-server https://faa-airmen-registry.caseyjhand.com/mcp
codex mcp add faa-airmen-registry-mcp-server --url https://faa-airmen-registry.caseyjhand.com/mcp
{
  "mcpServers": {
    "faa-airmen-registry-mcp-server": {
      "url": "https://faa-airmen-registry.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http faa-airmen-registry-mcp-server https://faa-airmen-registry.caseyjhand.com/mcp
{
  "mcpServers": {
    "faa-airmen-registry-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://faa-airmen-registry.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "faa-airmen-registry-mcp-server": {
      "type": "http",
      "url": "https://faa-airmen-registry.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://faa-airmen-registry.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'
Built on@cyanheads/mcp-ts-core v0.13.15

Tools

6

faa_airmen_verify_certificate

Find releasable FAA airman records by exact Unique ID or name and read their certificate records. Use name mode to discover IDs, then use an ID for ratings or informational medical fields. Certificate type, level, rating, and type-rating filters must all match one certificate, and each match still returns all its certificates. While the operator's personal-data redaction is on (the default), name mode needs lastName and firstName, nameMatch prefix and city or ZIP filters are rejected, and city and ZIP are withheld. A missing or matching record is not a current licensing or operating-privilege determination.

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_verify_certificate",
    "arguments": {
      "mode": "<mode>"
    }
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "id",
        "name"
      ],
      "description": "id requires uniqueId and forbids nonblank name/location fields and explicit nameMatch; name requires lastName, plus firstName while personal-data redaction is on, and forbids nonblank uniqueId."
    },
    "uniqueId": {
      "description": "Opaque FAA Unique ID returned by faa_airmen_verify_certificate in name mode, A or C plus seven digits, for example A9999999; not a certificate number. Trimmed and uppercased.",
      "type": "string",
      "pattern": "^\\s*(?:[AaCc][0-9]{7}\\s*)?$"
    },
    "lastName": {
      "description": "LAST NAME, which may include a suffix; the default words match finds SMITH JR from SMITH. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "firstName": {
      "description": "FIRST NAME, which usually includes middle names; the default words match finds JOHN ROBERT from JOHN. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter state or territory; trimmed and uppercased. Blank means unset.",
      "type": "string"
    },
    "city": {
      "description": "Exact city, 1–60 visible characters; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string"
    },
    "zipCode": {
      "description": "Five-digit ZIP or ZIP+4, preserving leading zeros; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string",
      "pattern": "^\\s*(?:[0-9]{5}(?:-?[0-9]{4})?\\s*)?$"
    },
    "nameMatch": {
      "description": "How each supplied name field matches; default words for name searches. words: the field equals the term or continues with a space after it; only a space separates words, so a hyphenated or apostrophe name is one word. exact: the whole field. prefix: the field begins with the term, also mid-word; rejected while personal-data redaction is on.",
      "type": "string",
      "enum": [
        "words",
        "exact",
        "prefix"
      ]
    },
    "certificateType": {
      "description": "One FAA certificate type letter, its description from faa_airmen_list_reference topic certificate_types (case-insensitive; underscore or space, such as remote pilot or flight_instructor), or CFI; selects people while retaining all their certificates.",
      "type": "string"
    },
    "certificateLevel": {
      "description": "One level letter listed for the certificateType in faa_airmen_list_reference topic certificate_levels, such as A (airline transport pilot) with certificateType P; requires certificateType and matches the certificate's own level. Trimmed and uppercased; blank means unset.",
      "type": "string"
    },
    "ratingCodes": {
      "description": "One to eleven rating codes, repeats collapsed; every code must occur on the same certificate as every other requested credential, never across certificates.",
      "minItems": 1,
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "description": "FAA rating code from faa_airmen_list_reference topic ratings, such as INSTA, matching any source level; level/code such as F/INSTA matches that level only. The code is 1–30 letters, digits, spaces, or hyphens and the level one letter; trimmed and uppercased."
      }
    },
    "typeRatings": {
      "description": "One to eleven type-rating designators, repeats collapsed; every designator must occur on the same certificate as every other requested credential.",
      "minItems": 1,
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "description": "Aircraft type designator from faa_airmen_list_reference topic type_ratings, such as B-737, matching any source level; level/designator such as A/B-737 matches that slot level only, which can differ from certificateLevel. The designator is 1–30 letters, digits, spaces, or hyphens and the level one letter; trimmed and uppercased; hyphens are significant."
      }
    },
    "limit": {
      "default": 10,
      "description": "Maximum complete people or reference entries per page; default 10, maximum 50. A larger limit returns at most 50, with a notice.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset; default 0, maximum 10000. Follow nextOffset or narrow filters at the cap.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "required": [
    "mode",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

faa_airmen_get_type_ratings

Read all source aircraft type, category/class, and instrument ratings for one FAA airman Unique ID. Get the ID from faa_airmen_verify_certificate. Ratings retain their source certificate type and level and do not establish current operating privileges.

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_get_type_ratings",
    "arguments": {
      "uniqueId": "<uniqueId>"
    }
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "uniqueId": {
      "type": "string",
      "pattern": "^\\s*[AaCc][0-9]{7}\\s*$",
      "description": "Opaque FAA Unique ID from faa_airmen_verify_certificate, A or C plus seven digits, for example A9999999; not a certificate number."
    }
  },
  "required": [
    "uniqueId"
  ],
  "additionalProperties": false
}
view source ↗

faa_airmen_check_medical_status

Read the FAA snapshot's informational medical class, medical dates, and BasicMed dates for one airman Unique ID. These fields are not authoritative medical certification or fitness determinations. Get the ID from faa_airmen_verify_certificate. Every call is rejected while the operator's personal-data redaction is on (the default).

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_check_medical_status",
    "arguments": {
      "uniqueId": "<uniqueId>"
    }
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "uniqueId": {
      "type": "string",
      "pattern": "^\\s*[AaCc][0-9]{7}\\s*$",
      "description": "Opaque FAA Unique ID from faa_airmen_verify_certificate, A or C plus seven digits, for example A9999999; not a certificate number."
    }
  },
  "required": [
    "uniqueId"
  ],
  "additionalProperties": false
}
view source ↗

faa_airmen_search_instructors

Find releasable flight and ground instructor certificate records by name, state, and rating codes. Supply at least one name, state, city, ZIP, or rating filter. City and ZIP filters require operator-enabled location access. While the operator's personal-data redaction is on (the default), lastName and firstName are both required, nameMatch prefix and city or ZIP filters are rejected, and city and ZIP are withheld. Legacy expiry fields do not establish instructor currency; CFI certificates no longer expire under the December 2024 rule.

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_search_instructors",
    "arguments": {}
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "lastName": {
      "description": "LAST NAME, which may include a suffix; the default words match finds SMITH JR from SMITH. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "firstName": {
      "description": "FIRST NAME, which usually includes middle names; the default words match finds JOHN ROBERT from JOHN. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter state or territory; trimmed and uppercased. Blank means unset.",
      "type": "string"
    },
    "city": {
      "description": "Exact city, 1–60 visible characters; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string"
    },
    "zipCode": {
      "description": "Five-digit ZIP or ZIP+4, preserving leading zeros; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string",
      "pattern": "^\\s*(?:[0-9]{5}(?:-?[0-9]{4})?\\s*)?$"
    },
    "nameMatch": {
      "description": "How each supplied name field matches; default words for name searches. words: the field equals the term or continues with a space after it; only a space separates words, so a hyphenated or apostrophe name is one word. exact: the whole field. prefix: the field begins with the term, also mid-word; rejected while personal-data redaction is on.",
      "type": "string",
      "enum": [
        "words",
        "exact",
        "prefix"
      ]
    },
    "instructorType": {
      "default": "both",
      "description": "Select flight F, ground G, or both instructor certificate types; default both.",
      "type": "string",
      "enum": [
        "flight",
        "ground",
        "both"
      ]
    },
    "ratingCodes": {
      "description": "One to eleven codes, repeats collapsed; every code must occur on the same qualifying certificate, never across certificates. CFII is INSTA, INSTH, INSTI, or INSTP on a flight (F) certificate; MEI is AME or ASME on F; INST, ADV, and BASIC occur only on ground (G) certificates.",
      "minItems": 1,
      "maxItems": 11,
      "type": "array",
      "items": {
        "type": "string",
        "description": "FAA rating code from faa_airmen_list_reference topic ratings, such as INSTA, matching any source level; level/code such as F/INSTA matches that level only. The code is 1–30 letters, digits, spaces, or hyphens and the level one letter; trimmed and uppercased."
      }
    },
    "limit": {
      "default": 10,
      "description": "Maximum complete people or reference entries per page; default 10, maximum 50. A larger limit returns at most 50, with a notice.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset; default 0, maximum 10000. Follow nextOffset or narrow filters at the cap.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "required": [
    "instructorType",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

faa_airmen_verify_remote_pilot

Find releasable FAA remote pilot certificate records by Unique ID or name. While the operator's personal-data redaction is on (the default), name mode needs lastName and firstName, nameMatch prefix and city or ZIP filters are rejected, and city and ZIP are withheld. Results establish certificate presence in the local snapshot; they do not establish recurrent-training currency, commercial operating authority, or current Part 107 eligibility.

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_verify_remote_pilot",
    "arguments": {
      "mode": "<mode>"
    }
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "type": "string",
      "enum": [
        "id",
        "name"
      ],
      "description": "id requires uniqueId and forbids nonblank name/location fields and explicit nameMatch; name requires lastName, plus firstName while personal-data redaction is on, and forbids nonblank uniqueId."
    },
    "uniqueId": {
      "description": "Opaque FAA Unique ID returned by faa_airmen_verify_certificate in name mode, A or C plus seven digits, for example A9999999; not a certificate number. Trimmed and uppercased.",
      "type": "string",
      "pattern": "^\\s*(?:[AaCc][0-9]{7}\\s*)?$"
    },
    "lastName": {
      "description": "LAST NAME, which may include a suffix; the default words match finds SMITH JR from SMITH. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "firstName": {
      "description": "FIRST NAME, which usually includes middle names; the default words match finds JOHN ROBERT from JOHN. 1–60 visible characters after normalization. Blank means unset.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter state or territory; trimmed and uppercased. Blank means unset.",
      "type": "string"
    },
    "city": {
      "description": "Exact city, 1–60 visible characters; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string"
    },
    "zipCode": {
      "description": "Five-digit ZIP or ZIP+4, preserving leading zeros; requires operator-enabled location access and is rejected while personal-data redaction is on. Blank means unset.",
      "type": "string",
      "pattern": "^\\s*(?:[0-9]{5}(?:-?[0-9]{4})?\\s*)?$"
    },
    "nameMatch": {
      "description": "How each supplied name field matches; default words for name searches. words: the field equals the term or continues with a space after it; only a space separates words, so a hyphenated or apostrophe name is one word. exact: the whole field. prefix: the field begins with the term, also mid-word; rejected while personal-data redaction is on.",
      "type": "string",
      "enum": [
        "words",
        "exact",
        "prefix"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Maximum complete people or reference entries per page; default 10, maximum 50. A larger limit returns at most 50, with a notice.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset; default 0, maximum 10000. Follow nextOffset or narrow filters at the cap.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "required": [
    "mode",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗

faa_airmen_list_reference

Read FAA certificate and rating codes, observed aircraft type designators, identity guidance, medical guidance, or local mirror status. Use these references to construct lookup filters and interpret snapshot limits. Static topics work before mirror initialization.

read
invocation 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "faa_airmen_list_reference",
    "arguments": {
      "topic": "<topic>"
    }
  }
}
schema 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "topic": {
      "type": "string",
      "enum": [
        "certificate_types",
        "certificate_levels",
        "ratings",
        "type_ratings",
        "identifiers",
        "medical_guidance",
        "mirror_status"
      ],
      "description": "One FAA vocabulary, interpretation guide, or mirror diagnostic topic."
    },
    "filter": {
      "description": "Literal case-insensitive substring over code and description, 1–80 normalized characters; vocabulary topics only. Blank means unset.",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Maximum complete people or reference entries per page; default 10, maximum 50. A larger limit returns at most 50, with a notice.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "default": 0,
      "description": "Zero-based offset; default 0, maximum 10000. Follow nextOffset or narrow filters at the cap.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000
    }
  },
  "required": [
    "topic",
    "limit",
    "offset"
  ],
  "additionalProperties": false
}
view source ↗