census-geo-mcp 1.0.4 → 1.0.5

package/dist/api.js

@@ -80,3 +80,42 @@ export async function coordinateGeographies(args) {
         throw new Error(`No census geographies for ${x},${y}.`);
     return [`Census geographies for ${x},${y}`, ...lines].join('\n');
 }
+
+const CENSUS = 'https://geocoding.geo.census.gov/geocoder/geographies/onelineaddress';
+export async function addressGeographies(args = {}) {
+    const address = String(args?.address ?? '').trim();
+    if (address.length < 5)
+        throw new Error('Give a street address, like 1600 Pennsylvania Ave NW Washington DC.');
+    const qs = new URLSearchParams({
+        address,
+        benchmark: 'Public_AR_Current',
+        vintage: 'Current_Current',
+        format: 'json',
+    });
+    const res = await fetch(`${CENSUS}?${qs}`, {
+        headers: { 'User-Agent': 'mrfentmen-census-geo-mcp/1.0', Accept: 'application/json' },
+        signal: AbortSignal.timeout(30000),
+    });
+    if (!res.ok)
+        throw new Error(`Census geocoder returned ${res.status}`);
+    if (!(res.headers.get('content-type') ?? '').includes('json'))
+        throw new Error('The Census geocoder answered with a page instead of data; try again shortly.');
+    const body = (await res.json());
+    const match = body.result?.addressMatches?.[0];
+    if (!match)
+        throw new Error(`The Census geocoder could not match "${address}"`);
+    const layers = Object.entries(match.geographies ?? {});
+    const lines = layers.map(([layer, rows]) => {
+        const names = (rows ?? []).map((r) => r.NAME ?? r.BASENAME ?? '?').filter(Boolean);
+        return `${layer}: ${names.join(', ') || 'no name reported'}`;
+    });
+    const c = match.coordinates ?? {};
+    return [
+        `Matched: ${match.matchedAddress ?? address}`,
+        `Coordinates: ${c.y ?? '?'}, ${c.x ?? '?'}`,
+        `Benchmark ${body.result?.benchmark?.benchmarkName ?? '?'} · vintage ${body.result?.vintage?.vintageName ?? '?'}`,
+        '',
+        `${layers.length} geographies:`,
+        ...lines,
+    ].join('\n');
+}

package/dist/server.js

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { coordinates, geocode, coordinateGeographies } from "./api.js";
+import { coordinates, geocode, coordinateGeographies, addressGeographies } 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 };
@@ -39,9 +39,8 @@ export function createServer() {
         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");
+            return text(await addressGeographies(args));
         }
         catch (e) {
             return textError(String(e));

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.4",
+  "version": "1.0.5",
   "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.1",
+  "version": "1.0.5",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "census-geo-mcp",
-      "version": "1.0.1",
+      "version": "1.0.5",
       "transport": {
         "type": "stdio"
       }