us-gov-open-data-mcp 1.0.0

package/dist/modules/usaspending.js

@@ -0,0 +1,204 @@
+/**
+ * USAspending MCP module — tools + metadata. Delegates all API calls to sdk/usaspending.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import { z } from "zod";
+import { searchAwards, spendingByAgency, spendingByState, topRecipients, spendingOverTime, agencyOverview, currentFiscalYear, awardTypes, agencyCodes, } from "../sdk/usaspending.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "usaspending";
+export const displayName = "USAspending";
+export const description = "Federal contracts, grants, loans, direct payments — who got the money and where";
+export const workflow = "search awards by keyword/agency/state → drill into recipients or trends";
+export const tips = "No API key required. Data updates nightly. Earliest data: FY2008 (2007-10-01).";
+export const reference = {
+    awardTypes,
+    agencyCodes,
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "usa_spending_by_award",
+        description: "Search federal spending awards (contracts, grants, loans, direct payments). " +
+            "Filter by keyword, agency, recipient, date range, award type, and amount.\n\n" +
+            "Award type groups: 'contracts', 'grants', 'loans', 'direct_payments'. " +
+            "Or use codes: 'A,B,C,D' (contracts), '02,03,04,05' (grants), '07,08' (loans), '06,10' (direct payments)",
+        annotations: { title: "USAspending: Search Awards", readOnlyHint: true },
+        parameters: z.object({
+            keyword: z.string().optional().describe("Keyword to search across award descriptions and recipient names"),
+            award_type: z.string().optional().describe("'contracts', 'grants', 'loans', 'direct_payments', or comma-separated codes"),
+            agency: z.string().optional().describe("Awarding agency name, e.g. 'Department of Defense'"),
+            recipient: z.string().optional().describe("Recipient/company name to search for"),
+            state: z.string().optional().describe("Two-letter state code, e.g. 'CA', 'TX'"),
+            start_date: z.string().optional().describe("Start date YYYY-MM-DD (default: current FY). Earliest: 2007-10-01"),
+            end_date: z.string().optional().describe("End date YYYY-MM-DD (default: today)"),
+            min_amount: z.number().optional().describe("Minimum award amount in dollars"),
+            max_amount: z.number().optional().describe("Maximum award amount in dollars"),
+            limit: z.number().int().positive().max(100).optional().describe("Results per page (default: 25)"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+            sort_field: z.string().optional().describe("Sort by: 'Award Amount' (default), 'Recipient Name', 'Start Date', 'End Date'"),
+        }),
+        execute: async ({ keyword, award_type, agency, recipient, state, start_date, end_date, min_amount, max_amount, limit, page, sort_field }) => {
+            const data = await searchAwards({
+                keyword, awardType: award_type, agency, recipient, state,
+                startDate: start_date, endDate: end_date,
+                minAmount: min_amount, maxAmount: max_amount,
+                limit, page, sortField: sort_field,
+            });
+            if (!data.awards.length)
+                return JSON.stringify({ summary: "No awards found matching the criteria.", total: 0, awards: [] });
+            return JSON.stringify({
+                summary: `USAspending award search: ${data.total} total results, showing ${data.awards.length}`,
+                totalResults: data.total,
+                showing: data.awards.length,
+                awards: data.awards,
+            });
+        },
+    },
+    {
+        name: "usa_spending_by_agency",
+        description: "Get total federal spending broken down by awarding agency. " +
+            "Shows which agencies are spending the most.",
+        annotations: { title: "USAspending: Spending by Agency", readOnlyHint: true },
+        parameters: z.object({
+            fiscal_year: z.number().int().optional().describe("Fiscal year (default: current)"),
+            state: z.string().optional().describe("Two-letter state code, e.g. 'CA', 'TX'"),
+            keyword: z.string().optional().describe("Keyword to filter spending"),
+            award_type: z.string().optional().describe("'contracts', 'grants', 'loans', 'direct_payments'"),
+            limit: z.number().int().positive().max(100).optional().describe("Number of agencies (default: 20)"),
+        }),
+        execute: async ({ fiscal_year, state, keyword, award_type, limit }) => {
+            const fy = fiscal_year || currentFiscalYear();
+            const agencies = await spendingByAgency({ fiscalYear: fy, state, keyword, awardType: award_type, limit });
+            if (!agencies.length)
+                return JSON.stringify({ summary: `No spending data found for FY ${fy}.`, fiscalYear: fy, agencies: [] });
+            return JSON.stringify({
+                summary: `Federal spending by agency FY ${fy}: ${agencies.length} agencies`,
+                fiscalYear: fy,
+                agencies,
+            });
+        },
+    },
+    {
+        name: "usa_spending_by_state",
+        description: "Get federal spending by state or territory. Shows total awards and per-capita spending.",
+        annotations: { title: "USAspending: Spending by State", readOnlyHint: true },
+        parameters: z.object({
+            state: z.string().optional().describe("Two-letter state code (e.g. 'CA'). Omit for all states."),
+            fiscal_year: z.number().int().optional().describe("Fiscal year (default: most recent)"),
+        }),
+        execute: async ({ state, fiscal_year }) => {
+            const result = await spendingByState({ state, fiscalYear: fiscal_year });
+            if ("detail" in result) {
+                const d = result.detail;
+                return JSON.stringify({
+                    summary: `Federal spending: ${d.name || state} — $${d.totalAwards.toLocaleString()} total, $${d.perCapita.toLocaleString()} per capita`,
+                    ...d,
+                });
+            }
+            const fy = fiscal_year || currentFiscalYear();
+            return JSON.stringify({
+                summary: `Federal spending by state FY ${fy}: ${result.states.length} states`,
+                fiscalYear: fy,
+                states: result.states,
+            });
+        },
+    },
+    {
+        name: "usa_spending_by_recipient",
+        description: "Get the top recipients (companies, organizations) of federal spending. " +
+            "Use state and agency filters to narrow results.",
+        annotations: { title: "USAspending: Top Recipients", readOnlyHint: true },
+        parameters: z.object({
+            fiscal_year: z.number().int().optional().describe("Fiscal year (default: current)"),
+            award_type: z.string().optional().describe("'contracts', 'grants', 'loans', 'direct_payments'"),
+            state: z.string().optional().describe("Two-letter state code, e.g. 'CA', 'TX'"),
+            agency: z.string().optional().describe("Awarding agency name, e.g. 'Department of Energy'"),
+            limit: z.number().int().positive().max(100).optional().describe("Number of recipients (default: 25)"),
+        }),
+        execute: async ({ fiscal_year, award_type, state, agency, limit }) => {
+            const fy = fiscal_year || currentFiscalYear();
+            const recipients = await topRecipients({ fiscalYear: fy, awardType: award_type, state, agency, limit });
+            const typeLabel = award_type ? ` (${award_type})` : "";
+            if (!recipients.length)
+                return JSON.stringify({ summary: `No recipient data for FY ${fy}${typeLabel}.`, fiscalYear: fy, recipients: [] });
+            return JSON.stringify({
+                summary: `Top federal spending recipients${typeLabel} FY ${fy}: ${recipients.length} recipients`,
+                fiscalYear: fy,
+                awardType: award_type || null,
+                recipients,
+            });
+        },
+    },
+    {
+        name: "usa_spending_over_time",
+        description: "Get federal spending aggregated by time period (monthly, quarterly, or fiscal year). " +
+            "Useful for identifying trends.",
+        annotations: { title: "USAspending: Spending Over Time", readOnlyHint: true },
+        parameters: z.object({
+            group: z.string().optional().describe("Time grouping: 'month' (default), 'quarter', or 'fiscal_year'"),
+            start_date: z.string().optional().describe("Start date YYYY-MM-DD (default: 3 years ago)"),
+            end_date: z.string().optional().describe("End date YYYY-MM-DD (default: today)"),
+            agency: z.string().optional().describe("Filter to specific agency name"),
+            award_type: z.string().optional().describe("'contracts', 'grants', 'loans', 'direct_payments'"),
+            state: z.string().optional().describe("Two-letter state code, e.g. 'CA', 'TX'"),
+            keyword: z.string().optional().describe("Keyword to filter spending"),
+        }),
+        execute: async ({ group, start_date, end_date, agency, award_type, state, keyword }) => {
+            const periods = await spendingOverTime({
+                group, startDate: start_date, endDate: end_date,
+                agency, awardType: award_type, state, keyword,
+            });
+            if (!periods.length)
+                return JSON.stringify({ summary: "No spending data found for the given period.", periods: [] });
+            return JSON.stringify({
+                summary: `Federal spending over time: ${periods.length} periods, grouped by ${group || "month"}`,
+                group: group || "month",
+                periods,
+            });
+        },
+    },
+    {
+        name: "usa_agency_overview",
+        description: "Get an overview of a federal agency's spending, including budgetary resources and obligations.\n\n" +
+            "Common codes: '097' (DOD), '075' (HHS), '069' (Treasury), '089' (DOE), " +
+            "'012' (USDA), '015' (Justice), '036' (VA), '070' (DHS), '080' (NASA)",
+        annotations: { title: "USAspending: Agency Overview", readOnlyHint: true },
+        parameters: z.object({
+            agency_code: z.string().describe("Toptier agency code. Common: '097' (DOD), '075' (HHS), '069' (Treasury), " +
+                "'089' (DOE), '036' (VA), '070' (DHS), '080' (NASA), '091' (Education), '016' (Labor)"),
+            fiscal_year: z.number().int().optional().describe("Fiscal year (default: current)"),
+        }),
+        execute: async ({ agency_code, fiscal_year }) => {
+            const data = await agencyOverview(agency_code, fiscal_year);
+            return JSON.stringify({
+                summary: `Agency: ${data.name || agency_code} — FY ${data.fiscalYear}`,
+                ...data,
+            });
+        },
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/usaspending.js";
+// ─── Prompts (FastMCP InputPrompt type) ──────────────────────────────
+export const prompts = [
+    {
+        name: "federal_spending_overview",
+        description: "Comprehensive overview of federal spending with connections to authorizing legislation and votes.",
+        load: async () => "Give me a comprehensive overview of federal spending using USAspending data.\n\n" +
+            "== SPENDING DATA ==\n" +
+            "1. **Top spending agencies** — use usa_spending_by_agency with limit=15\n" +
+            "2. **Top recipients** — use usa_spending_by_recipient for contracts, limit=15\n" +
+            "3. **Top states by spending** — use usa_spending_by_state\n" +
+            "4. **Spending trend** — use usa_spending_over_time with group=quarter for the last 2 years\n\n" +
+            "== LEGISLATIVE AUTHORIZATION ==\n" +
+            "5. Use congress_search_bills for 'appropriations' in the current congress to find the authorizing legislation\n" +
+            "6. Use congress_house_votes and congress_senate_votes to show how each party voted on the appropriations\n\n" +
+            "== CONTEXT ==\n" +
+            "7. Use census_population to calculate per-capita spending by state\n" +
+            "8. Use lobbying_search for top-spending agencies to find who lobbied for these programs\n\n" +
+            "Summarize the key findings: which agencies spend the most, which companies receive the most, " +
+            "which states get the most per capita, how each party voted on the budget, and whether spending is trending up or down.",
+    },
+];
+//# sourceMappingURL=usaspending.js.map

package/dist/modules/usaspending.js.map

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

package/dist/modules/usda-fooddata.d.ts

@@ -0,0 +1,24 @@
+/**
+ * USDA FoodData Central MCP module — search foods, get nutrition facts, compare nutrients.
+ */
+import type { Tool } from "fastmcp";
+export declare const name = "usda-fooddata";
+export declare const displayName = "USDA FoodData Central";
+export declare const description = "Nutritional data for 300K+ foods: calories, macros, vitamins, minerals. Covers branded products, standard reference foods, and survey foods.";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "fooddata_search to find foods \u2192 fooddata_detail for full nutrient breakdown";
+export declare const tips = "Data types: 'Foundation' (minimally processed), 'SR Legacy' (historical reference), 'Branded' (commercial products), 'Survey' (FNDDS dietary studies). Use Foundation or SR Legacy for generic foods, Branded for specific products.";
+export declare const reference: {
+    dataTypes: Record<string, string>;
+    docs: {
+        "API Guide": string;
+        "FoodData Central": string;
+        "Data Documentation": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { clearCache } from "../sdk/usda-fooddata.js";
+//# sourceMappingURL=usda-fooddata.d.ts.map

package/dist/modules/usda-fooddata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usda-fooddata.d.ts","sourceRoot":"","sources":["../../src/modules/usda-fooddata.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAKpC,eAAO,MAAM,IAAI,kBAAkB,CAAC;AACpC,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,WAAW,iJAAiJ,CAAC;AAC1K,eAAO,MAAM,IAAI;;;CAAyE,CAAC;AAC3F,eAAO,MAAM,QAAQ,qFAAgF,CAAC;AACtG,eAAO,MAAM,IAAI,yOAAyO,CAAC;AAE3P,eAAO,MAAM,SAAS;;;;;;;CAOrB,CAAC;AAWF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA4FjC,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/modules/usda-fooddata.js

@@ -0,0 +1,118 @@
+/**
+ * USDA FoodData Central MCP module — search foods, get nutrition facts, compare nutrients.
+ */
+import { z } from "zod";
+import { searchFoods, getFood, listFoods, DATA_TYPES } from "../sdk/usda-fooddata.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "usda-fooddata";
+export const displayName = "USDA FoodData Central";
+export const description = "Nutritional data for 300K+ foods: calories, macros, vitamins, minerals. Covers branded products, standard reference foods, and survey foods.";
+export const auth = { envVar: "DATA_GOV_API_KEY", signup: "https://api.data.gov/signup/" };
+export const workflow = "fooddata_search to find foods → fooddata_detail for full nutrient breakdown";
+export const tips = "Data types: 'Foundation' (minimally processed), 'SR Legacy' (historical reference), 'Branded' (commercial products), 'Survey' (FNDDS dietary studies). Use Foundation or SR Legacy for generic foods, Branded for specific products.";
+export const reference = {
+    dataTypes: DATA_TYPES,
+    docs: {
+        "API Guide": "https://fdc.nal.usda.gov/api-guide",
+        "FoodData Central": "https://fdc.nal.usda.gov/",
+        "Data Documentation": "https://fdc.nal.usda.gov/data-documentation",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function formatNutrient(n) {
+    const val = n.value ?? n.amount;
+    return val !== undefined ? `${n.nutrientName}: ${val} ${n.unitName || ""}`.trim() : null;
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "fooddata_search",
+        description: "Search the USDA FoodData Central database for foods by keyword.\n" +
+            "Returns matching foods with basic nutrient info. Covers 300K+ foods including branded products.\n\n" +
+            "Data types: 'Foundation' (generic whole foods), 'SR Legacy' (historical USDA reference), " +
+            "'Branded' (commercial products with UPC), 'Survey' (FNDDS dietary studies).",
+        annotations: { title: "USDA FoodData: Search Foods", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Food search term (e.g. 'chicken breast', 'cheddar cheese', 'apple')"),
+            dataType: z.array(z.string()).optional().describe("Filter by data type: ['Foundation'], ['Branded'], ['SR Legacy', 'Foundation']"),
+            brandOwner: z.string().optional().describe("Filter by brand owner for branded foods (e.g. 'Kraft', 'General Mills')"),
+            pageSize: z.number().int().max(200).optional().describe("Results per page (default 25, max 200)"),
+            pageNumber: z.number().int().optional().describe("Page number (1-based)"),
+            sortBy: z.string().optional().describe("Sort field: 'dataType.keyword', 'lowercaseDescription.keyword', 'fdcId', 'publishedDate'"),
+            sortOrder: z.string().optional().describe("'asc' or 'desc'"),
+        }),
+        execute: async (args) => {
+            const data = await searchFoods(args);
+            if (!data.foods?.length)
+                return `No foods found for '${args.query}'.`;
+            return JSON.stringify({
+                summary: `Found ${data.totalHits} foods matching '${args.query}', showing ${data.foods.length} (page ${data.currentPage} of ${data.totalPages})`,
+                total: data.totalHits,
+                foods: data.foods.map(f => ({
+                    fdcId: f.fdcId,
+                    description: f.description,
+                    dataType: f.dataType,
+                    brandOwner: f.brandOwner,
+                    brandName: f.brandName,
+                    ingredients: f.ingredients,
+                    servingSize: f.servingSize ? `${f.servingSize} ${f.servingSizeUnit || "g"}` : undefined,
+                    nutrients: f.foodNutrients?.slice(0, 15).map(formatNutrient).filter(Boolean),
+                })),
+            });
+        },
+    },
+    {
+        name: "fooddata_detail",
+        description: "Get complete nutritional details for a specific food by its FDC ID.\n" +
+            "Returns full nutrient breakdown: calories, protein, fat, carbs, vitamins, minerals, amino acids.\n" +
+            "Use fooddata_search first to find FDC IDs.",
+        annotations: { title: "USDA FoodData: Food Details", readOnlyHint: true },
+        parameters: z.object({
+            fdcId: z.number().int().describe("FoodData Central ID (get from fooddata_search results)"),
+        }),
+        execute: async ({ fdcId }) => {
+            const food = await getFood(fdcId);
+            return JSON.stringify({
+                fdcId: food.fdcId,
+                description: food.description,
+                dataType: food.dataType,
+                brandOwner: food.brandOwner,
+                brandName: food.brandName,
+                ingredients: food.ingredients,
+                servingSize: food.servingSize ? `${food.servingSize} ${food.servingSizeUnit || "g"}` : undefined,
+                category: food.foodCategory?.description,
+                published: food.publishedDate,
+                nutrients: food.foodNutrients?.map(formatNutrient).filter(Boolean),
+            });
+        },
+    },
+    {
+        name: "fooddata_list",
+        description: "Browse a paged list of foods from the USDA database.\n" +
+            "Useful for exploring available foods by data type without a specific search term.",
+        annotations: { title: "USDA FoodData: List Foods", readOnlyHint: true },
+        parameters: z.object({
+            dataType: z.array(z.string()).optional().describe("Filter by data type: ['Foundation'], ['Branded'], ['SR Legacy']"),
+            pageSize: z.number().int().max(200).optional().describe("Results per page (default 25, max 200)"),
+            pageNumber: z.number().int().optional().describe("Page number (1-based)"),
+            sortBy: z.string().optional().describe("Sort field: 'dataType.keyword', 'lowercaseDescription.keyword', 'fdcId', 'publishedDate'"),
+            sortOrder: z.string().optional().describe("'asc' or 'desc'"),
+        }),
+        execute: async (args) => {
+            const data = await listFoods(args);
+            if (!data?.length)
+                return "No foods found.";
+            return JSON.stringify({
+                summary: `Returned ${data.length} foods${args.dataType ? ` (${args.dataType.join(", ")})` : ""}`,
+                foods: data.map(f => ({
+                    fdcId: f.fdcId,
+                    description: f.description,
+                    dataType: f.dataType,
+                    published: f.publishedDate,
+                })),
+            });
+        },
+    },
+];
+export { clearCache } from "../sdk/usda-fooddata.js";
+//# sourceMappingURL=usda-fooddata.js.map

package/dist/modules/usda-fooddata.js.map

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

package/dist/modules/usda-nass.d.ts

@@ -0,0 +1,46 @@
+/**
+ * USDA NASS MCP module — agricultural production, crop prices, farm income.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "usda-nass";
+export declare const displayName = "USDA NASS QuickStats";
+export declare const description = "Agricultural production, crop prices, farm income, livestock, Census of Agriculture data";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "usda_crop_data or usda_livestock for specific commodities, usda_prices for price trends, usda_ag_query for custom queries";
+export declare const tips = "Commodities: CORN, SOYBEANS, WHEAT, COTTON, CATTLE, HOGS, MILK. States: IA, IL, TX, CA, NE";
+export declare const reference: {
+    topCommodities: {
+        CORN: string;
+        SOYBEANS: string;
+        WHEAT: string;
+        COTTON: string;
+        RICE: string;
+        SORGHUM: string;
+        CATTLE: string;
+        HOGS: string;
+        MILK: string;
+        CHICKENS: string;
+        EGGS: string;
+    };
+    categories: {
+        "AREA PLANTED": string;
+        "AREA HARVESTED": string;
+        PRODUCTION: string;
+        YIELD: string;
+        "PRICE RECEIVED": string;
+        INVENTORY: string;
+        SALES: string;
+    };
+    docs: {
+        "API Docs": string;
+        "Get Key": string;
+        "QuickStats UI": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/usda-nass.js";
+//# sourceMappingURL=usda-nass.d.ts.map

package/dist/modules/usda-nass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usda-nass.d.ts","sourceRoot":"","sources":["../../src/modules/usda-nass.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKjD,eAAO,MAAM,IAAI,cAAc,CAAC;AAChC,eAAO,MAAM,WAAW,yBAAyB,CAAC;AAClD,eAAO,MAAM,WAAW,6FAA6F,CAAC;AACtH,eAAO,MAAM,IAAI;;;CAAkF,CAAC;AACpG,eAAO,MAAM,QAAQ,8HAA8H,CAAC;AACpJ,eAAO,MAAM,IAAI,+FAA+F,CAAC;AAEjH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkBrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAqGjC,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAa1C,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/modules/usda-nass.js

@@ -0,0 +1,151 @@
+/**
+ * USDA NASS MCP module — agricultural production, crop prices, farm income.
+ */
+import { z } from "zod";
+import { queryStats, getCropProduction, getLivestockData, getPriceReceived } from "../sdk/usda-nass.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "usda-nass";
+export const displayName = "USDA NASS QuickStats";
+export const description = "Agricultural production, crop prices, farm income, livestock, Census of Agriculture data";
+export const auth = { envVar: "USDA_NASS_API_KEY", signup: "https://quickstats.nass.usda.gov/api" };
+export const workflow = "usda_crop_data or usda_livestock for specific commodities, usda_prices for price trends, usda_ag_query for custom queries";
+export const tips = "Commodities: CORN, SOYBEANS, WHEAT, COTTON, CATTLE, HOGS, MILK. States: IA, IL, TX, CA, NE";
+export const reference = {
+    topCommodities: {
+        CORN: "Corn (grain, silage)", SOYBEANS: "Soybeans", WHEAT: "Wheat (winter, spring, durum)",
+        COTTON: "Cotton (upland, pima)", RICE: "Rice", SORGHUM: "Sorghum",
+        CATTLE: "Cattle (incl. calves)", HOGS: "Hogs", MILK: "Milk (dairy)",
+        CHICKENS: "Chickens (broilers, layers)", EGGS: "Eggs",
+    },
+    categories: {
+        "AREA PLANTED": "Acres planted", "AREA HARVESTED": "Acres harvested",
+        PRODUCTION: "Total production (bushels, tons, etc.)", YIELD: "Yield per acre",
+        "PRICE RECEIVED": "Price received by farmers ($/unit)", INVENTORY: "Livestock inventory (head)",
+        "SALES": "Cash receipts from sales",
+    },
+    docs: {
+        "API Docs": "https://quickstats.nass.usda.gov/api",
+        "Get Key": "https://quickstats.nass.usda.gov/api#param_define",
+        "QuickStats UI": "https://quickstats.nass.usda.gov/",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "usda_crop_data",
+        description: "Get crop production data — area planted, harvested, production, yield.\nCommodities: CORN, SOYBEANS, WHEAT, COTTON, RICE, SORGHUM",
+        annotations: { title: "USDA: Crop Data", readOnlyHint: true },
+        parameters: z.object({
+            commodity: z.string().describe("Crop name: CORN, SOYBEANS, WHEAT, COTTON, RICE"),
+            state: z.string().optional().describe("State code: IA, IL, CA, TX. Omit for national"),
+            year: z.number().int().optional().describe("Year (omit for all recent years)"),
+            category: z.string().optional().describe("PRODUCTION (default), AREA PLANTED, AREA HARVESTED, YIELD"),
+        }),
+        execute: async ({ commodity, state, year, category }) => {
+            const data = await getCropProduction(commodity, { state, year, category });
+            if (!data.length)
+                return `No crop data found for ${commodity}${state ? ` in ${state}` : ""}.`;
+            const recent = data.slice(0, 50);
+            return JSON.stringify({
+                summary: `${commodity.toUpperCase()} ${category ?? "PRODUCTION"}: ${recent.length} records${state ? ` for ${state}` : " (national)"}`,
+                records: recent.map(r => ({
+                    year: r.year, state: r.state_alpha, value: r.Value, unit: r.unit_desc,
+                    description: r.short_desc, period: r.reference_period_desc,
+                })),
+            });
+        },
+    },
+    {
+        name: "usda_livestock",
+        description: "Get livestock data — inventory, slaughter, production.\nCommodities: CATTLE, HOGS, CHICKENS, MILK, EGGS",
+        annotations: { title: "USDA: Livestock", readOnlyHint: true },
+        parameters: z.object({
+            commodity: z.string().describe("CATTLE, HOGS, CHICKENS, MILK, EGGS"),
+            state: z.string().optional().describe("State code. Omit for national"),
+            year: z.number().int().optional().describe("Year"),
+            category: z.string().optional().describe("INVENTORY, PRODUCTION, SALES"),
+        }),
+        execute: async ({ commodity, state, year, category }) => {
+            const data = await getLivestockData(commodity, { state, year, category });
+            if (!data.length)
+                return `No livestock data for ${commodity}${state ? ` in ${state}` : ""}.`;
+            const recent = data.slice(0, 50);
+            return JSON.stringify({
+                summary: `${commodity.toUpperCase()}: ${recent.length} records${state ? ` for ${state}` : " (national)"}`,
+                records: recent.map(r => ({
+                    year: r.year, state: r.state_alpha, value: r.Value, unit: r.unit_desc,
+                    description: r.short_desc, period: r.reference_period_desc,
+                })),
+            });
+        },
+    },
+    {
+        name: "usda_prices",
+        description: "Get prices received by farmers for agricultural commodities.\nWorks for any commodity: CORN, WHEAT, SOYBEANS, CATTLE, MILK, etc.",
+        annotations: { title: "USDA: Prices Received", readOnlyHint: true },
+        parameters: z.object({
+            commodity: z.string().describe("Any commodity: CORN, WHEAT, SOYBEANS, CATTLE, HOGS, MILK"),
+            state: z.string().optional().describe("State code. Omit for national average"),
+            year: z.number().int().optional().describe("Year"),
+        }),
+        execute: async ({ commodity, state, year }) => {
+            const data = await getPriceReceived(commodity, { state, year });
+            if (!data.length)
+                return `No price data for ${commodity}${state ? ` in ${state}` : ""}.`;
+            const recent = data.slice(0, 50);
+            return JSON.stringify({
+                summary: `${commodity.toUpperCase()} prices: ${recent.length} records${state ? ` for ${state}` : " (national)"}`,
+                records: recent.map(r => ({
+                    year: r.year, state: r.state_alpha, value: r.Value, unit: r.unit_desc,
+                    description: r.short_desc, period: r.reference_period_desc,
+                })),
+            });
+        },
+    },
+    {
+        name: "usda_ag_query",
+        description: "Custom query to USDA NASS QuickStats — any combination of filters.\nMax 50,000 records. Use usda_ag_count first for large queries.",
+        annotations: { title: "USDA: Custom Query", readOnlyHint: true },
+        parameters: z.object({
+            commodity_desc: z.string().optional().describe("Commodity: CORN, WHEAT, CATTLE, etc."),
+            source_desc: z.string().optional().describe("SURVEY or CENSUS"),
+            sector_desc: z.string().optional().describe("CROPS, ANIMALS & PRODUCTS, ECONOMICS, ENVIRONMENTAL"),
+            statisticcat_desc: z.string().optional().describe("AREA PLANTED, PRODUCTION, YIELD, PRICE RECEIVED, INVENTORY"),
+            state_alpha: z.string().optional().describe("State code: IA, IL, CA or US for national"),
+            year: z.number().int().optional().describe("Year"),
+            agg_level_desc: z.string().optional().describe("NATIONAL, STATE, COUNTY"),
+            freq_desc: z.string().optional().describe("ANNUAL, MONTHLY, WEEKLY"),
+        }),
+        execute: async (params) => {
+            const data = await queryStats(params);
+            if (!data.length)
+                return "No records found for this query.";
+            const recent = data.slice(0, 100);
+            return JSON.stringify({
+                summary: `${data.length} records returned (showing ${recent.length})`,
+                totalRecords: data.length,
+                records: recent.map(r => ({
+                    year: r.year, state: r.state_alpha, commodity: r.commodity_desc,
+                    category: r.statisticcat_desc, value: r.Value, unit: r.unit_desc,
+                    description: r.short_desc,
+                })),
+            });
+        },
+    },
+];
+export const prompts = [
+    {
+        name: "farm_economy",
+        description: "Overview of U.S. agricultural production, prices, and trends.",
+        load: async () => "Build a farm economy overview:\n\n" +
+            "1. Use usda_crop_data for CORN, SOYBEANS, WHEAT — production for last 3 years (national)\n" +
+            "2. Use usda_prices for CORN, SOYBEANS, WHEAT — price trends\n" +
+            "3. Use usda_livestock for CATTLE and HOGS — inventory trends\n" +
+            "4. Use bls_cpi_breakdown to show food price inflation\n" +
+            "5. Use usa_spending_by_agency to show USDA spending\n\n" +
+            "Connect the dots: are crop prices rising or falling? How does that correlate with consumer food prices (CPI food component)?",
+    },
+];
+// ─── Re-export cache control ─────────────────────────────────────────
+export { clearCache } from "../sdk/usda-nass.js";
+//# sourceMappingURL=usda-nass.js.map

package/dist/modules/usda-nass.js.map

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

package/dist/modules/usgs.d.ts

@@ -0,0 +1,21 @@
+/**
+ * USGS module — earthquake data and water resources monitoring.
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/usgs.js";
+export declare const name = "usgs";
+export declare const displayName = "USGS (U.S. Geological Survey)";
+export declare 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 declare const workflow = "Use usgs_earthquakes to search for earthquakes by magnitude/location/date \u2192 usgs_significant for recent notable events \u2192 usgs_water_data for streamflow and water levels at monitoring sites \u2192 usgs_water_sites to find stations.";
+export declare 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 declare const reference: {
+    waterParams: Record<string, string>;
+    alertLevels: Record<string, string>;
+    docs: {
+        "Earthquake API": string;
+        "Water Services": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=usgs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usgs.d.ts","sourceRoot":"","sources":["../../src/modules/usgs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EASL,UAAU,IAAI,aAAa,EAE5B,MAAM,gBAAgB,CAAC;AAIxB,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,WAAW,kCAAkC,CAAC;AAC3D,eAAO,MAAM,WAAW,+LACsK,CAAC;AAC/L,eAAO,MAAM,QAAQ,qPACgN,CAAC;AACtO,eAAO,MAAM,IAAI,4NAC0M,CAAC;AAE5N,eAAO,MAAM,SAAS;;;;;;;CAOrB,CAAC;AA0BF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAsKjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}