{"_id":"@cyanheads/faa-aircraft-registry-mcp-server","_rev":"10-38340eb74ba75f902b5a4cabc045dfb0","name":"@cyanheads/faa-aircraft-registry-mcp-server","dist-tags":{"latest":"0.1.9"},"versions":{"0.1.0":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.0","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"cyanheads (https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"e836e88789b3831872c03d1aa01b4440313fb7e8","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.0.tgz","fileCount":89,"integrity":"sha512-XDNbzZ5TJqjT2vtnXiuxhczAo37p2IFj5sc1QovCa6w7z6ZgIBuXlCMqQ/f9Bkh4mwXneGCmAU1JkJJRuUDp6A==","signatures":[{"sig":"MEQCIHTt0Guj7deFoWQYxW3TqEiHM6VT5LVTCvuHto8TB2lDAiBfU0Dayi68UXqVCssSdr9TAh9v6wTb2NL86fOLRJUjiA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":366904},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"e836e88789b3831872c03d1aa01b4440313fb7e8","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-XDNbzZ5TJqjT2vtnXiuxhczAo37p2IFj5sc1QovCa6w7z6ZgIBuXlCMqQ/f9Bkh4mwXneGCmAU1JkJJRuUDp6A==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Offline, keyless MCP server for the US civil aircraft registry (FAA Releasable Aircraft Database) — decode an N-number to aircraft, engine, status, and owner; search by owner, type, or state; resolve active/deregistered/reserved status. Embedded SQLite + ","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.2.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0","better-sqlite3":"^12.0.0"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.0_1781374485684_0.45802925089744817","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.1","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","name":"cyanheads","email":"casey@caseyjhand.com"},"license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"960d9e59c9c473d25e2e60e3bc0afba524598402","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.1.tgz","fileCount":90,"integrity":"sha512-nUltZ+GNZdTn6y7C+U1L/qC297QlBKclIjuyxJVLxMtMD2Vw9AQotasZNGZfP3EdX+jqIaz9HokJhpg6FEMhOA==","signatures":[{"sig":"MEYCIQDmQ1VpGX1hT8dG2OXq+sInD1bwuNTBP3TXIgeecL76rQIhAI0L7Px35OSi1IgbQLxiuG45S/GLkVH1/Vg7w4vUg16V","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":368115},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"gitHead":"3d90b29c893cc069784446c0f14178ca8950888a","mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.2.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0","better-sqlite3":"^12.10.1"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.1_1781433020702_0.3153384920741831","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.2","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"cyanheads (https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"370c8e6096d5b407dec0f3bec6bda12c9766cf6e","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.2.tgz","fileCount":91,"integrity":"sha512-2o6iBcVa73+wZrG5UAezhKHA9lmMF9m3ReyIfEevbvUD7XJ4vbMu1Nug9gRYm0xif5f6mFHki1K7C2lhM6D6MQ==","signatures":[{"sig":"MEUCIQCLrD1Uyi5uk3d1SBOf2mKvPs9yoZPqnWNPlUIEj5/sKAIgAdqu2WtMsDx3yFDnuDvQZCJtd+015od5VNUHA9UbZJE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":369239},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"370c8e6096d5b407dec0f3bec6bda12c9766cf6e","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-2o6iBcVa73+wZrG5UAezhKHA9lmMF9m3ReyIfEevbvUD7XJ4vbMu1Nug9gRYm0xif5f6mFHki1K7C2lhM6D6MQ==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.2.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0","better-sqlite3":"^12.10.1"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.2_1781541848952_0.49991596661378","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.3","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"cyanheads (https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"331eeaeb1c5de57d94af1f2639db34d8269c965d","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.3.tgz","fileCount":92,"integrity":"sha512-4cPozUTi7/yWbwOeX1rJrEcmK3+zbWO7Lao+vufXSIdRvS3XEwkUdLf60sLvGXZX27qD7sCW58wlwCpXvZRidg==","signatures":[{"sig":"MEUCIQCr2SggUzmrsoOo2ClW1NADU7J3XAnIloca00XbGhttJAIgINTiYB9IYQyKBQ3kqtj0+XD2x+IffvhNma2FAI488Ao=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":371113},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"331eeaeb1c5de57d94af1f2639db34d8269c965d","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-4cPozUTi7/yWbwOeX1rJrEcmK3+zbWO7Lao+vufXSIdRvS3XEwkUdLf60sLvGXZX27qD7sCW58wlwCpXvZRidg==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.4.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.9"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"26.0.0","@biomejs/biome":"2.5.0","better-sqlite3":"^12.11.1"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.3_1781955228301_0.573948326418513","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.4","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"c2fc156fcd82ba0534f1b3fb138b331f207f7bf7","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.4.tgz","fileCount":93,"integrity":"sha512-kFmfnE9tfZG1qnv2yCCUEzDuHnM1JNnpm8sQ4RNltdH66se4yunqV2tMAcoUEkwad2VhLXAoX44IQKyfV7rspw==","signatures":[{"sig":"MEYCIQCDaASdRvg/9ts965WLvqWB4B8R5sGMQiJaiKDvTfv26AIhAMWtYox1cmTIGr/86lXappIi8FBAIm7pcEAWc4FuYXXj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":387086},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"c2fc156fcd82ba0534f1b3fb138b331f207f7bf7","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-kFmfnE9tfZG1qnv2yCCUEzDuHnM1JNnpm8sQ4RNltdH66se4yunqV2tMAcoUEkwad2VhLXAoX44IQKyfV7rspw==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.4.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.14"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.9.0","typescript":"^6.0.3","@types/node":"26.1.1","@biomejs/biome":"2.5.2","better-sqlite3":"^12.11.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.4_1784182130573_0.027225661760774456","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.5","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.5","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"2f9a6ee47b36261865da29fce05cfe5cc1d53066","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.5.tgz","fileCount":94,"integrity":"sha512-BjM2bPEWhCeN6hT7zefRKGOXzysHhe0nqtqzItXPolWctNqyI8GlaU/8yTo+yQ7qKJhbzPK0qntZD+sAiy/LpQ==","signatures":[{"sig":"MEUCIF8uPZd8diMUa8FVDE5EXscrACf6ZB7DKXjTq5bmP8NlAiEApl3TsFUmFvZHsAqd54WvxO2hHLBOESqvKO0ERR3j84w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":395232},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"2f9a6ee47b36261865da29fce05cfe5cc1d53066","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-BjM2bPEWhCeN6hT7zefRKGOXzysHhe0nqtqzItXPolWctNqyI8GlaU/8yTo+yQ7qKJhbzPK0qntZD+sAiy/LpQ==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.4.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.14"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.9.0","typescript":"^6.0.3","@types/node":"26.1.1","@biomejs/biome":"2.5.2","better-sqlite3":"^12.11.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.5_1784196133800_0.7409501918803252","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.6","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.6","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"2beb1cfa7a20be90eed1889f1d8bf1e7fbdc2d20","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.6.tgz","fileCount":95,"integrity":"sha512-h5Y3OVqA9HhwMBlU9u+E1BR/iBCJXAUAgrcSVa9JEu/iB3HHn+SJDnY0eQ6vRchXLKe9HkrOvKKNE0jL4RU/rA==","signatures":[{"sig":"MEUCICEeV/2viOeJDmJ8KYiVnSTOmr1eHe44IupFHYxqBqGxAiEAitXGqsh7vDtNsNIqFd0JpJoGpYTDteou8yTZkmAgm8o=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":409724},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"2beb1cfa7a20be90eed1889f1d8bf1e7fbdc2d20","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-h5Y3OVqA9HhwMBlU9u+E1BR/iBCJXAUAgrcSVa9JEu/iB3HHn+SJDnY0eQ6vRchXLKe9HkrOvKKNE0jL4RU/rA==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.4.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.14"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.9.0","typescript":"^6.0.3","@types/node":"26.1.1","@biomejs/biome":"2.5.2","better-sqlite3":"^12.11.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.6_1784198999545_0.37182843684189093","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.7","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.7","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"ababec44807866a0ae758e9b4d4ce7dce37a346e","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.7.tgz","fileCount":96,"integrity":"sha512-6y6+03u5wenuGcP4hWXjEbZLMzVlR8HDpFCSYtdo1TRTrVZ1yzhCmd90DFynSixHbefO+lveebhRjTTex7xZRw==","signatures":[{"sig":"MEUCIFELrJcN5MWAwv0iJej6vhDru9RCtdPI/5SfjCFU3FniAiEAjRLdTf8WEiun+V0gNOeK3lb+kttUuelRgUA8feoOok4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":414541},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"ababec44807866a0ae758e9b4d4ce7dce37a346e","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-6y6+03u5wenuGcP4hWXjEbZLMzVlR8HDpFCSYtdo1TRTrVZ1yzhCmd90DFynSixHbefO+lveebhRjTTex7xZRw==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.4.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.14"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.9.1","typescript":"^6.0.3","@types/node":"26.1.1","@biomejs/biome":"2.5.2","better-sqlite3":"^12.11.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^12.0.0"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.7_1784268056591_0.8647574965047402","host":"s3://npm-registry-packages-npm-production"}},"0.1.8":{"name":"@cyanheads/faa-aircraft-registry-mcp-server","version":"0.1.8","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.8","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"dist":{"shasum":"5e46637f48ce272e0f35f94bcfc4818ef56f538d","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.8.tgz","fileCount":97,"integrity":"sha512-N8anKY/Y842bBTT4jY7aVaJo9Yy8w+gczfGhdThmv9y7rqMHFwkQKiodcarggjBKnBXAtcTcBVjkgYh/zGkZ4A==","signatures":[{"sig":"MEUCIQDnLioWH7a7By7Eo//bVc+CkDYVBDTVTMZx2qnW3tUiuAIgAtsv+2q50ejkzAwkg0kO/VVTp43nfSGk3Whk7uyJ4Rs=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":419698},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"5e46637f48ce272e0f35f94bcfc4818ef56f538d","engines":{"bun":">=1.3.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-N8anKY/Y842bBTT4jY7aVaJo9Yy8w+gczfGhdThmv9y7rqMHFwkQKiodcarggjBKnBXAtcTcBVjkgYh/zGkZ4A==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","node-cron":"^4.6.0","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.2.0","@biomejs/biome":"2.5.10","better-sqlite3":"^13.0.3","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^13.0.1"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.8_1787626493617_0.5220671733400448","host":"s3://npm-registry-packages-npm-production"}},"0.1.9":{"_id":"@cyanheads/faa-aircraft-registry-mcp-server@0.1.9","bin":{"faa-aircraft-registry-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"dist":{"shasum":"d3cc782af8b798e24fdcf752264c42fd3dc725fa","tarball":"https://registry.npmjs.org/@cyanheads/faa-aircraft-registry-mcp-server/-/faa-aircraft-registry-mcp-server-0.1.9.tgz","fileCount":102,"integrity":"sha512-C3EO0nBYejXx7r5rcH/Gny/RJLel/RA1fVWWFEbJOvWMknbHLr+9IhHS0PKLljkAEvxknDqel6mE6kwGsqsm8A==","signatures":[{"sig":"MEYCIQDbRtKGR+Haa1v3TfW6iRg2OMY7f3UKDYE/20t7dW35JQIhANvl1VjGMgsPtnLnZBjlc7BSTd3Vx8exfeJhdnr6bQX2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIGuHdsJys3hD8G94HQavtXAWSxZS+AIg+BrFeTeZl7xsAiEA1jWjJTv0Kj7npSba96OMwsHKfMwSekEi6ld+fAPUkH8="}],"unpackedSize":432181},"main":"dist/index.js","name":"@cyanheads/faa-aircraft-registry-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"d3cc782af8b798e24fdcf752264c42fd3dc725fa","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"license":"Apache-2.0","mcpName":"io.github.cyanheads/faa-aircraft-registry-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/faa-aircraft-registry-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/faa-aircraft-registry-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","mirror:init":"bun run scripts/faa-mirror-init.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","mirror:verify":"bun run scripts/faa-mirror-verify.ts","lint:packaging":"bun run scripts/lint-packaging.ts","mirror:refresh":"bun run scripts/faa-mirror-refresh.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"version":"0.1.9","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"_integrity":"sha512-C3EO0nBYejXx7r5rcH/Gny/RJLel/RA1fVWWFEbJOvWMknbHLr+9IhHS0PKLljkAEvxknDqel6mE6kwGsqsm8A==","repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"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.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","node-cron":"^4.6.0","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.1","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"26.6.1","@biomejs/biome":"2.5.14","better-sqlite3":"^13.0.3","@socketsecurity/bun-security-scanner":"^1.1.2"},"peerDependencies":{"better-sqlite3":"^13.0.1"},"trustedDependencies":["better-sqlite3"],"peerDependenciesMeta":{"better-sqlite3":{"optional":true}},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/faa-aircraft-registry-mcp-server_0.1.9_1789934389276_0.5120327283079544"}}},"time":{"created":"2026-06-13T18:14:45.514Z","modified":"2026-09-20T19:59:49.505Z","0.1.0":"2026-06-13T18:14:45.850Z","0.1.1":"2026-06-14T10:30:20.835Z","0.1.2":"2026-06-15T16:44:09.124Z","0.1.3":"2026-06-20T11:33:48.481Z","0.1.4":"2026-07-16T06:08:50.713Z","0.1.5":"2026-07-16T10:02:13.927Z","0.1.6":"2026-07-16T10:49:59.707Z","0.1.7":"2026-07-17T06:00:56.714Z","0.1.8":"2026-08-25T02:54:53.822Z","0.1.9":"2026-09-20T19:59:49.354Z"},"bugs":{"url":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/faa-aircraft-registry-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","faa","aircraft-registry","n-number","tail-number","aviation","mode-s","icao24","aircraft-registration","sqlite","fts5"],"repository":{"url":"git+https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git","type":"git"},"description":"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.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/faa-aircraft-registry-mcp-server

\n

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.\n

5 Tools • 1 Resource
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.1.9-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/faa-aircraft-registry-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Ffaa-aircraft-registry-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n
\n\n
\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/releases/latest/download/faa-aircraft-registry-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=faa-aircraft-registry-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvZmFhLWFpcmNyYWZ0LXJlZ2lzdHJ5LW1jcC1zZXJ2ZXIiXX0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22faa-aircraft-registry-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Ffaa-aircraft-registry-mcp-server%22%5D%7D)\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n
\n\n
\n\n**Public Hosted Server:** [https://faa-aircraft-registry.caseyjhand.com/mcp](https://faa-aircraft-registry.caseyjhand.com/mcp)\n\n
\n\n---\n\n## Overview\n\nThe US civil aircraft registry, mirrored offline from the FAA's Releasable Aircraft Database — there is no live FAA registry API. Decode an N-number to its aircraft, engine, and registered owner; resolve active, deregistered, or reserved status; search by owner, make/model, state, or Mode S code; and decode manufacturer/model codes to full aircraft specs. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `faa_lookup_registration` | Decode one N-number to its full pre-joined active record — aircraft make/model, engine, year, airworthiness, registration status, Mode S code, and registered owner (when redaction is off). |\n| `faa_get_registration_status` | Resolve an N-number across all three status files (active, deregistered, reserved) in priority order, returning a definitive `recordType`. |\n| `faa_search_registrations` | Search active registrations by owner name, make/model, state, aircraft type, or Mode S code. |\n| `faa_search_aircraft_types` | Search the aircraft reference table by manufacturer/model name, type, or category to discover manufacturer-model codes. |\n| `faa_get_aircraft_type` | Decode a 6–7-character manufacturer/model/series code to aircraft specs — category, type, engine, seats, weight class, cruise speed, type-certificate data. |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `faa://registration/{nNumber}` | Full registration record for one N-number — the same decoded, pre-joined payload as `faa_lookup_registration`. |\n\nAlso reachable via `faa_lookup_registration`; search collections aren't exposed as resources.\n\n## Capability reference\n\n### `faa_lookup_registration` tool\n\n- Accepts `N12345` or `12345` — leading `N` optional, normalized before lookup\n- Resolves `MASTER` → `ACFTREF` → `ENGINE` and decodes every coded field (aircraft type, engine type, status, airworthiness class, region) as both raw code and label\n- Returns the Mode S code in octal and hex; hex is the ICAO 24-bit address used by flight-tracking feeds\n- Owner name/address included only when `FAA_REDACT_OWNER_PII=false`; otherwise `ownerRedacted: true` flags that they were withheld\n- Typed errors: `not_found` (well-formed but no active registration — use `faa_get_registration_status`), `invalid_n_number` (malformed input)\n\n---\n\n### `faa_get_registration_status` tool\n\n- Checks active (`MASTER`), deregistered (`DEREG`), and reserved (`RESERVED`) files in priority order\n- Discriminated `recordType`: `active`, `deregistered`, `reserved`, or `unknown` — a never-issued number resolves to `unknown`, not an error\n- Branch-specific fields populate per state (active: status + airworthiness + dates; deregistered: cancel date + serial + mfr/model code; reserved: reservation type + reserve/expiration/purge dates)\n- Owner-PII-free — status facts only\n- Typed error: `invalid_n_number` for malformed input\n\n---\n\n### `faa_search_registrations` tool\n\n- Filters: `ownerName`, `makeModel`, `state`, `aircraftType`, `modeSCode` — at least one required\n- Owner-name search disabled when `FAA_REDACT_OWNER_PII` is on; typed `owner_search_disabled` error names the alternative filters\n- `limit` 1–200 (default 25) and `offset` pagination; every response reports `totalCount`, and a truncated page carries `nextOffset`\n- Each result carries an N-number to pass to `faa_lookup_registration` for full detail\n- Typed error: `no_filters` when no filter is supplied\n\n---\n\n### `faa_search_aircraft_types` tool\n\n- Filters: `query` (manufacturer/model name, full-text), `aircraftType` code, `category` code — at least one required\n- Returns reference summaries with the code to pass to `faa_get_aircraft_type`\n- `limit` 1–200 (default 25) and `offset` pagination; every response reports `totalCount`, and a truncated page carries `nextOffset`\n- Typed error: `no_filters` when no filter is supplied\n\n---\n\n### `faa_get_aircraft_type` tool\n\n- Accepts a 6–7-character uppercase alphanumeric manufacturer/model/series code\n- Returns manufacturer, model, aircraft type, engine type, category, builder certification, seats, engines, weight class, cruise speed, and type-certificate data\n- Discover codes by name first via `faa_search_aircraft_types`\n- Typed errors: `not_found` (well-formed code, no reference record), `invalid_code` (malformed input)\n\n---\n\n### `faa://registration/{nNumber}` resource\n\n- Same payload as `faa_lookup_registration` — `application/json`, cached 1 hour, private scope\n- `nNumber` accepts `N12345` or `12345` (leading `N` optional)\n- Typed errors: `not_found`, `invalid_n_number` — same conditions as the tool\n\n## Features\n\nBuilt on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.\n\nFAA registry-specific:\n\n- Offline and keyless at runtime — every query hits the local SQLite + FTS5 index; no API key, no runtime network, no rate limit\n- Built on the framework `MirrorService`: `mirror:init` builds the index out-of-band, and the HTTP server schedules a daily refresh aligned to the FAA's nightly re-release\n- Pre-joined `MASTER` → `ACFTREF` → `ENGINE` records — one call returns decoded aircraft, engine, and status instead of raw join codes\n- Fail-safe owner-PII redaction — defaults on, drops owner name/address from output, and disables owner-name search while active\n- Composes with live flight-tracking feeds — the Mode S hex code returned here is the ICAO 24-bit address that OpenSky and similar feeds key on\n\nAgent-friendly output:\n\n- Coded fields surface both the raw FAA code and the decoded label — the label for reasoning, the code so nothing is lost\n- Truncation disclosure — search tools flag `truncated` with `shown`/`cap` when the result set is capped, so a partial page is never read as the whole\n- Permissible-field honesty — fields the FAA leaves blank (year, cruise speed, co-owner names) stay absent rather than fabricated\n- Discriminated output — `recordType` and `ownerRedacted` flags let callers branch on data, not string parsing\n\n## Getting started\n\n### Public Hosted Instance\n\nA public instance is available at `https://faa-aircraft-registry.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP:\n\n```json\n{\n \"mcpServers\": {\n \"faa-aircraft-registry-mcp-server\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://faa-aircraft-registry.caseyjhand.com/mcp\"\n }\n }\n}\n```\n\n### Self-Hosted / Local\n\n> **First run requires building the local index — see [First-run setup](#first-run-setup) below.** The package does not ship the FAA data; until `mirror:init` has run once, queries fail with a clear \"run mirror:init\" error.\n\nAdd the following to your MCP client configuration file:\n\n```json\n{\n \"mcpServers\": {\n \"faa-aircraft-registry-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/faa-aircraft-registry-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FAA_MIRROR_PATH\": \"/path/to/faa-registry.db\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"faa-aircraft-registry-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/faa-aircraft-registry-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FAA_MIRROR_PATH\": \"/path/to/faa-registry.db\"\n }\n }\n }\n}\n```\n\nOr with Docker (mount a volume at `/usr/src/app/.mirror` so the built index persists across containers — build it once with `docker exec … bun run mirror:init`):\n\n```json\n{\n \"mcpServers\": {\n \"faa-aircraft-registry-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"-v\", \"faa-registry:/usr/src/app/.mirror\",\n \"ghcr.io/cyanheads/faa-aircraft-registry-mcp-server:latest\"\n ]\n }\n }\n}\n```\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n`FAA_MIRROR_PATH` points the server at the index that `mirror:init` builds — set it to a persistent path so the index survives across runs. Owner PII is redacted by default; set `FAA_REDACT_OWNER_PII=false` only on a trusted local install to expose owner detail.\n\n### First-run setup\n\nThe FAA Releasable Aircraft Database is not bundled with the package — it is a public dataset (~70 MB compressed, refreshed daily by the FAA) that the operator downloads and indexes once before first use. Building the index produces a local SQLite file of a few hundred MB.\n\nAfter installing, build the index out-of-band (never on server startup — a full parse of ~1M rows must not block start):\n\n```sh\n# Build the local index from the live FAA download (idempotent, resumable)\nFAA_MIRROR_PATH=/path/to/faa-registry.db bun run mirror:init\n\n# Verify it built (readiness + integrity check)\nFAA_MIRROR_PATH=/path/to/faa-registry.db bun run mirror:verify\n\n# Rebuild from the latest FAA release (run on a schedule, or out-of-band for stdio)\nFAA_MIRROR_PATH=/path/to/faa-registry.db bun run mirror:refresh\n```\n\n- **Keep the path stable.** Point `FAA_MIRROR_PATH` (and the same env var in your MCP client config) at a persistent location so the built index is reused across runs. Default: `.mirror/faa-registry.db`.\n- **Daily refresh.** Under HTTP transport the server schedules a daily `mirror:refresh` aligned to the FAA's nightly re-release (~11:30 PM Central). If an interrupted rebuild leaves the index empty, queries fail loudly with `ServiceUnavailable` until the rebuild succeeds. Under stdio, run `mirror:refresh` out-of-band (e.g. a cron job).\n- **Docker.** The image ships the mirror CLI and a writable `.mirror` data directory owned by the runtime user. Mount a volume there and run `mirror:init` once (e.g. `docker exec bun run mirror:init`, or a one-shot init job against the shared volume) so the index persists across container restarts.\n- **Until the index exists,** every query fails with a `ServiceUnavailable` error whose recovery hint points to `mirror:init` — there is no live API to fall back to, so the cold state surfaces loudly rather than returning empty results.\n\nThe source URL is overridable via `FAA_DATABASE_URL` (for a private or cached mirror); it is read only at ingest time, never per request.\n\n### Prerequisites\n\n- [Bun v1.4](https://bun.sh/) or higher (or Node.js v24+). `bun:sqlite` is built into Bun; a Node-only deployment adds `better-sqlite3` (already declared as an optional peer dependency).\n- Disk space for the built index (a few hundred MB) at `FAA_MIRROR_PATH`.\n- Network access at `mirror:init` / `mirror:refresh` time to download the FAA ZIP. Not needed at query time.\n\n### Installation\n\nFor local development or self-hosting from source:\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/faa-aircraft-registry-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd faa-aircraft-registry-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n4. **Build the index** (see [First-run setup](#first-run-setup)):\n\n```sh\nbun run mirror:init\n```\n\n## Configuration\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `FAA_REDACT_OWNER_PII` | Redact owner name/address from output and disable owner-name search. Fail-safe: unset, empty, or malformed resolves to redacted. Set `false` only on a trusted local install. | `true` |\n| `FAA_MIRROR_PATH` | Filesystem path to the SQLite index file. Point at a persistent path; mount a volume here in production. | `.mirror/faa-registry.db` |\n| `FAA_DATABASE_URL` | Source URL for the FAA Releasable Aircraft Database ZIP, used by `mirror:init` / `mirror:refresh` only. Overridable for a private/cached mirror; never read at request time. | FAA registry ZIP |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_SESSION_MODE` | Session mode: `auto` (resolves to stateful), `stateful`, or `stateless`. The server declares `stateless` in source because it has no multi-round-trip input; setting this overrides that declaration. | `stateless` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | `3010` |\n| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path where the MCP server is mounted. | `/mcp` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `LOGS_DIR` | Directory for log files (Node.js only). | `/logs` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) (spans, metrics, completion logs). | `false` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n### Owner-PII redaction\n\nThe FAA registry is releasable public record, but `MASTER`, `DEREG`, and `RESERVED` carry registrant **names and physical addresses** (deregistered records carry both mailing and physical address blocks plus co-owner names). This server ships a first-class redaction mode, **redacted by default**:\n\n- `FAA_REDACT_OWNER_PII` defaults to `true`. Unset, empty, or malformed all resolve to redacted, so a deployment can never leak PII by omission or misconfiguration.\n- When redacted: registrant name, street/physical address, and co-owner names are dropped from every output, **and owner-name search is disabled** (`faa_search_registrations` rejects `ownerName`). Disabling search matters — output-hiding alone would let an agent confirm a person↔aircraft link by probing the search input.\n- Aircraft facts (make/model/engine/year/specs) and registration status still flow, with `ownerRedacted: true` on every affected payload.\n- Full owner detail requires explicitly setting `FAA_REDACT_OWNER_PII=false` — appropriate for a trusted local or self-hosted install, not a shared endpoint.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Build the local index (see First-run setup)\n bun run mirror:init\n\n # Run the built server\n bun run start:stdio\n # or\n bun run start:http\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security\n bun run test # Vitest test suite\n bun run lint:mcp # Validate MCP definitions against spec\n ```\n\n### Docker\n\n```sh\ndocker build -t faa-aircraft-registry-mcp-server .\ndocker run --rm -e MCP_TRANSPORT_TYPE=http -p 3010:3010 \\\n -v faa-registry:/usr/src/app/.mirror faa-aircraft-registry-mcp-server\n# Build the index once against the mounted volume:\ndocker run --rm -v faa-registry:/usr/src/app/.mirror faa-aircraft-registry-mcp-server bun run mirror:init\n```\n\nThe Dockerfile defaults to HTTP transport with stateless sessions, ships the `mirror:init`/`mirror:refresh`/`mirror:verify` CLI, pre-creates a writable `.mirror` data directory owned by the runtime user (mount a volume there and run `mirror:init` once to build and persist the index), and logs to `/var/log/faa-aircraft-registry-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:---|:---|\n| `src/index.ts` | `createApp()` entry point — registers tools and the resource, inits the registry service, and schedules the daily refresh under HTTP transport. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). |\n| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). |\n| `src/services/registry` | Registry service — the SQLite + FTS5 mirror, ingester, decode maps, N-number normalizer, and the owner-PII redaction gate. |\n| `scripts/faa-mirror-*.ts` | Mirror lifecycle CLI — `mirror:init`, `mirror:refresh`, `mirror:verify`. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n\n## Development guide\n\nSee [`CLAUDE.md`/`AGENTS.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools and resources via the barrels in `src/mcp-server/*/definitions/index.ts`\n- The registry index is the source of truth at runtime — there is no upstream API to retry; build and refresh it out-of-band, and never fabricate a value from a blank upstream field\n\n## Contributing\n\nIssues are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE) for details.\n\nThe FAA Releasable Aircraft Database is a public-domain US Government work, published by the FAA Civil Aviation Registry. This project redistributes none of that data; operators download it directly from the FAA at install time.\n","readmeFilename":"README.md"}