Search / io.github.cyanheads/faa-aircraft-registry-mcp-server
protogridR0· no sign-inOffline, keyless lookup of the US civil aircraft registry — decode N-numbers, search records.
v0.1.12 · active · repository · descriptor JSON · versions
{
"mcpServers": {
"faa-aircraft-registry-mcp-server": {
"type": "http",
"url": "https://faa-aircraft-registry.caseyjhand.com/mcp"
}
}
}claude mcp add --transport http faa-aircraft-registry-mcp-server https://faa-aircraft-registry.caseyjhand.com/mcp[mcp_servers.faa-aircraft-registry-mcp-server]
url = "https://faa-aircraft-registry.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"faa-aircraft-registry-mcp-server": {
"type": "remote",
"url": "https://faa-aircraft-registry.caseyjhand.com/mcp",
"enabled": true
}
}
}{
"mcpServers": {
"faa-aircraft-registry-mcp-server": {
"type": "http",
"url": "https://faa-aircraft-registry.caseyjhand.com/mcp"
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=faa-aircraft-registry-mcp-server&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZmFhLWFpcmNyYWZ0LXJlZ2lzdHJ5LmNhc2V5amhhbmQuY29tL21jcCJ9"
}{
"servers": {
"faa-aircraft-registry-mcp-server": {
"type": "http",
"url": "https://faa-aircraft-registry.caseyjhand.com/mcp"
}
}
}{
"mcpServers": {
"faa-aircraft-registry-mcp-server": {
"httpUrl": "https://faa-aircraft-registry.caseyjhand.com/mcp"
}
}
}extensions:
"faa-aircraft-registry-mcp-server":
enabled: true
name: "faa-aircraft-registry-mcp-server"
type: streamable_http
uri: "https://faa-aircraft-registry.caseyjhand.com/mcp"
timeout: 300
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations5 of 5 tools declare readOnlyHint or destructiveHinttools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: faa_lookup_registration (destructiveHint); faa_get_aircraft_type (destructiveHint); faa_search_registrations (destructiveHint); …tools.token_costabout 1,576 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes5 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulnsno known advisory in 80 resolved packagesdeps.mcp_sdk_version@modelcontextprotocol/core 2.3.1, no known advisorydeps.resolvable@cyanheads/[email protected], @cyanheads/[email protected] resolved: 80 packagesfaa_get_registration_statuschangedoutput schemafaa_search_aircraft_typeschangeddescription, input schema, output schemaSearch FAA aircraft types by manufacturer/model name, aircraft type code, or category code to discover 7-character manufacturer/model/series codes and browse specifications. Use this before faa_get_aircraft_type to find a code by name. At least one filter is required. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.
Search FAA aircraft types by manufacturer/model name, aircraft type code, or category code to discover 6–7-character manufacturer/model/series codes and browse specifications. Pass a code to faa_get_aircraft_type for specs or faa_search_registrations as manufacturerModelCode for exact registration matches, then faa_lookup_registration for details. At least one filter is required. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.
faa_search_registrationschangeddescription, input schema, output schemaSearch active US civil aircraft registrations by owner name, make/model, state, aircraft type, or Mode S (hex) code. Returns decoded summaries with N-numbers to drill into via faa_lookup_registration. At least one filter is required. Owner-name search is unavailable when this deployment redacts owner PII — search by make/model, state, aircraft type, or Mode S code instead. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.
Search active US civil aircraft registrations by owner name, make/model, exact manufacturerModelCode, state, aircraft type, or Mode S (hex) code. Discover codes with faa_search_aircraft_types, search registrations by manufacturerModelCode, then drill into N-numbers via faa_lookup_registration. Filters are AND-combined; at least one is required. Owner-name search is unavailable when this deployment redacts owner PII — use the other filters instead. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.
faa_get_aircraft_typechangeddescription, output schemaDecode a 7-character FAA manufacturer/model/series code to aircraft specifications — manufacturer, model, aircraft category, aircraft type, engine type, number of engines, number of seats, weight class, cruise speed, and type-certificate data sheet/holder. Use faa_search_aircraft_types first to discover a code by manufacturer or model name.
Decode a 6–7-character FAA manufacturer/model/series code to aircraft specifications — manufacturer, model, aircraft category, aircraft type, engine type, number of engines, number of seats, weight class, cruise speed, and type-certificate data sheet/holder. Use faa_search_aircraft_types first to discover a code by manufacturer or model name.
faa_lookup_registrationchangedoutput schemaFull history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +reachable +uptime-100% +updated-3d-ago
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@cyanheads/[email protected] npm39 dependencies, resolved · MCP SDK @modelcontextprotocol/core 2.3.1 · advisories checked 2026-10-20
No known advisory affects this dependency graph.
@cyanheads/[email protected] npm39 dependencies, resolved · MCP SDK @modelcontextprotocol/core 2.3.1 · advisories checked 2026-10-20
No known advisory affects this dependency graph.
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://faa-aircraft-registry.caseyjhand.com/mcp streamable-http | none | yes | 100% | 186 ms | 2026-07-28 | 2026-10-20 |
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@cyanheads/faa-aircraft-registry-mcp-server | npm | 0.1.12 | npx | |
@cyanheads/faa-aircraft-registry-mcp-server | npm | 0.1.12 | npx |
faa_get_aircraft_typeread-only | Decode a 6–7-character FAA manufacturer/model/series code to aircraft specifications — manufacturer, model, aircraft category, aircraft type, engine type, number of engines, number of seats, weight class, cruise speed, and type-certificate data sheet/holder. Use faa_search_aircraft_types first to discover a code by manufacturer or model name. |
faa_get_registration_statusread-only | Resolve whether a US civil aircraft N-number is active, deregistered, reserved, or unknown, including the available registration and airworthiness status. Use this rather than faa_lookup_registration when a number may be inactive. A number that was never issued returns recordType "unknown" — a valid, informative answer, not an error. Accepts "N12345" or "12345". |
faa_lookup_registrationread-only | Decode one US civil aircraft N-number to its full registration record — aircraft make/model, engine, year manufactured, airworthiness, registration status, Mode S (ICAO 24-bit) code, and registered owner (when owner-PII redaction is off). Accepts "N12345" or "12345" (the leading N is optional). Returns ownerRedacted: true when owner details were withheld. A number that is known but inactive (deregistered or reserved) is not found here — use faa_get_registration_status for its current state. |
faa_search_aircraft_typesread-only | Search FAA aircraft types by manufacturer/model name, aircraft type code, or category code to discover 6–7-character manufacturer/model/series codes and browse specifications. Pass a code to faa_get_aircraft_type for specs or faa_search_registrations as manufacturerModelCode for exact registration matches, then faa_lookup_registration for details. At least one filter is required. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward. |
faa_search_registrationsread-only | Search active US civil aircraft registrations by owner name, make/model, exact manufacturerModelCode, state, aircraft type, or Mode S (hex) code. Discover codes with faa_search_aircraft_types, search registrations by manufacturerModelCode, then drill into N-numbers via faa_lookup_registration. Filters are AND-combined; at least one is required. Owner-name search is unavailable when this deployment redacts owner PII — use the other filters instead. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward. |
Schemas: list_tools.
And 140 more from this publisher.
{
"name": "io.github.cyanheads/faa-aircraft-registry-mcp-server",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://faa-aircraft-registry.caseyjhand.com/mcp",
"type": "streamable-http"
}
],
"version": "0.1.12",
"packages": [
{
"version": "0.1.12",
"transport": {
"type": "stdio"
},
"identifier": "@cyanheads/faa-aircraft-registry-mcp-server",
"runtimeHint": "npx",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"environmentVariables": [
{
"name": "FAA_REDACT_OWNER_PII",
"format": "string",
"default": "true",
"description": "Redact owner name/address and disable owner-name search. Redacted by default; set to false only on trusted local installs. Unset/empty/malformed resolves to redacted."
},
{
"name": "FAA_MIRROR_PATH",
"format": "string",
"default": ".mirror/faa-registry.db",
"description": "Filesystem path to the SQLite registry index file."
},
{
"name": "FAA_DATABASE_URL",
"format": "string",
"default": "https://registry.faa.gov/database/ReleasableAircraft.zip",
"description": "Source URL for the FAA Releasable Aircraft Database ZIP (used by mirror:init/refresh only)."
},
{
"name": "MCP_LOG_LEVEL",
"format": "string",
"default": "info",
"description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
}
]
},
{
"version": "0.1.12",
"transport": {
"url": "http://localhost:3010/mcp",
"type": "streamable-http"
},
"identifier": "@cyanheads/faa-aircraft-registry-mcp-server",
"runtimeHint": "npx",
"registryType": "npm",
"registryBaseUrl": "https://registry.npmjs.org",
"environmentVariables": [
{
"name": "MCP_TRANSPORT_TYPE",
"value": "http",
"format": "string",
"description": "Selects the HTTP transport."
},
{
"name": "FAA_REDACT_OWNER_PII",
"format": "string",
"default": "true",
"description": "Redact owner name/address and disable owner-name search. Redacted by default; set to false only on trusted local installs. Unset/empty/malformed resolves to redacted."
},
{
"name": "FAA_MIRROR_PATH",
"format": "string",
"default": ".mirror/faa-registry.db",
"description": "Filesystem path to the SQLite registry index file."
},
{
"name": "FAA_DATABASE_URL",
"format": "string",
"default": "https://registry.faa.gov/database/ReleasableAircraft.zip",
"description": "Source URL for the FAA Releasable Aircraft Database ZIP (used by mirror:init/refresh only)."
},
{
"name": "MCP_HTTP_HOST",
"format": "string",
"default": "127.0.0.1",
"description": "The hostname for the HTTP server."
},
{
"name": "MCP_HTTP_PORT",
"format": "string",
"default": "3010",
"description": "The port to run the HTTP server on."
},
{
"name": "MCP_HTTP_ENDPOINT_PATH",
"format": "string",
"default": "/mcp",
"description": "The endpoint path for the MCP server."
},
{
"name": "MCP_AUTH_MODE",
"format": "string",
"default": "none",
"description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
},
{
"name": "MCP_LOG_LEVEL",
"format": "string",
"default": "info",
"description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
}
]
}
],
"repository": {
"url": "https://github.com/cyanheads/faa-aircraft-registry-mcp-server",
"source": "github"
},
"description": "Offline, keyless lookup of the US civil aircraft registry — decode N-numbers, search records."
}