census-geo-mcp 1.0.0 → 1.0.2

package/README.md

@@ -19,3 +19,5 @@ node dist/index.js
 ```
 
 Data comes from the public Census Geo API.
+
+

package/dist/api.js

@@ -34,3 +34,49 @@ export async function coordinates(args) {
         throw new Error(`No census geography for ${x},${y}.`);
     return `Census geography for ${x},${y}:\nFIPS block: ${block.GEOID}\nState: ${block.STATE ?? '?'} | County: ${block.COUNTY ?? '?'} | Tract: ${block.TRACT ?? '?'} | Block: ${block.BLOCK ?? '?'}`;
 }
+// ---- pay1 tools:
+const GEO_BASE = 'https://geocoding.geo.census.gov/geocoder/geographies';
+// Most useful layers first, so a capped list never hides the state or county.
+const LAYER_ORDER = ['States', 'Counties', 'Census Tracts', 'Incorporated Places', 'County Subdivisions', 'Urban Areas', 'Combined Statistical Areas', '2020 Census Blocks'];
+function layerRank(name) {
+    const index = LAYER_ORDER.findIndex((known) => name.startsWith(known));
+    return index === -1 ? LAYER_ORDER.length : index;
+}
+/** Every layer the geocoder knows for a point, capped so the output stays readable. */
+function formatLayers(layers, maxLayers = 12, maxRows = 3) {
+    const names = Object.keys(layers).sort((a, b) => layerRank(a) - layerRank(b) || a.localeCompare(b));
+    const lines = [];
+    for (const name of names.slice(0, maxLayers)) {
+        const rows = (layers[name] ?? []).slice(0, maxRows);
+        if (!rows.length)
+            continue;
+        const described = rows.map((r) => {
+            const label = r.BASENAME ?? r.NAME ?? 'not reported';
+            const id = r.GEOID ? ` (GEOID ${r.GEOID})` : '';
+            const state = r.STATE ? ` state ${r.STATE}` : '';
+            return `${label}${id}${state}`;
+        });
+        lines.push(`  ${name}: ${described.join(' | ')}`);
+    }
+    if (names.length > maxLayers)
+        lines.push(`  ...and ${names.length - maxLayers} more layer(s)`);
+    return lines;
+}
+export async function coordinateGeographies(args) {
+    const x = Number(args.x), y = Number(args.y);
+    if (!Number.isFinite(x) || !Number.isFinite(y))
+        throw new Error('Provide valid x (lon) and y (lat).');
+    const url = `${GEO_BASE}/coordinates?x=${x}&y=${y}&benchmark=Public_AR_Current&vintage=Current_Current&format=json`;
+    const res = await fetch(url, {
+        headers: { 'User-Agent': UA, Accept: 'application/json' },
+        signal: AbortSignal.timeout(25000),
+    });
+    if (!res.ok)
+        throw new Error(`Census geocoder returned ${res.status}`);
+    const d = (await res.json());
+    const layers = d.result?.geographies ?? {};
+    const lines = formatLayers(layers);
+    if (!lines.length)
+        throw new Error(`No census geographies for ${x},${y}.`);
+    return [`Census geographies for ${x},${y}`, ...lines].join('\n');
+}

package/dist/server.js

@@ -1,7 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { coordinates } from "./api.js";
-import { geocode } from "./api.js";
+import { coordinates, geocode, coordinateGeographies } from "./api.js";
 const text = (value) => ({ content: [{ type: "text", text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -18,7 +17,7 @@ export function createServer() {
             return text(await geocode(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("coordinates", {
@@ -31,7 +30,34 @@ export function createServer() {
             return text(await coordinates(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
+        }
+    });
+    server.registerTool("address_geographies", {
+        title: "Address geographies",
+        description: "Every census geography an address falls in: state, county, tract, place, congressional district and more.",
+        inputSchema: z.object({ address: z.string().describe("Street address, e.g. '1600 Pennsylvania Ave NW Washington DC'.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement geographies locally (paywall removed)
+        try {
+            return textError("Not yet implemented: geographies");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("coordinate_geographies", {
+        title: "Coordinate geographies",
+        description: "Every census geography a longitude/latitude falls in: state, county, tract, place, congressional district and more.",
+        inputSchema: z.object({ x: z.number().describe("Longitude."), y: z.number().describe("Latitude.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await coordinateGeographies(args));
+        }
+        catch (e) {
+            return textError(String(e));
         }
     });
     return server;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "repository": {
     "type": "git",
@@ -41,4 +41,4 @@
     "node": ">=20"
   },
   "mcpName": "io.github.mrfentmen/census-geo-mcp"
-}
+}

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/mrfentmen/census-geo-mcp",
     "source": "github"
   },
-  "version": "1.0.0",
+  "version": "1.0.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "census-geo-mcp",
-      "version": "1.0.0",
+      "version": "1.0.1",
       "transport": {
         "type": "stdio"
       }