Skip to content

cyanheads/faa-aircraft-registry-mcp-server

v0.2.0Apache-2.0

Decode N-numbers to aircraft, engine, status, and owner; search the US civil aircraft registry by owner, type, or state; resolve active/deregistered/reserved status — offline via MCP. STDIO or Streamable HTTP.

Changelog

All notable changes to this project. Each entry links to its full per-version file in changelog/.

0.2.0 — 2026-11-10 · 🛡️ Security

Query complete FAA registry snapshots with the source date and an N-number's cancellation history.

0.1.12 — 2026-10-17

Mirror lifecycle commands and the Node SQLite driver work from installed packages and cleaned Desktop bundles.

0.1.11 — 2026-10-16

Registry validation and aircraft-code discovery: exact manufacturer/model search, decoded weight ranges, corrected status labels, and archive completeness checks.

0.1.10 — 2026-10-08

mcp-ts-core 0.13.6 → 0.13.14: tool errors carry a requestId and no longer expose stack traces or request context; an integer nNumber, a numeric-string limit/offset, and null for an optional filter are repaired instead of rejected; the Docker image builds multi-arch without QEMU.

0.1.9 — 2026-09-20 · ⚠️ Breaking

Adopts mcp-ts-core 0.13.6: an explicit stateless session mode and a shutdown hook that releases the daily refresh job and mirror handle, richer wire-level error envelopes, and a raised Bun 1.4 floor.

0.1.8 — 2026-08-24

MCP 2026-07-28 support, strict tool inputs, valid error envelopes, and explicit stateless serving.

0.1.7 — 2026-07-16

An interrupted mirror rebuild that leaves the index empty now fails loud with ServiceUnavailable instead of serving empty results as healthy, and the mirror CLI scripts now emit their logging output instead of dropping it silently.

0.1.6 — 2026-07-16

Rejects malformed N-numbers and aircraft codes with an actionable validation error instead of a misleading not-found/unknown answer, and blanks the FAA's 0-sentinel numeric fields (cruise speed, year manufactured, seats) instead of rendering them as real values.

0.1.5 — 2026-07-16

Bounds registry rebuild peak memory to the largest single file via lazy ZIP inflation, streamed line parsing, and chunked auxiliary transactions (measured ~2.35 GiB to ~0.74 GiB); syncs the Dockerfile OCI description label to package.json.

0.1.4 — 2026-07-15 · 🛡️ Security

Column-scopes faa_search_registrations FTS matching to close a PII-redaction bypass, adds offset pagination to both search tools, corrects 'bundled registry' description drift, and adopts mcp-ts-core ^0.10.14 with a bun install supply-chain guard.

0.1.3 — 2026-06-20

Maintenance: @cyanheads/mcp-ts-core ^0.10.6 → ^0.10.9, direct + transitive dependency refresh, re-synced agent skills and devcheck scripts, devcheck.config packaging.pluginManifests flag

0.1.2 — 2026-06-15

Public hosted endpoint at faa-aircraft-registry.caseyjhand.com/mcp

0.1.1 — 2026-06-14

Metadata polish — action-first package and plugin descriptions, npm-scoped README header, and a repository field on the MCPB manifest.

0.1.0 — 2026-06-13

Initial release — offline FAA civil aircraft registry: decode N-numbers, search registrations and aircraft types, resolve active/deregistered/reserved status, with fail-safe owner-PII redaction over an embedded SQLite + FTS5 mirror.