Faa Aircraft Registry Mcp Server
by cyanheadscommunityv0.1.7
1
An MCP server for the US civil aircraft registry that decodes N-numbers into aircraft, engine, status, and owner data, and supports searching registrations by owner, model, state, type, or Mode S code. It uses a locally built FAA registry index for offline, keyless lookups and can resolve active, deregistered, reserved, or unknown registration status.
From the registry: Offline, keyless lookup of the US civil aircraft registry — decode N-numbers, search records.
Install & configure
Prerequisites
- optionalInstall Node.js or BunInstall Bun v1.3+ or Node.js v24+ to run the server. Prefer the npm/npx path for portability if you already have Node.js.https://bun.sh/
- requiredCreate and persist the FAA registry indexBefore first use, build the local SQLite index from the FAA Releasable Aircraft Database using the mirror CLI. Queries will fail until this has been run once. Keep FAA_MIRROR_PATH stable and pointed at persistent storage.
https://registry.faa.gov/database/ReleasableAircraft.zip$ FAA_MIRROR_PATH=<path-to-faa-registry.db> npx -y @cyanheads/faa-aircraft-registry-mcp-server@latest mirror:init - requiredEnsure disk space and network access for initial ingestHave a few hundred MB available for the built index at FAA_MIRROR_PATH, and network access during mirror:init or mirror:refresh to download the FAA ZIP. Runtime queries do not require network access.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `faa-aircraft-registry-mcp-server` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Create and persist the FAA registry index** — Before first use, build the local SQLite index from the FAA Releasable Aircraft Database using the mirror CLI. Queries will fail until this has been run once. Keep FAA_MIRROR_PATH stable and pointed at persistent storage. Run: `FAA_MIRROR_PATH=<path-to-faa-registry.db> npx -y @cyanheads/faa-aircraft-registry-mcp-server@latest mirror:init` (https://registry.faa.gov/database/ReleasableAircraft.zip)
- **Ensure disk space and network access for initial ingest** — Have a few hundred MB available for the built index at FAA_MIRROR_PATH, and network access during mirror:init or mirror:refresh to download the FAA ZIP. Runtime queries do not require network access.
Optional prerequisites:
- Install Node.js or Bun — Install Bun v1.3+ or Node.js v24+ to run the server. Prefer the npm/npx path for portability if you already have Node.js. (https://bun.sh/)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","@cyanheads/faa-aircraft-registry-mcp-server@latest"]
- required environment variables:
- `MCP_TRANSPORT_TYPE`: Transport mode for the MCP server. Use stdio for local MCP client integration. (example: `stdio`)
- `FAA_MIRROR_PATH`: Filesystem path to the local SQLite index built by mirror:init. Must match the persistent path used during first-run setup. (example: `<path-to-faa-registry.db>`)
- optional environment variables:
- `MCP_LOG_LEVEL`: Log level for server logging. (example: `info`)
- `FAA_REDACT_OWNER_PII`: Whether to redact owner name and address from output and disable owner-name search. Defaults to true; set false only for a trusted local install. (example: `false`)
- `FAA_DATABASE_URL`: Override source URL for the FAA Releasable Aircraft Database ZIP, used only by mirror:init and mirror:refresh. (example: `<your-faa-database-url>`)
- `MCP_AUTH_MODE`: Authentication mode: none, jwt, or oauth. (example: `none`)
- `LOGS_DIR`: Directory for log files on Node.js deployments. (example: `<path-to-logs-directory>`)
- `OTEL_ENABLED`: Enable OpenTelemetry instrumentation. (example: `true`)
Note: The README supports both local stdio and Streamable HTTP. The simplest portable local install is npx over stdio. A public hosted HTTP endpoint is also available. For self-hosted HTTP, the server uses MCP_TRANSPORT_TYPE=http with MCP_HTTP_PORT and optional MCP_HTTP_ENDPOINT_PATH, but the README does not provide a canonical MCP client config snippet for self-hosted HTTP beyond the hosted URL.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README supports both local stdio and Streamable HTTP. The simplest portable local install is npx over stdio. A public hosted HTTP endpoint is also available. For self-hosted HTTP, the server uses MCP_TRANSPORT_TYPE=http with MCP_HTTP_PORT and optional MCP_HTTP_ENDPOINT_PATH, but the README does not provide a canonical MCP client config snippet for self-hosted HTTP beyond the hosted URL.
Tools (5)
faa_lookup_registration
Decode one N-number to its full pre-joined active record, including aircraft make/model, engine, year, airworthiness, registration status, Mode S code, and registered owner when not redacted.
faa_get_registration_status
Resolve an N-number across active, deregistered, and reserved registry files and return a definitive record type and status details.
faa_search_registrations
Search active registrations by owner name, make/model, state, aircraft type, or Mode S code and return matching N-numbers.
faa_search_aircraft_types
Search the aircraft reference table by manufacturer/model name, aircraft type, or category to find manufacturer-model codes.
faa_get_aircraft_type
Decode a 7-character manufacturer/model/series code into aircraft specifications such as category, type, engine, seats, weight class, cruise speed, and type-certificate data.
Environment variables
FAA_REDACT_OWNER_PIIControls whether owner name and address are included in lookup results and whether owner-name search is enabled.FAA_MIRROR_PATHrequiredFilesystem path to the locally built FAA registry database/index used for offline queries.MCP_TRANSPORT_TYPESelects the MCP transport mode, such as stdio.MCP_LOG_LEVELSets the server log level.Prerequisites
- • Node.js v24+
Packages
@cyanheads/faa-aircraft-registry-mcp-server
npmv0.1.7transport: stdio
@cyanheads/faa-aircraft-registry-mcp-server
npmv0.1.7transport: streamable-http
Remote Endpoints
https://faa-aircraft-registry.caseyjhand.com/mcp
type: streamable-http
Details
- Language
- TypeScript
- License
- Apache-2.0
- Released
- Jul 17, 2026
- Last commit
- Jun 20, 2026
- Registry name
- io.github.cyanheads/faa-aircraft-registry-mcp-server