us-gov-open-data-mcp 1.0.0

package/dist/modules/federal-register.js

@@ -0,0 +1,184 @@
+/**
+ * Federal Register MCP module — tools + metadata.
+ * Delegates all API calls to sdk/federal-register.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import { z } from "zod";
+import { searchExecutiveOrders, searchPresidentialDocuments, searchRules, getDocumentDetail, listAgencies, } from "../sdk/federal-register.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "federal-register";
+export const displayName = "Federal Register";
+export const description = "Executive orders, presidential documents, rules, agency notices";
+export const workflow = "fr_executive_orders or fr_search_rules → review results";
+export const tips = "Use president slugs: 'donald-trump', 'joe-biden', 'barack-obama', 'george-w-bush', 'william-j-clinton'. " +
+    "No API key required.";
+export const reference = {
+    presidentSlugs: {
+        trump: "donald-trump",
+        biden: "joe-biden",
+        obama: "barack-obama",
+        bush: "george-w-bush",
+        clinton: "william-j-clinton",
+    },
+    documentTypes: {
+        RULE: "Rule — final rule published in CFR",
+        PRORULE: "Proposed Rule — notice of proposed rulemaking",
+        NOTICE: "Notice — agency announcement",
+        PRESDOCU: "Presidential Document — EOs, memoranda, proclamations",
+    },
+    presidentialDocTypes: {
+        executive_order: "Executive Order",
+        determination: "Presidential Determination",
+        executive_memorandum: "Presidential Memorandum",
+        proclamation: "Proclamation",
+        notice: "Notice",
+    },
+    docs: {
+        "API Docs": "https://www.federalregister.gov/developers/documentation/api/v1",
+        "Developer Hub": "https://www.federalregister.gov/developers",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeDoc(d) {
+    return {
+        title: d.title,
+        type: d.type,
+        subtype: d.subtype ?? d.presidential_document_type_id ?? null,
+        documentNumber: d.document_number,
+        executiveOrderNumber: d.executive_order_number ?? null,
+        publicationDate: d.publication_date,
+        signingDate: d.signing_date ?? null,
+        president: d.president?.name ?? null,
+        abstract: d.abstract ?? null,
+        htmlUrl: d.html_url,
+        agencies: d.agencies?.map(a => a.name ?? a.raw_name).filter(Boolean) ?? [],
+    };
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "fr_executive_orders",
+        description: "Search for presidential executive orders. Filter by president, year, or keyword. " +
+            "Covers all executive orders since 1994.",
+        annotations: { title: "Federal Register: Executive Orders", readOnlyHint: true },
+        parameters: z.object({
+            keyword: z.string().optional().describe("Search keyword in title/abstract, e.g. 'tariff', 'immigration', 'climate'"),
+            president: z.string().optional().describe("President slug: 'donald-trump', 'joe-biden', 'barack-obama', 'george-w-bush', 'william-j-clinton'"),
+            year: z.number().int().optional().describe("Year to filter by, e.g. 2025"),
+            per_page: z.number().int().positive().max(100).optional().describe("Results per page (default: 20)"),
+            page: z.number().int().positive().optional().describe("Page number (default: 1)"),
+        }),
+        execute: async ({ keyword, president, year, per_page, page }) => {
+            const data = await searchExecutiveOrders({ keyword, president, year, per_page, page });
+            const results = data.results ?? [];
+            if (!results.length)
+                return JSON.stringify({ summary: "No executive orders found.", count: 0, results: [] });
+            return JSON.stringify({
+                summary: `Executive orders: ${data.count} total, showing ${results.length}`,
+                count: data.count,
+                totalPages: data.total_pages,
+                results: results.map(summarizeDoc),
+            });
+        },
+    },
+    {
+        name: "fr_presidential_documents",
+        description: "Search all presidential documents: executive orders, memoranda, proclamations, and other presidential actions.",
+        annotations: { title: "Federal Register: Presidential Documents", readOnlyHint: true },
+        parameters: z.object({
+            keyword: z.string().optional().describe("Search keyword"),
+            doc_type: z.string().optional().describe("Document subtype: 'executive_order', 'memorandum', 'proclamation', 'notice', 'determination'. Omit for all."),
+            president: z.string().optional().describe("President slug: 'donald-trump', 'joe-biden', 'barack-obama'"),
+            start_date: z.string().optional().describe("Start date YYYY-MM-DD"),
+            end_date: z.string().optional().describe("End date YYYY-MM-DD"),
+            per_page: z.number().int().positive().max(100).optional().describe("Results per page (default: 20)"),
+        }),
+        execute: async ({ keyword, doc_type, president, start_date, end_date, per_page }) => {
+            const data = await searchPresidentialDocuments({ keyword, doc_type, president, start_date, end_date, per_page });
+            const results = data.results ?? [];
+            if (!results.length)
+                return JSON.stringify({ summary: "No presidential documents found.", count: 0, results: [] });
+            return JSON.stringify({
+                summary: `Presidential documents: ${data.count} total, showing ${results.length}`,
+                count: data.count,
+                totalPages: data.total_pages,
+                results: results.map(summarizeDoc),
+            });
+        },
+    },
+    {
+        name: "fr_search_rules",
+        description: "Search for proposed rules, final rules, and agency notices in the Federal Register. " +
+            "Use to track regulatory activity by agencies.",
+        annotations: { title: "Federal Register: Search Rules & Regulations", readOnlyHint: true },
+        parameters: z.object({
+            keyword: z.string().optional().describe("Search keyword, e.g. 'tariff', 'emissions', 'banking'"),
+            doc_type: z.string().optional().describe("'RULE' (final rules), 'PRORULE' (proposed rules), 'NOTICE' (notices). Omit for all."),
+            agency: z.string().optional().describe("Agency slug, e.g. 'environmental-protection-agency', 'securities-and-exchange-commission'"),
+            start_date: z.string().optional().describe("Start date YYYY-MM-DD"),
+            end_date: z.string().optional().describe("End date YYYY-MM-DD"),
+            per_page: z.number().int().positive().max(100).optional().describe("Results per page (default: 20)"),
+            significant: z.boolean().optional().describe("Only show significant/major rules (true/false)"),
+        }),
+        execute: async ({ keyword, doc_type, agency, start_date, end_date, per_page, significant }) => {
+            const data = await searchRules({ keyword, doc_type, agency, start_date, end_date, per_page, significant });
+            const results = data.results ?? [];
+            if (!results.length)
+                return JSON.stringify({ summary: "No rules/notices found.", count: 0, results: [] });
+            return JSON.stringify({
+                summary: `Federal Register documents: ${data.count} total, showing ${results.length}`,
+                count: data.count,
+                totalPages: data.total_pages,
+                results: results.map(summarizeDoc),
+            });
+        },
+    },
+    {
+        name: "fr_document_detail",
+        description: "Get full details for a specific Federal Register document by document number.\n" +
+            "Returns title, abstract, full text URL, agencies, CFR references, and more.",
+        annotations: { title: "Federal Register: Document Detail", readOnlyHint: true },
+        parameters: z.object({
+            document_number: z.string().describe("Federal Register document number: '2024-00001'"),
+        }),
+        execute: async ({ document_number }) => {
+            const doc = await getDocumentDetail(document_number);
+            if (!doc)
+                return JSON.stringify({ error: "Document not found." });
+            return JSON.stringify({
+                title: doc.title,
+                type: doc.type,
+                documentNumber: doc.document_number,
+                publicationDate: doc.publication_date,
+                agencies: doc.agencies?.map((a) => a.name),
+                abstract: doc.abstract,
+                htmlUrl: doc.html_url,
+                pdfUrl: doc.pdf_url,
+                citation: doc.citation,
+                signingDate: doc.signing_date,
+                executiveOrderNumber: doc.executive_order_number,
+            });
+        },
+    },
+    {
+        name: "fr_agencies",
+        description: "List all federal agencies that publish in the Federal Register.\n" +
+            "Returns agency names, short names, slugs (for filtering), and URLs. 470+ agencies.",
+        annotations: { title: "Federal Register: Agencies", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const agencies = await listAgencies();
+            if (!agencies?.length)
+                return "No agencies returned.";
+            const top = agencies.filter((a) => !a.parent_id).slice(0, 50);
+            return JSON.stringify({
+                summary: `${agencies.length} total agencies (showing ${top.length} top-level)`,
+                agencies: top.map((a) => ({ name: a.name, shortName: a.short_name, slug: a.slug })),
+            });
+        },
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/federal-register.js";
+//# sourceMappingURL=federal-register.js.map

package/dist/modules/federal-register.js.map

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

package/dist/modules/fema.d.ts

@@ -0,0 +1,20 @@
+/**
+ * FEMA module — OpenFEMA disaster declarations, housing assistance, NFIP claims, public assistance
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/fema.js";
+export declare const name = "fema";
+export declare const displayName = "FEMA";
+export declare const description = "Federal Emergency Management Agency \u2014 disaster declarations, emergency/major disaster assistance, NFIP flood insurance claims, housing assistance, public assistance grants. Data since 1953.";
+export declare const workflow = "Use fema_disaster_declarations to find disasters by state/year/type \u2192 fema_housing_assistance for individual assistance details \u2192 fema_public_assistance for PA grants \u2192 fema_query for NFIP claims or any other dataset.";
+export declare const tips = "State codes are two-letter uppercase (TX, FL, CA). Incident types include Hurricane, Flood, Fire, Severe Storm(s), Tornado, Earthquake, Snow, Biological. Declaration types: DR (Major Disaster), EM (Emergency), FM (Fire Management). Use fema_query with dataset 'nfip_claims' to analyze flood insurance data.";
+export declare const reference: {
+    datasets: Record<string, {
+        endpoint: string;
+        name: string;
+        description: string;
+    }>;
+};
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=fema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fema.d.ts","sourceRoot":"","sources":["../../src/modules/fema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAML,UAAU,IAAI,aAAa,EAK5B,MAAM,gBAAgB,CAAC;AAIxB,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,WAAW,SAAS,CAAC;AAClC,eAAO,MAAM,WAAW,uMACyK,CAAC;AAClM,eAAO,MAAM,QAAQ,6OACwM,CAAC;AAC9N,eAAO,MAAM,IAAI,uTACqS,CAAC;AACvT,eAAO,MAAM,SAAS;;;;;;CAAyB,CAAC;AAkChD,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAoHjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/fema.js

@@ -0,0 +1,156 @@
+/**
+ * FEMA module — OpenFEMA disaster declarations, housing assistance, NFIP claims, public assistance
+ */
+import { z } from "zod";
+import { getDisasterDeclarations, getHousingAssistance, getPublicAssistance, getFemaRegions, queryDataset, clearCache as sdkClearCache, DATASETS, } from "../sdk/fema.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "fema";
+export const displayName = "FEMA";
+export const description = "Federal Emergency Management Agency — disaster declarations, emergency/major disaster assistance, NFIP flood insurance claims, housing assistance, public assistance grants. Data since 1953.";
+export const workflow = "Use fema_disaster_declarations to find disasters by state/year/type → fema_housing_assistance for individual assistance details → fema_public_assistance for PA grants → fema_query for NFIP claims or any other dataset.";
+export const tips = "State codes are two-letter uppercase (TX, FL, CA). Incident types include Hurricane, Flood, Fire, Severe Storm(s), Tornado, Earthquake, Snow, Biological. Declaration types: DR (Major Disaster), EM (Emergency), FM (Fire Management). Use fema_query with dataset 'nfip_claims' to analyze flood insurance data.";
+export const reference = { datasets: DATASETS };
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeDisasters(data) {
+    if (!data.length)
+        return "No disaster declarations found.";
+    const lines = data.map((d) => {
+        const date = d.declarationDate ? d.declarationDate.slice(0, 10) : "unknown date";
+        return `[${d.disasterNumber ?? "?"}] ${date} — ${d.disasterName ?? "Unnamed"} (${d.incidentType ?? "?"}) — ${d.state ?? "?"}, ${d.designatedArea ?? ""} [${d.declarationType ?? "?"}]`;
+    });
+    return `${data.length} disaster declaration(s):\n${lines.join("\n")}`;
+}
+function summarizeHousing(data) {
+    if (!data.length)
+        return "No housing assistance records found.";
+    const lines = data.map((d) => {
+        const loc = [d.county, d.state, d.zipCode].filter(Boolean).join(", ");
+        const amt = d.totalApprovedIhpAmount != null ? `$${d.totalApprovedIhpAmount.toLocaleString()}` : "N/A";
+        return `Disaster ${d.disasterNumber ?? "?"} — ${loc} — Total IHP: ${amt}, Registrations: ${d.validRegistrations ?? "?"}, Inspected: ${d.totalInspected ?? "?"}`;
+    });
+    return `${data.length} housing assistance record(s):\n${lines.join("\n")}`;
+}
+function summarizePA(data) {
+    if (!data.length)
+        return "No public assistance records found.";
+    const lines = data.map((d) => {
+        const amt = d.federalShareObligated != null ? `$${d.federalShareObligated.toLocaleString()}` : "N/A";
+        return `Disaster ${d.disasterNumber ?? "?"} — ${d.applicantName ?? "?"} (${d.state ?? "?"}) — ${d.damageCategory ?? "?"}: Federal Share ${amt}`;
+    });
+    return `${data.length} public assistance record(s):\n${lines.join("\n")}`;
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "fema_disaster_declarations",
+        description: "Search FEMA disaster declarations (since 1953). Filter by state, year, incident type, or declaration type. Returns disaster name, type, affected area, programs declared.",
+        annotations: { title: "FEMA Disaster Declarations", readOnlyHint: true },
+        parameters: z.object({
+            state: z.string().max(2).optional().describe("Two-letter state code (e.g. TX, FL, CA)"),
+            year: z.number().optional().describe("Filter by year of declaration"),
+            incident_type: z.string().optional().describe("Incident type: Hurricane, Flood, Fire, Severe Storm(s), Tornado, Earthquake, Snow, Biological"),
+            declaration_type: z.string().optional().describe("DR=Major Disaster, EM=Emergency, FM=Fire Management"),
+            top: z.number().optional().describe("Max results (default 50)"),
+            skip: z.number().optional().describe("Number of records to skip for pagination"),
+        }),
+        execute: async (args) => {
+            const data = await getDisasterDeclarations({
+                state: args.state,
+                year: args.year,
+                incidentType: args.incident_type,
+                declarationType: args.declaration_type,
+                top: args.top,
+                skip: args.skip,
+            });
+            return { content: [{ type: "text", text: summarizeDisasters(data) }] };
+        },
+    },
+    {
+        name: "fema_housing_assistance",
+        description: "Get FEMA Individual Housing Program (IHP) assistance data for homeowners. Shows approved assistance amounts, inspections, and damage by county/zip for a disaster.",
+        annotations: { title: "FEMA Housing Assistance", readOnlyHint: true },
+        parameters: z.object({
+            disaster_number: z.number().optional().describe("FEMA disaster number (from disaster declarations)"),
+            state: z.string().max(2).optional().describe("Two-letter state code"),
+            county: z.string().optional().describe("County name"),
+            top: z.number().optional().describe("Max results (default 50)"),
+            skip: z.number().optional().describe("Number of records to skip"),
+        }),
+        execute: async (args) => {
+            const data = await getHousingAssistance({
+                disasterNumber: args.disaster_number,
+                state: args.state,
+                county: args.county,
+                top: args.top,
+                skip: args.skip,
+            });
+            return { content: [{ type: "text", text: summarizeHousing(data) }] };
+        },
+    },
+    {
+        name: "fema_public_assistance",
+        description: "Get FEMA Public Assistance (PA) grant awards. Shows project-level grants to state/local/tribal governments and nonprofits for debris removal, emergency work, and permanent repair.",
+        annotations: { title: "FEMA Public Assistance", readOnlyHint: true },
+        parameters: z.object({
+            disaster_number: z.number().optional().describe("FEMA disaster number"),
+            state: z.string().max(2).optional().describe("Two-letter state code"),
+            top: z.number().optional().describe("Max results (default 50)"),
+            skip: z.number().optional().describe("Number of records to skip"),
+        }),
+        execute: async (args) => {
+            const data = await getPublicAssistance({
+                disasterNumber: args.disaster_number,
+                state: args.state,
+                top: args.top,
+                skip: args.skip,
+            });
+            return { content: [{ type: "text", text: summarizePA(data) }] };
+        },
+    },
+    {
+        name: "fema_regions",
+        description: "Get FEMA region boundaries and associated states. 10 FEMA regions cover all U.S. states and territories.",
+        annotations: { title: "FEMA Regions", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const data = await getFemaRegions();
+            if (!data.length)
+                return { content: [{ type: "text", text: "No FEMA region data found." }] };
+            const lines = data.map((r) => `Region ${r.regionNumber}: ${r.regionName ?? ""} — ${r.states ?? ""}`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        },
+    },
+    {
+        name: "fema_query",
+        description: "General-purpose query against any OpenFEMA v2 dataset. Use this for NFIP flood insurance claims/policies, hazard mitigation grants, mission assignments, IHP registrations, etc. Supports OData $filter syntax.",
+        annotations: { title: "FEMA Query", readOnlyHint: true },
+        parameters: z.object({
+            dataset: z
+                .string()
+                .describe("Dataset key (disaster_declarations, housing_owners, housing_renters, public_assistance, nfip_claims, nfip_policies, hazard_mitigation, mission_assignments, fema_regions, registrations) or raw endpoint name"),
+            filter: z.string().optional().describe("OData $filter expression (e.g. \"state eq 'TX' and yearOfLoss eq '2017'\")"),
+            select: z.string().optional().describe("Comma-separated fields to return (OData $select)"),
+            order_by: z.string().optional().describe("OData $orderby expression (e.g. 'dateOfLoss desc')"),
+            top: z.number().optional().describe("Max results (default 50)"),
+            skip: z.number().optional().describe("Offset for pagination"),
+        }),
+        execute: async (args) => {
+            const data = await queryDataset({
+                dataset: args.dataset,
+                filter: args.filter,
+                select: args.select,
+                orderBy: args.order_by,
+                top: args.top,
+                skip: args.skip,
+            });
+            if (!data.length)
+                return { content: [{ type: "text", text: "No records found for the given query." }] };
+            const preview = data.slice(0, 10);
+            const text = `${data.length} record(s) returned${data.length > 10 ? " (showing first 10)" : ""}:\n` +
+                preview.map((r, i) => `[${i + 1}] ${JSON.stringify(r)}`).join("\n");
+            return { content: [{ type: "text", text }] };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=fema.js.map

package/dist/modules/fema.js.map

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

package/dist/modules/fred.d.ts

@@ -0,0 +1,40 @@
+/**
+ * FRED MCP module — tools + metadata. Delegates all API calls to sdk/fred.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "fred";
+export declare const displayName = "FRED (Federal Reserve Economic Data)";
+export declare const description = "800K+ economic time series: GDP, CPI, unemployment, interest rates, money supply, housing";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "fred_search \u2192 fred_series_data to get values";
+export declare const tips = "Popular: GDP, UNRATE, CPIAUCSL, FEDFUNDS, DGS10, MORTGAGE30US, M2SL, SP500";
+export declare const reference: {
+    popularSeries: {
+        GDP: string;
+        UNRATE: string;
+        CPIAUCSL: string;
+        FEDFUNDS: string;
+        DGS10: string;
+        MORTGAGE30US: string;
+        M2SL: string;
+        SP500: string;
+        PAYEMS: string;
+        CIVPART: string;
+        MSPUS: string;
+        MEHOINUSA672N: string;
+    };
+    docs: {
+        "v1 API": string;
+        "v2 API": string;
+        "Get Key": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { clearCache } from "../sdk/fred.js";
+export declare const prompts: InputPrompt<any, any>[];
+//# sourceMappingURL=fred.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fred.d.ts","sourceRoot":"","sources":["../../src/modules/fred.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAKjD,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,WAAW,yCAAyC,CAAC;AAClE,eAAO,MAAM,WAAW,8FAA8F,CAAC;AACvH,eAAO,MAAM,IAAI;;;CAAmF,CAAC;AACrG,eAAO,MAAM,QAAQ,sDAAiD,CAAC;AACvE,eAAO,MAAM,IAAI,+EAA+E,CAAC;AAEjG,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;CAcrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAsFjC,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAsB1C,CAAC"}

package/dist/modules/fred.js

@@ -0,0 +1,143 @@
+/**
+ * FRED MCP module — tools + metadata. Delegates all API calls to sdk/fred.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import { z } from "zod";
+import { searchSeries, getSeriesInfo, getObservations, getReleaseData } from "../sdk/fred.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "fred";
+export const displayName = "FRED (Federal Reserve Economic Data)";
+export const description = "800K+ economic time series: GDP, CPI, unemployment, interest rates, money supply, housing";
+export const auth = { envVar: "FRED_API_KEY", signup: "https://fredaccount.stlouisfed.org/apikeys" };
+export const workflow = "fred_search → fred_series_data to get values";
+export const tips = "Popular: GDP, UNRATE, CPIAUCSL, FEDFUNDS, DGS10, MORTGAGE30US, M2SL, SP500";
+export const reference = {
+    popularSeries: {
+        GDP: "Gross Domestic Product (quarterly, $B)", UNRATE: "Unemployment Rate (monthly, %)",
+        CPIAUCSL: "CPI All Urban Consumers (monthly)", FEDFUNDS: "Fed Funds Rate (monthly, %)",
+        DGS10: "10-Year Treasury (daily, %)", MORTGAGE30US: "30-Year Mortgage (weekly, %)",
+        M2SL: "M2 Money Stock (monthly, $B)", SP500: "S&P 500 (daily)",
+        PAYEMS: "Nonfarm Payrolls (monthly, K)", CIVPART: "Labor Participation (monthly, %)",
+        MSPUS: "Median Home Price (quarterly, $)", MEHOINUSA672N: "Median Household Income (annual)",
+    },
+    docs: {
+        "v1 API": "https://fred.stlouisfed.org/docs/api/fred/",
+        "v2 API": "https://research.stlouisfed.org/docs/api/fred/v2/",
+        "Get Key": "https://fredaccount.stlouisfed.org/apikeys",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "fred_search",
+        description: "Search FRED series by keyword.\nExamples: 'GDP', 'unemployment', 'CPI', 'mortgage rate'",
+        annotations: { title: "FRED: Search", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Keywords"),
+            limit: z.number().int().max(100).optional().describe("Max results (default 20)"),
+        }),
+        execute: async ({ query, limit }) => {
+            const data = await searchSeries(query, limit ?? 20);
+            if (!data.seriess?.length)
+                return `No series found for "${query}".`;
+            return JSON.stringify({
+                summary: `FRED search "${query}": ${data.count} total, showing ${data.seriess.length}`,
+                total: data.count,
+                series: data.seriess,
+            });
+        },
+    },
+    {
+        name: "fred_series_info",
+        description: "Get metadata for a FRED series — title, units, frequency, range, notes.",
+        annotations: { title: "FRED: Series Info", readOnlyHint: true },
+        parameters: z.object({
+            series_id: z.string().describe("e.g. 'GDP', 'UNRATE', 'CPIAUCSL'"),
+        }),
+        execute: async ({ series_id }) => {
+            const s = await getSeriesInfo(series_id);
+            if (!s)
+                return `"${series_id}" not found.`;
+            return JSON.stringify({
+                summary: `${s.id}: ${s.title} (${s.frequency}, ${s.units}, ${s.observation_start}–${s.observation_end})`,
+                ...s,
+            });
+        },
+    },
+    {
+        name: "fred_series_data",
+        description: "Get observations for a FRED series.\nPopular: GDP, UNRATE, CPIAUCSL, FEDFUNDS, DGS10, MORTGAGE30US",
+        annotations: { title: "FRED: Series Data", readOnlyHint: true },
+        parameters: z.object({
+            series_id: z.string().describe("Series ID"),
+            limit: z.number().int().max(100000).optional().describe("Max obs (default 1000)"),
+            sort_order: z.enum(["asc", "desc"]).optional().describe("default: desc"),
+            frequency: z.string().optional().describe("d, w, bw, m, q, sa, a"),
+            start_date: z.string().optional().describe("YYYY-MM-DD"),
+            end_date: z.string().optional().describe("YYYY-MM-DD"),
+        }),
+        execute: async ({ series_id, limit, sort_order, frequency, start_date, end_date }) => {
+            const data = await getObservations(series_id, {
+                start: start_date, end: end_date, limit, sort: sort_order, frequency,
+            });
+            if (!data.observations?.length)
+                return `No observations for "${series_id}".`;
+            const obs = data.observations.slice(0, 100);
+            return JSON.stringify({
+                summary: `${series_id.toUpperCase()}: ${obs.length} of ${data.count} observations, ${data.observation_start} to ${data.observation_end}`,
+                seriesId: series_id.toUpperCase(),
+                total: data.count,
+                start: data.observation_start,
+                end: data.observation_end,
+                observations: obs,
+            });
+        },
+    },
+    {
+        name: "fred_release_data",
+        description: "Bulk fetch a FRED release.\nCommon: 53 (GDP), 50 (Employment), 10 (CPI), 18 (Rates)",
+        annotations: { title: "FRED: Release Data", readOnlyHint: true },
+        parameters: z.object({
+            release_id: z.number().int().positive().describe("e.g. 53 (GDP)"),
+            limit: z.number().int().max(500000).optional().describe("Max obs"),
+        }),
+        execute: async ({ release_id, limit }) => {
+            const data = await getReleaseData(release_id, limit);
+            const series = data.series?.slice(0, 30) ?? [];
+            return JSON.stringify({
+                summary: `${data.release?.name ?? `Release ${release_id}`}: ${data.series?.length ?? 0} series, has_more: ${data.has_more}`,
+                release: data.release,
+                hasMore: data.has_more,
+                nextCursor: data.next_cursor ?? null,
+                series,
+            });
+        },
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/fred.js";
+// ─── Prompts (FastMCP InputPrompt type) ──────────────────────────────
+export const prompts = [
+    {
+        name: "recession_check",
+        description: "Analyze whether the U.S. is in or approaching a recession using key economic indicators with legislative context.",
+        load: async () => "Use fred_series_data to fetch the following for the last 2 years (sort: desc, frequency: m or q as appropriate):\n\n" +
+            "== ECONOMIC INDICATORS ==\n" +
+            "1. GDP — quarterly growth (negative 2 consecutive quarters = technical recession)\n" +
+            "2. UNRATE — unemployment trend (rising = weakening labor market)\n" +
+            "3. PAYEMS — nonfarm payrolls (declining = job losses)\n" +
+            "4. CPIAUCSL — inflation trend (context for Fed policy)\n" +
+            "5. FEDFUNDS — Fed rate (tightening vs easing cycle)\n" +
+            "6. UMCSENT — consumer sentiment (leading indicator)\n\n" +
+            "== LEGISLATIVE/FISCAL CONTEXT ==\n" +
+            "7. Use congress_recent_laws to find any stimulus, relief, or economic bills passed recently\n" +
+            "8. Use congress_house_votes and congress_senate_votes for party-line breakdown on key economic legislation\n" +
+            "9. Use Treasury fiscal_snapshot data (debt, revenue, outlays) for fiscal backdrop\n" +
+            "10. Use dol_ui_claims_national for the latest weekly unemployment insurance claims (leading indicator)\n\n" +
+            "Analyze the trends together. A recession typically shows: declining GDP, rising unemployment, " +
+            "falling payrolls, and deteriorating consumer sentiment. Present the data and your assessment " +
+            "with appropriate caveats about confounding factors.",
+    },
+];
+//# sourceMappingURL=fred.js.map

package/dist/modules/fred.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fred.js","sourceRoot":"","sources":["../../src/modules/fred.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE9F,wEAAwE;AAExE,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG,sCAAsC,CAAC;AAClE,MAAM,CAAC,MAAM,WAAW,GAAG,2FAA2F,CAAC;AACvH,MAAM,CAAC,MAAM,IAAI,GAAG,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,4CAA4C,EAAE,CAAC;AACrG,MAAM,CAAC,MAAM,QAAQ,GAAG,8CAA8C,CAAC;AACvE,MAAM,CAAC,MAAM,IAAI,GAAG,4EAA4E,CAAC;AAEjG,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,aAAa,EAAE;QACb,GAAG,EAAE,wCAAwC,EAAE,MAAM,EAAE,gCAAgC;QACvF,QAAQ,EAAE,mCAAmC,EAAE,QAAQ,EAAE,6BAA6B;QACtF,KAAK,EAAE,6BAA6B,EAAE,YAAY,EAAE,8BAA8B;QAClF,IAAI,EAAE,8BAA8B,EAAE,KAAK,EAAE,iBAAiB;QAC9D,MAAM,EAAE,+BAA+B,EAAE,OAAO,EAAE,kCAAkC;QACpF,KAAK,EAAE,kCAAkC,EAAE,aAAa,EAAE,kCAAkC;KAC7F;IACD,IAAI,EAAE;QACJ,QAAQ,EAAE,4CAA4C;QACtD,QAAQ,EAAE,mDAAmD;QAC7D,SAAS,EAAE,4CAA4C;KACxD;CACF,CAAC;AAEF,wEAAwE;AAExE,MAAM,CAAC,MAAM,KAAK,GAAqB;IACrC;QACE,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,yFAAyF;QACtG,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE;QAC1D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC;YACtC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;SACjF,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;YAClC,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM;gBAAE,OAAO,wBAAwB,KAAK,IAAI,CAAC;YACpE,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,gBAAgB,KAAK,MAAM,IAAI,CAAC,KAAK,mBAAmB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;gBACtF,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,MAAM,EAAE,IAAI,CAAC,OAAO;aACrB,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,yEAAyE;QACtF,WAAW,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,IAAI,EAAE;QAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,MAAM,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,SAAS,cAAc,CAAC;YAC3C,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,iBAAiB,IAAI,CAAC,CAAC,eAAe,GAAG;gBACxG,GAAG,CAAC;aACL,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,kBAAkB;QACxB,WAAW,EAAE,oGAAoG;QACjH,WAAW,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,IAAI,EAAE;QAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;YAC3C,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACjF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACxE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;YAClE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;YACxD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;SACvD,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE;YACnF,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE;gBAC5C,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS;aACrE,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM;gBAAE,OAAO,wBAAwB,SAAS,IAAI,CAAC;YAC7E,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,KAAK,kBAAkB,IAAI,CAAC,iBAAiB,OAAO,IAAI,CAAC,eAAe,EAAE;gBACxI,QAAQ,EAAE,SAAS,CAAC,WAAW,EAAE;gBACjC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,KAAK,EAAE,IAAI,CAAC,iBAAiB;gBAC7B,GAAG,EAAE,IAAI,CAAC,eAAe;gBACzB,YAAY,EAAE,GAAG;aAClB,CAAC,CAAC;QACL,CAAC;KACF;IAED;QACE,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE,qFAAqF;QAClG,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,IAAI,EAAE;QAChE,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC;YACnB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC;YACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;YACrD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,IAAI,IAAI,WAAW,UAAU,EAAE,KAAK,IAAI,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC,sBAAsB,IAAI,CAAC,QAAQ,EAAE;gBAC3H,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,UAAU,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;gBACpC,MAAM;aACP,CAAC,CAAC;QACL,CAAC;KACF;CACF,CAAC;AAEF,wEAAwE;AAExE,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,wEAAwE;AAExE,MAAM,CAAC,MAAM,OAAO,GAA4B;IAC9C;QACE,IAAI,EAAE,iBAAiB;QACvB,WAAW,EAAE,mHAAmH;QAChI,IAAI,EAAE,KAAK,IAAI,EAAE,CACf,sHAAsH;YACtH,6BAA6B;YAC7B,qFAAqF;YACrF,oEAAoE;YACpE,yDAAyD;YACzD,0DAA0D;YAC1D,uDAAuD;YACvD,yDAAyD;YACzD,oCAAoC;YACpC,+FAA+F;YAC/F,8GAA8G;YAC9G,qFAAqF;YACrF,4GAA4G;YAC5G,gGAAgG;YAChG,+FAA+F;YAC/F,qDAAqD;KACxD;CACF,CAAC"}

package/dist/modules/govinfo.d.ts

@@ -0,0 +1,24 @@
+/**
+ * GovInfo MCP module — tools + metadata. Delegates all API calls to sdk/govinfo.
+ *
+ * Tools return raw JSON data — no markdown formatting. The client decides how to present it.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "govinfo";
+export declare const displayName = "GovInfo";
+export declare const description = "Full-text search across Congressional bills, laws, Federal Register, CFR, CBO reports, and more";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+    note: string;
+};
+export declare const workflow = "govinfo_search to find publications \u2192 govinfo_bill_text for full legislative text";
+export declare const tips = "Package ID format for bills: BILLS-{congress}{type}{number}{version}. Example: BILLS-117hr5376enr (Inflation Reduction Act).";
+export declare const reference: {
+    collections: Record<string, string>;
+    billVersions: Record<string, string>;
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/govinfo.js";
+//# sourceMappingURL=govinfo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"govinfo.d.ts","sourceRoot":"","sources":["../../src/modules/govinfo.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAWjD,eAAO,MAAM,IAAI,YAAY,CAAC;AAC9B,eAAO,MAAM,WAAW,YAAY,CAAC;AACrC,eAAO,MAAM,WAAW,oGAAoG,CAAC;AAC7H,eAAO,MAAM,IAAI;;;;CAA6G,CAAC;AAC/H,eAAO,MAAM,QAAQ,2FAAsF,CAAC;AAC5G,eAAO,MAAM,IAAI,iIAAiI,CAAC;AAEnJ,eAAO,MAAM,SAAS;;;CAGrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAsHjC,CAAC;AAEF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAgB1C,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}