us-gov-open-data-mcp 1.0.0

package/dist/modules/usgs.js

@@ -0,0 +1,203 @@
+/**
+ * USGS module — earthquake data and water resources monitoring.
+ */
+import { z } from "zod";
+import { searchEarthquakes, countEarthquakes, getSignificantEarthquakes, getWaterData, getDailyWaterData, searchWaterSites, WATER_PARAMS, ALERT_LEVELS, clearCache as sdkClearCache, } from "../sdk/usgs.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "usgs";
+export const displayName = "USGS (U.S. Geological Survey)";
+export const description = "Earthquake events (magnitude, location, depth, tsunami risk) and water resources monitoring (streamflow, water levels, temperature) from 13,000+ stations nationwide. No API key required.";
+export const workflow = "Use usgs_earthquakes to search for earthquakes by magnitude/location/date → usgs_significant for recent notable events → usgs_water_data for streamflow and water levels at monitoring sites → usgs_water_sites to find stations.";
+export const tips = "Earthquake magnitudes: 2.5+ felt by people, 4.0+ moderate, 5.0+ significant, 7.0+ major. Water parameter codes: 00060=discharge, 00065=gage height, 00010=water temp. Use state codes (CA, TX) for water site searches.";
+export const reference = {
+    waterParams: WATER_PARAMS,
+    alertLevels: ALERT_LEVELS,
+    docs: {
+        "Earthquake API": "https://earthquake.usgs.gov/fdsnws/event/1/",
+        "Water Services": "https://waterservices.usgs.gov/",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeEarthquakes(features) {
+    if (!features.length)
+        return "No earthquakes found matching the criteria.";
+    const lines = features.map((f) => {
+        const p = f.properties;
+        const [lon, lat, depth] = f.geometry.coordinates;
+        const time = p.time ? new Date(p.time).toISOString() : "?";
+        const parts = [
+            `M${p.mag ?? "?"} — ${p.place ?? "Unknown location"}`,
+            `  Time: ${time}`,
+            `  Depth: ${depth?.toFixed(1) ?? "?"}km | Lat: ${lat?.toFixed(3)}, Lon: ${lon?.toFixed(3)}`,
+        ];
+        if (p.alert)
+            parts.push(`  Alert: ${p.alert.toUpperCase()} — ${ALERT_LEVELS[p.alert] ?? ""}`);
+        if (p.tsunami === 1)
+            parts.push("  ⚠ TSUNAMI WARNING");
+        if (p.felt)
+            parts.push(`  Felt by: ${p.felt} people`);
+        if (p.url)
+            parts.push(`  Details: ${p.url}`);
+        return parts.join("\n");
+    });
+    return `${features.length} earthquake(s) found:\n\n${lines.join("\n\n")}`;
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "usgs_earthquakes",
+        description: "Search for earthquakes by magnitude, location, date range, and more.\n" +
+            "Returns magnitude, location, depth, time, alert level, tsunami risk, and felt reports.\n" +
+            "Magnitude scale: 2.5+ felt by people, 4.0+ moderate, 5.0+ significant, 7.0+ major.",
+        annotations: { title: "USGS: Earthquake Search", readOnlyHint: true },
+        parameters: z.object({
+            starttime: z.string().optional().describe("Start date ISO format: '2024-01-01'"),
+            endtime: z.string().optional().describe("End date ISO format: '2024-12-31'"),
+            minmagnitude: z.number().optional().describe("Minimum magnitude (e.g. 4.0, 5.0, 6.0)"),
+            maxmagnitude: z.number().optional().describe("Maximum magnitude"),
+            latitude: z.number().optional().describe("Center latitude for radius search"),
+            longitude: z.number().optional().describe("Center longitude for radius search"),
+            maxradiuskm: z.number().optional().describe("Search radius in km (requires lat/lon)"),
+            alertlevel: z.enum(["green", "yellow", "orange", "red"]).optional().describe("PAGER alert level filter"),
+            limit: z.number().int().max(200).optional().describe("Max results (default 20, max 200)"),
+            orderby: z.enum(["time", "time-asc", "magnitude", "magnitude-asc"]).optional().describe("Sort order (default: time)"),
+        }),
+        execute: async (args) => {
+            const data = await searchEarthquakes(args);
+            const header = `${data.metadata?.count ?? data.features.length} total matches`;
+            return { content: [{ type: "text", text: `${header}\n\n${summarizeEarthquakes(data.features)}` }] };
+        },
+    },
+    {
+        name: "usgs_significant",
+        description: "Get significant earthquakes from the past 30 days (typically M4.5+ or felt/damaging events).\n" +
+            "Quick way to see the latest notable seismic activity worldwide.",
+        annotations: { title: "USGS: Significant Earthquakes", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const data = await getSignificantEarthquakes();
+            return { content: [{ type: "text", text: summarizeEarthquakes(data.features) }] };
+        },
+    },
+    {
+        name: "usgs_earthquake_count",
+        description: "Count earthquakes matching criteria without fetching full details.\n" +
+            "Useful for statistics: 'How many M5+ earthquakes occurred in 2024?'",
+        annotations: { title: "USGS: Earthquake Count", readOnlyHint: true },
+        parameters: z.object({
+            starttime: z.string().optional().describe("Start date: '2024-01-01'"),
+            endtime: z.string().optional().describe("End date: '2024-12-31'"),
+            minmagnitude: z.number().optional().describe("Minimum magnitude"),
+            maxmagnitude: z.number().optional().describe("Maximum magnitude"),
+            latitude: z.number().optional().describe("Center latitude for radius search"),
+            longitude: z.number().optional().describe("Center longitude for radius search"),
+            maxradiuskm: z.number().optional().describe("Search radius in km"),
+        }),
+        execute: async (args) => {
+            const data = await countEarthquakes(args);
+            return { content: [{ type: "text", text: `Earthquake count: ${data.count}` }] };
+        },
+    },
+    {
+        name: "usgs_water_data",
+        description: "Get real-time water data (streamflow, gage height, temperature) from USGS monitoring sites.\n" +
+            "13,000+ stations nationwide. Parameter codes: 00060=discharge (cfs), 00065=gage height (ft), 00010=water temp (°C).\n" +
+            "Query by site ID, state, county, or hydrologic unit code (HUC).",
+        annotations: { title: "USGS: Water Data", readOnlyHint: true },
+        parameters: z.object({
+            sites: z.string().optional().describe("USGS site number(s), comma-separated: '01646500' or '01646500,01647000'"),
+            state_cd: z.string().optional().describe("Two-letter state code: 'CA', 'TX', 'NY'"),
+            parameter_cd: z.string().optional().describe("Parameter code: '00060' (discharge), '00065' (gage height), '00010' (temp). Default: 00060"),
+            period: z.string().optional().describe("ISO 8601 duration: 'P1D' (1 day, default), 'P7D' (7 days), 'P30D' (30 days)"),
+            start_dt: z.string().optional().describe("Start date: '2024-01-01' (overrides period)"),
+            end_dt: z.string().optional().describe("End date: '2024-01-31'"),
+        }),
+        execute: async (args) => {
+            const data = await getWaterData({
+                sites: args.sites,
+                stateCd: args.state_cd,
+                parameterCd: args.parameter_cd,
+                period: args.period,
+                startDT: args.start_dt,
+                endDT: args.end_dt,
+            });
+            const series = data?.value?.timeSeries ?? [];
+            if (!series.length)
+                return { content: [{ type: "text", text: "No water data found for the specified criteria." }] };
+            const summaries = series.slice(0, 20).map((ts) => {
+                const siteName = ts.sourceInfo?.siteName ?? "Unknown";
+                const siteCode = ts.sourceInfo?.siteCode?.[0]?.value ?? "?";
+                const varName = ts.variable?.variableName ?? "?";
+                const unit = ts.variable?.unit?.unitCode ?? "";
+                const values = ts.values?.[0]?.value ?? [];
+                const latest = values[values.length - 1];
+                return `${siteName} (${siteCode})\n  ${varName}: ${latest?.value ?? "N/A"} ${unit} (${latest?.dateTime ?? "?"})  |  ${values.length} readings`;
+            });
+            return { content: [{ type: "text", text: `${series.length} time series found:\n\n${summaries.join("\n\n")}` }] };
+        },
+    },
+    {
+        name: "usgs_water_sites",
+        description: "Search for USGS water monitoring sites by state, county, or hydrologic unit.\n" +
+            "Site types: ST=stream, GW=groundwater, LK=lake, SP=spring.",
+        annotations: { title: "USGS: Water Sites", readOnlyHint: true },
+        parameters: z.object({
+            state_cd: z.string().optional().describe("Two-letter state code: 'CA', 'TX'"),
+            county_cd: z.string().optional().describe("County FIPS code"),
+            site_type: z.string().optional().describe("Site type: 'ST' (stream, default), 'GW' (groundwater), 'LK' (lake), 'SP' (spring)"),
+        }),
+        execute: async (args) => {
+            const data = await searchWaterSites({
+                stateCd: args.state_cd,
+                countyCd: args.county_cd,
+                siteType: args.site_type,
+            });
+            // RDB format comes back as a string
+            const text = typeof data === "string" ? data : JSON.stringify(data, null, 2);
+            const lines = text.split("\n").filter((l) => !l.startsWith("#"));
+            const preview = lines.slice(0, 50).join("\n");
+            return { content: [{ type: "text", text: `Water monitoring sites:\n\n${preview}${lines.length > 50 ? `\n\n... ${lines.length - 50} more rows` : ""}` }] };
+        },
+    },
+    {
+        name: "usgs_daily_water_data",
+        description: "Get USGS daily value water data (historical daily averages).\n" +
+            "Unlike real-time instantaneous values, these are aggregated daily means — better for trend analysis.\n" +
+            "Parameter codes: 00060=discharge (cfs), 00065=gage height (ft), 00010=water temp (°C).",
+        annotations: { title: "USGS: Daily Water Data", readOnlyHint: true },
+        parameters: z.object({
+            sites: z.string().optional().describe("USGS site number(s): '01646500'"),
+            state_cd: z.string().optional().describe("Two-letter state code: 'CA', 'TX'"),
+            parameter_cd: z.string().optional().describe("Parameter code: '00060' (discharge), '00065' (gage height). Default: 00060"),
+            period: z.string().optional().describe("ISO 8601 duration: 'P30D' (default), 'P90D', 'P365D'"),
+            start_dt: z.string().optional().describe("Start date: '2024-01-01' (overrides period)"),
+            end_dt: z.string().optional().describe("End date: '2024-12-31'"),
+        }),
+        execute: async (args) => {
+            const data = await getDailyWaterData({
+                sites: args.sites,
+                stateCd: args.state_cd,
+                parameterCd: args.parameter_cd,
+                period: args.period,
+                startDT: args.start_dt,
+                endDT: args.end_dt,
+            });
+            const series = data?.value?.timeSeries ?? [];
+            if (!series.length)
+                return { content: [{ type: "text", text: "No daily water data found." }] };
+            const summaries = series.slice(0, 10).map((ts) => {
+                const siteName = ts.sourceInfo?.siteName ?? "Unknown";
+                const siteCode = ts.sourceInfo?.siteCode?.[0]?.value ?? "?";
+                const varName = ts.variable?.variableName ?? "?";
+                const unit = ts.variable?.unit?.unitCode ?? "";
+                const values = ts.values?.[0]?.value ?? [];
+                const latest = values[values.length - 1];
+                const earliest = values[0];
+                return `${siteName} (${siteCode})\n  ${varName}: ${values.length} daily values\n  Latest: ${latest?.value ?? "N/A"} ${unit} (${latest?.dateTime?.split("T")[0] ?? "?"})\n  Earliest: ${earliest?.value ?? "N/A"} ${unit} (${earliest?.dateTime?.split("T")[0] ?? "?"})`;
+            });
+            return { content: [{ type: "text", text: `${series.length} time series found:\n\n${summaries.join("\n\n")}` }] };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=usgs.js.map

package/dist/modules/usgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usgs.js","sourceRoot":"","sources":["../../src/modules/usgs.ts"],"names":[],"mappings":"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"}

package/dist/modules/uspto.d.ts

@@ -0,0 +1,13 @@
+/**
+ * USPTO module — Patent search, inventor lookup, assignee analysis via PatentsView API
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/uspto.js";
+export declare const name = "uspto";
+export declare const displayName = "USPTO PatentsView";
+export declare const description = "U.S. Patent & Trademark Office patent data via PatentsView \u2014 search patents by keyword, assignee, inventor, date, or CPC class. Look up inventors and patent-holding organizations. Covers all U.S. utility, design, plant, and reissue patents.";
+export declare const workflow = "Use uspto_search_patents to find patents by keyword, company, or inventor \u2192 uspto_patent_details for full details on a specific patent \u2192 uspto_search_assignees to find companies with the most patents in an area.";
+export declare const tips = "Patent types: 'utility' (most common), 'design', 'plant', 'reissue'. CPC sections: A (Human Necessities), B (Operations/Transport), C (Chemistry), D (Textiles), E (Construction), F (Mechanical Engineering), G (Physics), H (Electricity). Use yearFrom/yearTo to filter by grant date. Patent numbers don't have commas (e.g. '11234567' not '11,234,567').";
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=uspto.d.ts.map

package/dist/modules/uspto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uspto.d.ts","sourceRoot":"","sources":["../../src/modules/uspto.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAKL,UAAU,IAAI,aAAa,EAC5B,MAAM,iBAAiB,CAAC;AAIzB,eAAO,MAAM,IAAI,UAAU,CAAC;AAC5B,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAC/C,eAAO,MAAM,WAAW,0PAC4N,CAAC;AACrP,eAAO,MAAM,QAAQ,kOACkM,CAAC;AACxN,eAAO,MAAM,IAAI,mWACiV,CAAC;AA4BnW,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA0IjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/uspto.js

@@ -0,0 +1,157 @@
+/**
+ * USPTO module — Patent search, inventor lookup, assignee analysis via PatentsView API
+ */
+import { z } from "zod";
+import { searchPatents, getPatent, searchInventors, searchAssignees, clearCache as sdkClearCache, } from "../sdk/uspto.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "uspto";
+export const displayName = "USPTO PatentsView";
+export const description = "U.S. Patent & Trademark Office patent data via PatentsView — search patents by keyword, assignee, inventor, date, or CPC class. Look up inventors and patent-holding organizations. Covers all U.S. utility, design, plant, and reissue patents.";
+export const workflow = "Use uspto_search_patents to find patents by keyword, company, or inventor → uspto_patent_details for full details on a specific patent → uspto_search_assignees to find companies with the most patents in an area.";
+export const tips = "Patent types: 'utility' (most common), 'design', 'plant', 'reissue'. CPC sections: A (Human Necessities), B (Operations/Transport), C (Chemistry), D (Textiles), E (Construction), F (Mechanical Engineering), G (Physics), H (Electricity). Use yearFrom/yearTo to filter by grant date. Patent numbers don't have commas (e.g. '11234567' not '11,234,567').";
+// ─── Helpers ─────────────────────────────────────────────────────────
+function formatPatent(p) {
+    const lines = [
+        `Patent ${p.patentNumber}: ${p.patentTitle}`,
+        `  Date: ${p.patentDate}  Type: ${p.patentType ?? "N/A"}  Claims: ${p.numClaims ?? "N/A"}`,
+    ];
+    if (p.assigneeOrganization)
+        lines.push(`  Assignee: ${p.assigneeOrganization}`);
+    if (p.inventorNames.length)
+        lines.push(`  Inventors: ${p.inventorNames.join(", ")}`);
+    if (p.cpcGroup)
+        lines.push(`  CPC: ${p.cpcGroup}`);
+    if (p.patentAbstract)
+        lines.push(`  Abstract: ${p.patentAbstract}`);
+    return lines.join("\n");
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "uspto_search_patents",
+        description: "Search U.S. patents by keyword, assignee (company), inventor name, date range, patent type, or CPC technology class. Returns patent number, title, date, assignee, inventors, and abstract.",
+        annotations: { title: "Search Patents", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().optional().describe("Search text — matches against title and abstract"),
+            assignee: z.string().optional().describe("Assignee organization name (e.g. 'Google', 'IBM', 'MIT')"),
+            inventor: z.string().optional().describe("Inventor name to search"),
+            year_from: z.number().optional().describe("Start year for patent grant date (e.g. 2020)"),
+            year_to: z.number().optional().describe("End year for patent grant date (e.g. 2024)"),
+            patent_type: z.enum(["utility", "design", "plant", "reissue"]).optional().describe("Patent type filter"),
+            cpc_section: z.string().optional().describe("CPC section letter: A-H (e.g. 'G' for Physics, 'H' for Electricity)"),
+            page: z.number().optional().describe("Page number (default 1)"),
+            per_page: z.number().max(50).optional().describe("Results per page (max 50, default 25)"),
+        }),
+        execute: async (args) => {
+            const result = await searchPatents({
+                query: args.query,
+                assignee: args.assignee,
+                inventor: args.inventor,
+                yearFrom: args.year_from,
+                yearTo: args.year_to,
+                patentType: args.patent_type,
+                cpcSection: args.cpc_section,
+                page: args.page,
+                perPage: args.per_page,
+            });
+            if (!result.patents.length) {
+                return { content: [{ type: "text", text: "No patents found matching the criteria." }] };
+            }
+            const header = `Found ${result.total.toLocaleString()} patent(s). Showing ${result.patents.length}:\n`;
+            const body = result.patents.map(formatPatent).join("\n\n");
+            return { content: [{ type: "text", text: header + body }] };
+        },
+    },
+    {
+        name: "uspto_patent_details",
+        description: "Get details for a specific U.S. patent by patent number. Returns title, date, abstract, assignee, inventors, claims count, and CPC classification.",
+        annotations: { title: "Patent Details", readOnlyHint: true },
+        parameters: z.object({
+            patent_number: z.string().describe("Patent number (e.g. '11234567' — no commas)"),
+        }),
+        execute: async (args) => {
+            const patent = await getPatent(args.patent_number);
+            if (!patent) {
+                return { content: [{ type: "text", text: `Patent ${args.patent_number} not found.` }] };
+            }
+            return { content: [{ type: "text", text: formatPatent(patent) }] };
+        },
+    },
+    {
+        name: "uspto_search_inventors",
+        description: "Search for patent inventors by name, state, or country. Shows inventor details and patent counts.",
+        annotations: { title: "Search Inventors", readOnlyHint: true },
+        parameters: z.object({
+            name: z.string().optional().describe("Inventor name to search (first or last)"),
+            first_name: z.string().optional().describe("Inventor first name"),
+            last_name: z.string().optional().describe("Inventor last name"),
+            state: z.string().optional().describe("U.S. state abbreviation (e.g. CA, TX)"),
+            country: z.string().optional().describe("Country code (e.g. US, CN, JP, DE)"),
+            page: z.number().optional().describe("Page number (default 1)"),
+        }),
+        execute: async (args) => {
+            const result = await searchInventors({
+                name: args.name,
+                firstName: args.first_name,
+                lastName: args.last_name,
+                state: args.state,
+                country: args.country,
+                page: args.page,
+            });
+            if (!result.inventors.length) {
+                return { content: [{ type: "text", text: "No inventors found matching the criteria." }] };
+            }
+            const lines = result.inventors.map((inv) => {
+                const loc = [inv.inventorCity, inv.inventorState, inv.inventorCountry].filter(Boolean).join(", ");
+                return `${inv.inventorFirstName} ${inv.inventorLastName} — ${loc || "Location unknown"} (${inv.patentCount} patent(s))`;
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${result.total.toLocaleString()} inventor(s). Showing ${result.inventors.length}:\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+    },
+    {
+        name: "uspto_search_assignees",
+        description: "Search for patent assignees (companies, universities, government agencies) by name, state, or country. Shows organization details and patent counts.",
+        annotations: { title: "Search Assignees", readOnlyHint: true },
+        parameters: z.object({
+            organization: z.string().optional().describe("Organization name (e.g. 'Apple', 'Stanford University')"),
+            state: z.string().optional().describe("U.S. state abbreviation (e.g. CA, TX)"),
+            country: z.string().optional().describe("Country code (e.g. US, CN, JP, DE)"),
+            type: z.string().optional().describe("Assignee type: 2=US company, 3=foreign company, 4=US individual, 5=foreign individual, 6=US government, 7=foreign government, 8=country govt, 9=state govt"),
+            page: z.number().optional().describe("Page number (default 1)"),
+        }),
+        execute: async (args) => {
+            const result = await searchAssignees({
+                organization: args.organization,
+                state: args.state,
+                country: args.country,
+                type: args.type,
+                page: args.page,
+            });
+            if (!result.assignees.length) {
+                return { content: [{ type: "text", text: "No assignees found matching the criteria." }] };
+            }
+            const lines = result.assignees.map((a) => {
+                const loc = [a.assigneeCity, a.assigneeState, a.assigneeCountry].filter(Boolean).join(", ");
+                const name = a.assigneeOrganization || "(Individual)";
+                return `${name} — ${loc || "Location unknown"} (${a.patentCount} patent(s))`;
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${result.total.toLocaleString()} assignee(s). Showing ${result.assignees.length}:\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=uspto.js.map

package/dist/modules/uspto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uspto.js","sourceRoot":"","sources":["../../src/modules/uspto.ts"],"names":[],"mappings":"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"}

package/dist/modules/world-bank.d.ts

@@ -0,0 +1,21 @@
+/**
+ * World Bank MCP module — international economic comparisons.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "world-bank";
+export declare const displayName = "World Bank";
+export declare const description = "International economic indicators for 200+ countries: GDP, population, health spending, life expectancy, trade, inequality";
+export declare const workflow = "wb_indicator for a single country, wb_compare to compare countries, wb_search to find indicator IDs";
+export declare const tips = "Countries: US, GB, DE, JP, CN, IN, BR. Indicators: NY.GDP.MKTP.CD (GDP), SP.POP.TOTL (population), SP.DYN.LE00.IN (life expectancy)";
+export declare const reference: {
+    popularIndicators: Record<string, string>;
+    docs: {
+        "API Docs": string;
+        "Indicator List": string;
+        "Country Codes": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/world-bank.js";
+//# sourceMappingURL=world-bank.d.ts.map

package/dist/modules/world-bank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-bank.d.ts","sourceRoot":"","sources":["../../src/modules/world-bank.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKjD,eAAO,MAAM,IAAI,eAAe,CAAC;AACjC,eAAO,MAAM,WAAW,eAAe,CAAC;AACxC,eAAO,MAAM,WAAW,+HAA+H,CAAC;AACxJ,eAAO,MAAM,QAAQ,wGAAwG,CAAC;AAC9H,eAAO,MAAM,IAAI,wIAAwI,CAAC;AAE1J,eAAO,MAAM,SAAS;;;;;;;CAOrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA8FjC,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAc1C,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/modules/world-bank.js

@@ -0,0 +1,130 @@
+/**
+ * World Bank MCP module — international economic comparisons.
+ */
+import { z } from "zod";
+import { getIndicator, compareCountries, searchIndicators, listCountries, POPULAR_INDICATORS } from "../sdk/world-bank.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "world-bank";
+export const displayName = "World Bank";
+export const description = "International economic indicators for 200+ countries: GDP, population, health spending, life expectancy, trade, inequality";
+export const workflow = "wb_indicator for a single country, wb_compare to compare countries, wb_search to find indicator IDs";
+export const tips = "Countries: US, GB, DE, JP, CN, IN, BR. Indicators: NY.GDP.MKTP.CD (GDP), SP.POP.TOTL (population), SP.DYN.LE00.IN (life expectancy)";
+export const reference = {
+    popularIndicators: POPULAR_INDICATORS,
+    docs: {
+        "API Docs": "https://datahelpdesk.worldbank.org/knowledgebase/articles/889392",
+        "Indicator List": "https://data.worldbank.org/indicator",
+        "Country Codes": "https://datahelpdesk.worldbank.org/knowledgebase/articles/898590",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "wb_indicator",
+        description: "Get a World Bank indicator for a country.\nPopular: NY.GDP.MKTP.CD (GDP), SP.DYN.LE00.IN (life expectancy), SH.XPD.CHEX.PC.CD (health spend/capita), SL.UEM.TOTL.ZS (unemployment)",
+        annotations: { title: "World Bank: Get Indicator", readOnlyHint: true },
+        parameters: z.object({
+            indicator: z.string().describe("Indicator code, e.g. 'NY.GDP.MKTP.CD'"),
+            country: z.string().optional().describe("ISO2 code: US, GB, DE, JP, CN. Default: US"),
+            date_range: z.string().optional().describe("Year range: '2015:2024' or single year '2024'. Default: last 10 years"),
+        }),
+        execute: async ({ indicator, country, date_range }) => {
+            const now = new Date().getFullYear();
+            const result = await getIndicator(indicator, {
+                country: country ?? "US",
+                dateRange: date_range ?? `${now - 10}:${now}`,
+            });
+            if (!result.data.length)
+                return `No data for indicator ${indicator} in ${country ?? "US"}.`;
+            const valid = result.data.filter(d => d.value !== null);
+            return JSON.stringify({
+                summary: `${result.data[0]?.indicator?.value ?? indicator}: ${valid.length} data points for ${result.data[0]?.country?.value ?? country}`,
+                indicator: result.data[0]?.indicator,
+                country: result.data[0]?.country,
+                total: result.total,
+                data: valid.map(d => ({ year: d.date, value: d.value })),
+            });
+        },
+    },
+    {
+        name: "wb_compare",
+        description: "Compare a World Bank indicator across multiple countries.\nGreat for 'How does US compare to...' questions.",
+        annotations: { title: "World Bank: Compare Countries", readOnlyHint: true },
+        parameters: z.object({
+            indicator: z.string().describe("Indicator code"),
+            countries: z.string().describe("Semicolon-separated ISO2 codes: 'US;GB;DE;JP;CN'"),
+            date_range: z.string().optional().describe("Year range: '2015:2024'. Default: last 5 years"),
+        }),
+        execute: async ({ indicator, countries, date_range }) => {
+            const now = new Date().getFullYear();
+            const countryList = countries.split(/[;,]/).map((c) => c.trim()).filter(Boolean);
+            const result = await compareCountries(indicator, countryList, {
+                dateRange: date_range ?? `${now - 5}:${now}`,
+            });
+            if (!result.data.length)
+                return `No data for ${indicator} across ${countries}.`;
+            // Group by country
+            const byCountry = {};
+            for (const d of result.data) {
+                const key = d.countryiso3code || d.country?.value || "?";
+                if (!byCountry[key])
+                    byCountry[key] = [];
+                byCountry[key].push({ year: d.date, value: d.value });
+            }
+            return JSON.stringify({
+                summary: `${result.data[0]?.indicator?.value ?? indicator} comparison across ${Object.keys(byCountry).length} countries`,
+                indicator: result.data[0]?.indicator,
+                countries: byCountry,
+            });
+        },
+    },
+    {
+        name: "wb_search",
+        description: "Search World Bank indicators by keyword.\nExamples: 'GDP', 'health expenditure', 'life expectancy', 'CO2 emissions'",
+        annotations: { title: "World Bank: Search Indicators", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Keywords to search for"),
+        }),
+        execute: async ({ query }) => {
+            const results = await searchIndicators(query, 30);
+            if (!results.length)
+                return `No indicators found for "${query}".`;
+            return JSON.stringify({
+                summary: `${results.length} indicators matching "${query}"`,
+                indicators: results.map(i => ({ id: i.id, name: i.name, source: i.source?.value })),
+            });
+        },
+    },
+    {
+        name: "wb_countries",
+        description: "List World Bank countries with region, income level, and capital city.",
+        annotations: { title: "World Bank: List Countries", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const countries = await listCountries();
+            return JSON.stringify({
+                summary: `${countries.length} countries`,
+                countries: countries.map(c => ({
+                    code: c.iso2Code, name: c.name, region: c.region?.value,
+                    income: c.incomeLevel?.value, capital: c.capitalCity,
+                })),
+            });
+        },
+    },
+];
+export const prompts = [
+    {
+        name: "international_comparison",
+        description: "Compare the U.S. to peer nations on key economic and social indicators.",
+        load: async () => "Use wb_compare to compare the U.S. (US) with major economies (GB, DE, JP, CN, CA, FR) on these indicators:\n\n" +
+            "1. NY.GDP.PCAP.CD — GDP per capita\n" +
+            "2. SH.XPD.CHEX.PC.CD — Health expenditure per capita\n" +
+            "3. SP.DYN.LE00.IN — Life expectancy at birth\n" +
+            "4. SL.UEM.TOTL.ZS — Unemployment rate\n" +
+            "5. GC.DOD.TOTL.GD.ZS — Government debt as % of GDP\n" +
+            "6. FP.CPI.TOTL.ZG — Inflation rate\n\n" +
+            "Use date range last 5 years. Present as a comparison table. Note where the U.S. ranks among peers and highlight any outliers.",
+    },
+];
+export { clearCache } from "../sdk/world-bank.js";
+//# sourceMappingURL=world-bank.js.map

package/dist/modules/world-bank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-bank.js","sourceRoot":"","sources":["../../src/modules/world-bank.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE3H,wEAAwE;AAExE,MAAM,CAAC,MAAM,IAAI,GAAG,YAAY,CAAC;AACjC,MAAM,CAAC,MAAM,WAAW,GAAG,YAAY,CAAC;AACxC,MAAM,CAAC,MAAM,WAAW,GAAG,4HAA4H,CAAC;AACxJ,MAAM,CAAC,MAAM,QAAQ,GAAG,qGAAqG,CAAC;AAC9H,MAAM,CAAC,MAAM,IAAI,GAAG,qIAAqI,CAAC;AAE1J,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,iBAAiB,EAAE,kBAAkB;IACrC,IAAI,EAAE;QACJ,UAAU,EAAE,kEAAkE;QAC9E,gBAAgB,EAAE,sCAAsC;QACxD,eAAe,EAAE,kEAAkE;KACpF;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,oLAAoL;QACjM,WAAW,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,YAAY,EAAE,IAAI,EAAE;QACvE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;YACvE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;YACrF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;SACpH,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE;YACpD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE;gBAC3C,OAAO,EAAE,OAAO,IAAI,IAAI;gBACxB,SAAS,EAAE,UAAU,IAAI,GAAG,GAAG,GAAG,EAAE,IAAI,GAAG,EAAE;aAC9C,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,yBAAyB,SAAS,OAAO,OAAO,IAAI,IAAI,GAAG,CAAC;YAC5F,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;YACxD,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,IAAI,SAAS,KAAK,KAAK,CAAC,MAAM,oBAAoB,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,OAAO,EAAE;gBACzI,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS;gBACpC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO;gBAChC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;aACzD,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,6GAA6G;QAC1H,WAAW,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,YAAY,EAAE,IAAI,EAAE;QAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YAChD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YAClF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gDAAgD,CAAC;SAC7F,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,EAAE;YACtD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzF,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,SAAS,EAAE,WAAW,EAAE;gBAC5D,SAAS,EAAE,UAAU,IAAI,GAAG,GAAG,GAAG,CAAC,IAAI,GAAG,EAAE;aAC7C,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM;gBAAE,OAAO,eAAe,SAAS,WAAW,SAAS,GAAG,CAAC;YAEhF,mBAAmB;YACnB,MAAM,SAAS,GAA6D,EAAE,CAAC;YAC/E,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,eAAe,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC;gBACzD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;oBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;gBACzC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,KAAK,IAAI,SAAS,sBAAsB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,YAAY;gBACxH,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,SAAS;gBACpC,SAAS,EAAE,SAAS;aACrB,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,WAAW;QACjB,WAAW,EAAE,qHAAqH;QAClI,WAAW,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,YAAY,EAAE,IAAI,EAAE;QAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;SACrD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,CAAC,MAAM;gBAAE,OAAO,4BAA4B,KAAK,IAAI,CAAC;YAClE,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,OAAO,CAAC,MAAM,yBAAyB,KAAK,GAAG;gBAC3D,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;aACpF,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,wEAAwE;QACrF,WAAW,EAAE,EAAE,KAAK,EAAE,4BAA4B,EAAE,YAAY,EAAE,IAAI,EAAE;QACxE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,SAAS,CAAC,MAAM,YAAY;gBACxC,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;oBAC7B,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK;oBACvD,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,WAAW;iBACrD,CAAC,CAAC;aACJ,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,OAAO,GAA4B;IAC9C;QACE,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,yEAAyE;QACtF,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,gHAAgH;YAChH,sCAAsC;YACtC,wDAAwD;YACxD,gDAAgD;YAChD,yCAAyC;YACzC,sDAAsD;YACtD,wCAAwC;YACxC,+HAA+H;KAClI;CACF,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Cross-cutting analysis prompts — reusable multi-API investigation templates.
+ *
+ * These prompts span multiple modules and provide step-by-step instructions
+ * for common research patterns. Each returns a detailed plan telling the client
+ * which tools to call and in what order.
+ *
+ * Users invoke these from the MCP prompt picker (e.g. "/" menu in VS Code).
+ */
+import type { InputPrompt } from "fastmcp";
+export declare const analysisPrompts: InputPrompt<any, any>[];
+//# sourceMappingURL=prompts.d.ts.map

package/dist/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EA85BlD,CAAC"}