@squawk/mcp 0.9.6 → 0.10.0

package/README.md

@@ -98,7 +98,7 @@ version explicitly in the client config:
   "mcpServers": {
     "squawk": {
       "command": "npx",
-      "args": ["-y", "@squawk/mcp@0.9.6"]
+      "args": ["-y", "@squawk/mcp@0.10.0"]
     }
   }
 }
@@ -164,7 +164,7 @@ Pinning works the same way:
   "mcpServers": {
     "squawk": {
       "command": "npx",
-      "args": ["-y", "-p", "@squawk/icao-registry-data@0.8.10", "@squawk/mcp@0.9.6"]
+      "args": ["-y", "-p", "@squawk/icao-registry-data@0.8.10", "@squawk/mcp@0.10.0"]
     }
   }
 }
@@ -249,7 +249,7 @@ directly.
 | `get_airport_by_faa_id` | Look up an airport by FAA identifier                                                   |
 | `get_airport_by_icao`   | Look up an airport by ICAO code                                                        |
 | `find_nearest_airports` | Find airports nearest a position with optional facility-type and runway-length filters |
-| `search_airports`       | Substring search by airport name or city                                               |
+| `search_airports`       | Fuzzy search by FAA identifier, name, or city                                          |
 
 ### Airspace (`@squawk/airspace` + `@squawk/airspace-data`)
 
@@ -259,6 +259,7 @@ directly.
 | `get_airspace_for_airport`   | Class B/C/D/E2 surface-area sectors associated with an airport, with full polygon boundaries                                                    |
 | `find_artcc_for_position`    | US ARTCC features containing a given position and altitude (typically one feature; multiple for oceanic CTA+FIR overlaps or stratum boundaries) |
 | `find_artcc_by_identifier`   | All ARTCC features for a 3-letter center code (e.g. "ZNY"), optionally narrowed to a single stratum, with full polygon boundaries               |
+| `search_airspace`            | Fuzzy search by identifier or name (boundary summarized as a vertex count)                                                                      |
 
 ### Navaids (`@squawk/navaids` + `@squawk/navaid-data`)
 
@@ -267,15 +268,15 @@ directly.
 | `get_navaid_by_ident`       | Look up navaids by identifier                   |
 | `find_navaids_by_frequency` | Find navaids tuned to a given MHz/kHz frequency |
 | `find_nearest_navaids`      | Find navaids nearest a position                 |
-| `search_navaids`            | Substring search by name or identifier          |
+| `search_navaids`            | Fuzzy search by name or identifier              |
 
 ### Fixes (`@squawk/fixes` + `@squawk/fix-data`)
 
-| Tool                 | Purpose                        |
-| -------------------- | ------------------------------ |
-| `get_fix_by_ident`   | Look up fixes by identifier    |
-| `find_nearest_fixes` | Find fixes nearest a position  |
-| `search_fixes`       | Substring search by identifier |
+| Tool                 | Purpose                       |
+| -------------------- | ----------------------------- |
+| `get_fix_by_ident`   | Look up fixes by identifier   |
+| `find_nearest_fixes` | Find fixes nearest a position |
+| `search_fixes`       | Fuzzy search by identifier    |
 
 ### Airways (`@squawk/airways` + `@squawk/airway-data`)
 
@@ -284,7 +285,7 @@ directly.
 | `get_airway_by_designation` | Look up airways by designation                        |
 | `expand_airway_segment`     | Expand an airway between an entry fix and an exit fix |
 | `find_airways_by_fix`       | Reverse lookup: airways that pass through a given fix |
-| `search_airways`            | Substring search by designation                       |
+| `search_airways`            | Fuzzy search by designation                           |
 
 ### Procedures (`@squawk/procedures` + `@squawk/procedure-data`)
 
@@ -298,7 +299,7 @@ Covers SIDs, STARs, and Instrument Approach Procedures (IAPs) from FAA CIFP.
 | `find_procedures_by_airport_and_runway`   | Procedures at an airport serving a specific runway (IAP runway match or RW\* transition)    |
 | `find_approaches_by_type`                 | Every IAP of a given approach classification (ILS, RNAV, VOR, etc.)                         |
 | `expand_procedure`                        | Expand a procedure into its leg sequence (with optional transition merge)                   |
-| `search_procedures`                       | Substring search by name or identifier, optionally filtered by procedure or approach type   |
+| `search_procedures`                       | Fuzzy search by name or identifier, optionally filtered by procedure or approach type       |
 
 ### ICAO aircraft registry (`@squawk/icao-registry` + `@squawk/icao-registry-data`)
 

package/dist/tools/airports.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airports.d.ts","sourceRoot":"","sources":["../../src/tools/airports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6I5D"}
+{"version":3,"file":"airports.d.ts","sourceRoot":"","sources":["../../src/tools/airports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkBzE;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2J5D"}

package/dist/tools/airports.js

@@ -111,9 +111,12 @@ export function registerAirportTools(server) {
     });
     server.registerTool('search_airports', {
         title: 'Search airports by name or city',
-        description: 'Searches US airports using case-insensitive substring matching on airport name and city. Returns airports in alphabetical order by name. Use this when the user knows a partial name but not the identifier.',
+        description: 'Fuzzy-searches US airports across FAA identifier, name, and city. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match) and the matched field; results are returned best-match first. Use this when the user knows a partial name but not the identifier.',
         inputSchema: {
-            text: z.string().min(1).describe('Substring to match against airport name or city.'),
+            text: z
+                .string()
+                .min(1)
+                .describe('Search text, fuzzily matched against airport FAA identifier, name, and city.'),
             limit: z
                 .number()
                 .int()
@@ -124,8 +127,14 @@ export function registerAirportTools(server) {
                 .array(z.enum(FACILITY_TYPE_VALUES))
                 .optional()
                 .describe('Restrict results to these facility types. Omit to include all types.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, limit, facilityTypes }) => {
+    }, ({ text, limit, facilityTypes, minScore }) => {
         const query = { text };
         if (limit !== undefined) {
             query.limit = limit;
@@ -133,6 +142,9 @@ export function registerAirportTools(server) {
         if (facilityTypes !== undefined) {
             query.types = new Set(facilityTypes);
         }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
         const results = resolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(results, null, 2) }],

package/dist/tools/airspace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airspace.d.ts","sourceRoot":"","sources":["../../src/tools/airspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFzE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmI7D"}
+{"version":3,"file":"airspace.d.ts","sourceRoot":"","sources":["../../src/tools/airspace.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmFzE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA0L7D"}

package/dist/tools/airspace.js

@@ -165,4 +165,51 @@ export function registerAirspaceTools(server) {
             structuredContent: { features },
         };
     });
+    server.registerTool('search_airspace', {
+        title: 'Search airspace by name or identifier',
+        description: 'Fuzzy-searches US airspace features across identifier and name. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match) and the matched field; results are returned best-match first. Boundary geometry is summarized as a vertex count to keep responses compact.',
+        inputSchema: {
+            text: z
+                .string()
+                .min(1)
+                .describe('Search text, fuzzily matched against airspace identifier and name.'),
+            airspaceTypes: z
+                .array(z.enum(AIRSPACE_TYPE_VALUES))
+                .optional()
+                .describe('Restrict results to these airspace types. Omit to include all types.'),
+            limit: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Maximum number of results to return. Defaults to 20.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
+        },
+    }, ({ text, airspaceTypes, limit, minScore }) => {
+        const query = { text };
+        if (airspaceTypes !== undefined) {
+            query.types = new Set(airspaceTypes);
+        }
+        if (limit !== undefined) {
+            query.limit = limit;
+        }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
+        const results = airspaceResolver.search(query).map((result) => ({
+            feature: summarizeFeature(result.feature),
+            score: result.score,
+            matchedField: result.matchedField,
+            ranges: result.ranges,
+        }));
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ results }, null, 2) }],
+            structuredContent: { results },
+        };
+    });
 }

package/dist/tools/airways.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"airways.d.ts","sourceRoot":"","sources":["../../src/tools/airways.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6G3D"}
+{"version":3,"file":"airways.d.ts","sourceRoot":"","sources":["../../src/tools/airways.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2H3D"}

package/dist/tools/airways.js

@@ -84,9 +84,12 @@ export function registerAirwayTools(server) {
     });
     server.registerTool('search_airways', {
         title: 'Search airways by designation',
-        description: 'Searches US airways by case-insensitive substring matching against the airway designation. Results are returned in alphabetical order by designation.',
+        description: 'Fuzzy-searches US airways by designation. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match); results are returned best-match first.',
         inputSchema: {
-            text: z.string().min(1).describe('Substring to match against the airway designation.'),
+            text: z
+                .string()
+                .min(1)
+                .describe('Search text, fuzzily matched against the airway designation.'),
             airwayTypes: z
                 .array(z.enum(AIRWAY_TYPE_VALUES))
                 .optional()
@@ -97,8 +100,14 @@ export function registerAirwayTools(server) {
                 .positive()
                 .optional()
                 .describe('Maximum number of results to return. Defaults to 20.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, airwayTypes, limit }) => {
+    }, ({ text, airwayTypes, limit, minScore }) => {
         const query = { text };
         if (airwayTypes !== undefined) {
             query.types = new Set(airwayTypes);
@@ -106,6 +115,9 @@ export function registerAirwayTools(server) {
         if (limit !== undefined) {
             query.limit = limit;
         }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
         const airways = airwayResolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(airways, null, 2) }],

package/dist/tools/fixes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../src/tools/fixes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsGxD"}
+{"version":3,"file":"fixes.d.ts","sourceRoot":"","sources":["../../src/tools/fixes.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoHxD"}

package/dist/tools/fixes.js

@@ -77,9 +77,12 @@ export function registerFixTools(server) {
     });
     server.registerTool('search_fixes', {
         title: 'Search fixes by identifier',
-        description: 'Searches US fixes/waypoints by case-insensitive substring matching against the fix identifier. Results are returned in alphabetical order by identifier.',
+        description: 'Fuzzy-searches US fixes/waypoints by identifier. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match); results are returned best-match first.',
         inputSchema: {
-            text: z.string().min(1).describe('Substring to match against the fix identifier.'),
+            text: z
+                .string()
+                .min(1)
+                .describe('Search text, fuzzily matched against the fix identifier.'),
             useCodes: z
                 .array(z.enum(FIX_USE_CODE_VALUES))
                 .optional()
@@ -90,8 +93,14 @@ export function registerFixTools(server) {
                 .positive()
                 .optional()
                 .describe('Maximum number of results to return. Defaults to 20.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, useCodes, limit }) => {
+    }, ({ text, useCodes, limit, minScore }) => {
         const query = { text };
         if (useCodes !== undefined) {
             query.useCodes = new Set(useCodes);
@@ -99,6 +108,9 @@ export function registerFixTools(server) {
         if (limit !== undefined) {
             query.limit = limit;
         }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
         const fixes = fixResolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(fixes, null, 2) }],

package/dist/tools/navaids.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"navaids.d.ts","sourceRoot":"","sources":["../../src/tools/navaids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2I3D"}
+{"version":3,"file":"navaids.d.ts","sourceRoot":"","sources":["../../src/tools/navaids.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAyJ3D"}

package/dist/tools/navaids.js

@@ -112,9 +112,12 @@ export function registerNavaidTools(server) {
     });
     server.registerTool('search_navaids', {
         title: 'Search navaids by name or identifier',
-        description: 'Searches US navaids using case-insensitive substring matching against the navaid name and identifier. Results are returned in alphabetical order by name.',
+        description: 'Fuzzy-searches US navaids across identifier and name. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match) and the matched field; results are returned best-match first.',
         inputSchema: {
-            text: z.string().min(1).describe('Substring to match against navaid name or identifier.'),
+            text: z
+                .string()
+                .min(1)
+                .describe('Search text, fuzzily matched against navaid identifier and name.'),
             navaidTypes: z
                 .array(z.enum(NAVAID_TYPE_VALUES))
                 .optional()
@@ -125,8 +128,14 @@ export function registerNavaidTools(server) {
                 .positive()
                 .optional()
                 .describe('Maximum number of results to return. Defaults to 20.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, navaidTypes, limit }) => {
+    }, ({ text, navaidTypes, limit, minScore }) => {
         const query = { text };
         if (navaidTypes !== undefined) {
             query.types = new Set(navaidTypes);
@@ -134,6 +143,9 @@ export function registerNavaidTools(server) {
         if (limit !== undefined) {
             query.limit = limit;
         }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
         const navaids = navaidResolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(navaids, null, 2) }],

package/dist/tools/procedures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../src/tools/procedures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCzE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2M9D"}
+{"version":3,"file":"procedures.d.ts","sourceRoot":"","sources":["../../src/tools/procedures.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgCzE;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsN9D"}

package/dist/tools/procedures.js

@@ -157,12 +157,12 @@ export function registerProcedureTools(server) {
     });
     server.registerTool('search_procedures', {
         title: 'Search procedures by name or identifier',
-        description: 'Searches US instrument procedures (SIDs, STARs, IAPs) by case-insensitive substring matching against both the procedure name and identifier. Results are returned sorted by airport and identifier.',
+        description: 'Fuzzy-searches US instrument procedures (SIDs, STARs, IAPs) across identifier and name. Matching is case-insensitive and tolerant of prefixes, substrings, subsequences, and small typos. Each result carries a match score in [0, 1] (1 is an exact match) and the matched field; results are returned best-match first.',
         inputSchema: {
             text: z
                 .string()
                 .min(1)
-                .describe('Substring to match against the procedure name or identifier.'),
+                .describe('Search text, fuzzily matched against the procedure identifier and name.'),
             procedureType: z
                 .enum(PROCEDURE_TYPE_VALUES)
                 .optional()
@@ -177,8 +177,14 @@ export function registerProcedureTools(server) {
                 .positive()
                 .optional()
                 .describe('Maximum number of results to return. Defaults to 20.'),
+            minScore: z
+                .number()
+                .min(0)
+                .max(1)
+                .optional()
+                .describe('Minimum match score (exclusive) in [0, 1] a result must reach. Defaults to 0. Raise it to drop weak fuzzy matches.'),
         },
-    }, ({ text, procedureType, approachType, limit }) => {
+    }, ({ text, procedureType, approachType, limit, minScore }) => {
         const query = { text };
         if (procedureType !== undefined) {
             query.type = procedureType;
@@ -189,6 +195,9 @@ export function registerProcedureTools(server) {
         if (limit !== undefined) {
             query.limit = limit;
         }
+        if (minScore !== undefined) {
+            query.minScore = minScore;
+        }
         const procedures = procedureResolver.search(query);
         return {
             content: [{ type: 'text', text: JSON.stringify(procedures, null, 2) }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squawk/mcp",
-  "version": "0.9.6",
+  "version": "0.10.0",
   "type": "module",
   "description": "Model Context Protocol server exposing squawk's aviation libraries as tools for LLM clients",
   "author": "Neil Cochran",
@@ -42,22 +42,22 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@squawk/airport-data": "^0.7.3",
-    "@squawk/airports": "^0.6.1",
-    "@squawk/airspace": "^0.8.0",
+    "@squawk/airports": "^0.7.0",
+    "@squawk/airspace": "^0.9.0",
     "@squawk/airspace-data": "^0.5.2",
     "@squawk/airway-data": "^0.5.3",
-    "@squawk/airways": "^0.4.1",
+    "@squawk/airways": "^0.5.0",
     "@squawk/fix-data": "^0.6.3",
-    "@squawk/fixes": "^0.3.1",
+    "@squawk/fixes": "^0.4.0",
     "@squawk/flight-math": "^0.5.3",
     "@squawk/flightplan": "^0.5.1",
     "@squawk/geo": "^0.4.3",
     "@squawk/icao-registry": "^0.5.1",
     "@squawk/navaid-data": "^0.6.3",
-    "@squawk/navaids": "^0.4.1",
+    "@squawk/navaids": "^0.5.0",
     "@squawk/notams": "^0.3.5",
     "@squawk/procedure-data": "^0.7.2",
-    "@squawk/procedures": "^0.5.1",
+    "@squawk/procedures": "^0.6.0",
     "@squawk/types": "^0.8.0",
     "@squawk/weather": "^0.5.5",
     "zod": "^4.4.3"