us-gov-open-data-mcp 1.0.0

package/dist/modules/govinfo.js

@@ -0,0 +1,147 @@
+/**
+ * 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 { z } from "zod";
+import { searchPublications, searchCboReports, getBillText, collections, billVersions, } from "../sdk/govinfo.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "govinfo";
+export const displayName = "GovInfo";
+export const description = "Full-text search across Congressional bills, laws, Federal Register, CFR, CBO reports, and more";
+export const auth = { envVar: "DATA_GOV_API_KEY", signup: "https://api.data.gov/signup/", note: "Same key as FBI Crime Data" };
+export const workflow = "govinfo_search to find publications → govinfo_bill_text for full legislative text";
+export const tips = "Package ID format for bills: BILLS-{congress}{type}{number}{version}. Example: BILLS-117hr5376enr (Inflation Reduction Act).";
+export const reference = {
+    collections,
+    billVersions,
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "govinfo_search",
+        description: "Search across all government publications — bills, laws, CBO reports, " +
+            "Congressional Record, Federal Register, committee reports, and more.\n\n" +
+            "Collections: BILLS, PLAW (public laws), CRPT (committee reports), " +
+            "CREC (Congressional Record), BUDGET, FR (Federal Register), CRECB (bound CR)",
+        annotations: { title: "GovInfo: Search Publications", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Search query — bill name, topic, or keyword"),
+            collection: z.string().optional().describe("Collection: 'BILLS', 'PLAW' (public laws), 'CRPT' (committee reports), " +
+                "'CREC' (Congressional Record), 'BUDGET', 'FR' (Federal Register)"),
+            congress: z.number().int().optional().describe("Filter by Congress number (e.g., 119)"),
+            page_size: z.number().int().optional().describe("Results per page (default: 10, max: 100)"),
+        }),
+        execute: async ({ query, collection, congress, page_size }) => {
+            const data = await searchPublications({ query, collection, congress, pageSize: page_size });
+            if (!data.results.length)
+                return JSON.stringify({ summary: `No results found for "${query}".`, total: 0, results: [] });
+            return JSON.stringify({
+                summary: `GovInfo search "${query}": ${data.total} total, showing ${data.results.length}`,
+                total: data.total,
+                results: data.results,
+            });
+        },
+    },
+    {
+        name: "govinfo_bill_text",
+        description: "Get the full text of a bill or enrolled law from GovInfo. " +
+            "Returns the actual legislative text — tax rates, dollar amounts, provisions.\n\n" +
+            "Package ID examples:\n" +
+            "- BILLS-119hr1enr (119th Congress, HR 1, enrolled)\n" +
+            "- BILLS-115hr1enr (Tax Cuts and Jobs Act)\n" +
+            "- BILLS-117hr5376enr (Inflation Reduction Act)\n\n" +
+            "Version suffixes: enr (enrolled/signed), eh (engrossed House), " +
+            "es (engrossed Senate), ih (introduced House), is (introduced Senate)",
+        annotations: { title: "GovInfo: Bill/Law Full Text", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number (e.g., 119, 118, 117)"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', 'hjres', 'sjres'"),
+            bill_number: z.number().int().describe("Bill number (e.g., 1, 5376)"),
+            version: z.string().optional().describe("Bill version: 'enr' (enrolled/signed, default), 'eh' (engrossed House), " +
+                "'es' (engrossed Senate), 'ih' (introduced House), 'is' (introduced Senate)"),
+            max_length: z.number().int().optional().describe("Maximum characters to return (default: 15000). Use higher for complete text."),
+        }),
+        execute: async ({ congress, bill_type, bill_number, version, max_length }) => {
+            try {
+                const data = await getBillText({
+                    congress, billType: bill_type, billNumber: bill_number,
+                    version, maxLength: max_length,
+                });
+                if (!data.text) {
+                    return JSON.stringify({
+                        summary: `${data.title}: full text not available. Try a different version (ih, eh, es, enr).`,
+                        packageId: data.packageId,
+                        title: data.title,
+                        dateIssued: data.dateIssued,
+                        textSource: null,
+                    });
+                }
+                return JSON.stringify({
+                    summary: `${data.title}: ${data.textLength.toLocaleString()} chars from ${data.textSource}${data.truncated ? ` (truncated to ${(max_length || 15000).toLocaleString()})` : ""}`,
+                    packageId: data.packageId,
+                    title: data.title,
+                    dateIssued: data.dateIssued,
+                    pages: data.pages,
+                    textSource: data.textSource,
+                    textLength: data.textLength,
+                    truncated: data.truncated,
+                    text: data.text,
+                });
+            }
+            catch (err) {
+                const ver = version || "enr";
+                const packageId = `BILLS-${congress}${bill_type.toLowerCase()}${bill_number}${ver}`;
+                return JSON.stringify({
+                    summary: `Error fetching bill text for ${packageId}`,
+                    packageId,
+                    error: err instanceof Error ? err.message : String(err),
+                    hints: [
+                        "Check congress number and bill number",
+                        "Try a different version: 'ih' (introduced), 'eh' (engrossed), 'enr' (enrolled)",
+                        "The bill may not have reached that stage yet",
+                    ],
+                });
+            }
+        },
+    },
+    {
+        name: "govinfo_cbo_reports",
+        description: "Search for Congressional Budget Office reports published through GovInfo. " +
+            "CBO scores tax bills with distributional analysis showing impact by income group.",
+        annotations: { title: "GovInfo: CBO Cost Estimates & Reports", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().describe("Search query — bill name or topic (e.g., 'Tax Cuts and Jobs Act', 'reconciliation')"),
+            page_size: z.number().int().optional().describe("Results per page (default: 10)"),
+        }),
+        execute: async ({ query, page_size }) => {
+            const data = await searchCboReports(query, page_size);
+            if (!data.results.length)
+                return JSON.stringify({ summary: `No CBO reports found for "${query}".`, total: 0, results: [] });
+            return JSON.stringify({
+                summary: `CBO/Committee reports for "${query}": ${data.results.length} results`,
+                total: data.total,
+                results: data.results,
+            });
+        },
+    },
+];
+export const prompts = [
+    {
+        name: "recent_legislation_text",
+        description: "Get the full text of recently enacted legislation with vote breakdown and impact analysis.",
+        load: async () => "Find and present recent significant legislation:\n\n" +
+            "1. Use congress_recent_laws to find the 5 most recently signed laws\n" +
+            "2. For the most significant one, use govinfo_bill_text to get the full text\n" +
+            "3. Use congress_bill_details for cosponsor and committee info\n" +
+            "4. Use congress_house_votes for the House party-line vote breakdown\n" +
+            "5. Use congress_senate_votes for the Senate party-line vote breakdown\n" +
+            "6. Use lobbying_search to find who lobbied on this legislation\n" +
+            "7. Check usa_spending_by_agency to see if it affected agency spending\n\n" +
+            "Summarize the key provisions, show the party-line vote breakdown from both chambers, " +
+            "and note any lobbying activity related to the bill.",
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/govinfo.js";
+//# sourceMappingURL=govinfo.js.map

package/dist/modules/govinfo.js.map

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

package/dist/modules/hud.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HUD module — Fair Market Rents, Income Limits, geographic lookups
+ */
+import type { Tool } from "fastmcp";
+import { clearCache as sdkClearCache } from "../sdk/hud.js";
+export declare const name = "hud";
+export declare const displayName = "HUD";
+export declare const description = "Department of Housing and Urban Development \u2014 Fair Market Rents (FMR) by bedroom count, Income Limits by household size for counties and metro areas. Essential for affordable housing, Section 8 vouchers, and housing cost analysis.";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "Use hud_list_states to get state codes \u2192 hud_list_counties to find county FIPS codes \u2192 hud_fair_market_rents for rental data \u2192 hud_income_limits for income thresholds.";
+export declare const tips = "Entity IDs are county FIPS codes (e.g. '0600000001' for a CA county). Use hud_list_counties to find them. State-level tools accept two-letter codes (CA, TX). FMR data shows HUD-determined fair rents used for Section 8 voucher amounts. Income Limits show Very Low, Extremely Low, and Low income thresholds by household size (1-8 persons).";
+export declare const tools: Tool<any, any>[];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=hud.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hud.d.ts","sourceRoot":"","sources":["../../src/modules/hud.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAQL,UAAU,IAAI,aAAa,EAC5B,MAAM,eAAe,CAAC;AAIvB,eAAO,MAAM,IAAI,QAAQ,CAAC;AAC1B,eAAO,MAAM,WAAW,QAAQ,CAAC;AACjC,eAAO,MAAM,WAAW,gPACkN,CAAC;AAC3O,eAAO,MAAM,IAAI;;;CAGhB,CAAC;AACF,eAAO,MAAM,QAAQ,2LACsJ,CAAC;AAC5K,eAAO,MAAM,IAAI,sVACoU,CAAC;AA2DtV,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA0GjC,CAAC;AAEF,OAAO,EAAE,aAAa,IAAI,UAAU,EAAE,CAAC"}

package/dist/modules/hud.js

@@ -0,0 +1,170 @@
+/**
+ * HUD module — Fair Market Rents, Income Limits, geographic lookups
+ */
+import { z } from "zod";
+import { listStates, listCounties, listMetroAreas, getFairMarketRents, getStateFairMarketRents, getIncomeLimits, getStateIncomeLimits, clearCache as sdkClearCache, } from "../sdk/hud.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "hud";
+export const displayName = "HUD";
+export const description = "Department of Housing and Urban Development — Fair Market Rents (FMR) by bedroom count, Income Limits by household size for counties and metro areas. Essential for affordable housing, Section 8 vouchers, and housing cost analysis.";
+export const auth = {
+    envVar: "HUD_USER_TOKEN",
+    signup: "https://www.huduser.gov/hudapi/public/register",
+};
+export const workflow = "Use hud_list_states to get state codes → hud_list_counties to find county FIPS codes → hud_fair_market_rents for rental data → hud_income_limits for income thresholds.";
+export const tips = "Entity IDs are county FIPS codes (e.g. '0600000001' for a CA county). Use hud_list_counties to find them. State-level tools accept two-letter codes (CA, TX). FMR data shows HUD-determined fair rents used for Section 8 voucher amounts. Income Limits show Very Low, Extremely Low, and Low income thresholds by household size (1-8 persons).";
+// ─── Helpers ─────────────────────────────────────────────────────────
+function formatFmr(data) {
+    const basic = data.basicdata;
+    const source = basic ?? data;
+    const name = source.area_name ?? source.county_name ?? source.metro_name ?? "Unknown area";
+    const year = source.year ?? data.year ?? "?";
+    // Try to find rent values from various possible field names
+    const eff = source.Efficiency ?? source.efficiency ?? source.rent_eff ?? "N/A";
+    const br1 = source["One-Bedroom"] ?? source.one_bedroom ?? source.rent_1br ?? "N/A";
+    const br2 = source["Two-Bedroom"] ?? source.two_bedroom ?? source.rent_2br ?? "N/A";
+    const br3 = source["Three-Bedroom"] ?? source.three_bedroom ?? source.rent_3br ?? "N/A";
+    const br4 = source["Four-Bedroom"] ?? source.four_bedroom ?? source.rent_4br ?? "N/A";
+    const fmt = (v) => (typeof v === "number" ? `$${v.toLocaleString()}` : String(v));
+    return [
+        `Fair Market Rents — ${name} (${year})`,
+        `  Efficiency: ${fmt(eff)}`,
+        `  1-Bedroom:  ${fmt(br1)}`,
+        `  2-Bedroom:  ${fmt(br2)}`,
+        `  3-Bedroom:  ${fmt(br3)}`,
+        `  4-Bedroom:  ${fmt(br4)}`,
+    ].join("\n");
+}
+function formatIncomeLimits(data) {
+    const name = data.area_name ?? data.county_name ?? data.metro_name ?? "Unknown area";
+    const year = data.year ?? "?";
+    const median = data.median_income ?? data.median ?? "N/A";
+    const fmt = (v) => (typeof v === "number" ? `$${v.toLocaleString()}` : String(v));
+    const lines = [`Income Limits — ${name} (${year})`, `Median Family Income: ${fmt(median)}`];
+    const categories = [
+        { key: "very_low", label: "Very Low (50%)" },
+        { key: "extremely_low", label: "Extremely Low (30%)" },
+        { key: "low", label: "Low (80%)" },
+    ];
+    for (const cat of categories) {
+        const vals = data[cat.key];
+        if (vals && typeof vals === "object") {
+            const personCounts = Object.entries(vals)
+                .map(([k, v]) => `${k}-person: ${fmt(v)}`)
+                .join(", ");
+            lines.push(`  ${cat.label}: ${personCounts}`);
+        }
+    }
+    return lines.join("\n");
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "hud_fair_market_rents",
+        description: "Get HUD Fair Market Rents (FMR) for a county, metro area, or entire state. Shows monthly rent by bedroom count (efficiency through 4-bedroom). FMR determines Section 8 voucher amounts.",
+        annotations: { title: "HUD Fair Market Rents", readOnlyHint: true },
+        parameters: z.object({
+            state: z.string().max(2).optional().describe("Two-letter state code for state-wide FMR data (e.g. CA, TX)"),
+            entity_id: z.string().optional().describe("County FIPS or CBSA code for specific area FMR (get from hud_list_counties)"),
+            year: z.number().optional().describe("Fiscal year (e.g. 2024). Defaults to current year."),
+        }),
+        execute: async (args) => {
+            let data;
+            if (args.entity_id) {
+                data = await getFairMarketRents(args.entity_id, args.year);
+            }
+            else if (args.state) {
+                data = await getStateFairMarketRents(args.state, args.year);
+            }
+            else {
+                return { content: [{ type: "text", text: "Provide either state or entity_id." }] };
+            }
+            // Handle state data which may return an array
+            if (Array.isArray(data)) {
+                const lines = data.slice(0, 20).map((item) => formatFmr(item));
+                return { content: [{ type: "text", text: lines.join("\n\n") }] };
+            }
+            return { content: [{ type: "text", text: formatFmr(data) }] };
+        },
+    },
+    {
+        name: "hud_income_limits",
+        description: "Get HUD Income Limits for a county, metro area, or entire state. Shows Very Low, Extremely Low, and Low income thresholds by household size (1-8 persons). Used for affordable housing eligibility.",
+        annotations: { title: "HUD Income Limits", readOnlyHint: true },
+        parameters: z.object({
+            state: z.string().max(2).optional().describe("Two-letter state code for state-wide income limits"),
+            entity_id: z.string().optional().describe("County FIPS or CBSA code (get from hud_list_counties)"),
+            year: z.number().optional().describe("Fiscal year (e.g. 2024). Defaults to current year."),
+        }),
+        execute: async (args) => {
+            let data;
+            if (args.entity_id) {
+                data = await getIncomeLimits(args.entity_id, args.year);
+            }
+            else if (args.state) {
+                data = await getStateIncomeLimits(args.state, args.year);
+            }
+            else {
+                return { content: [{ type: "text", text: "Provide either state or entity_id." }] };
+            }
+            if (Array.isArray(data)) {
+                const lines = data.slice(0, 20).map((item) => formatIncomeLimits(item));
+                return { content: [{ type: "text", text: lines.join("\n\n") }] };
+            }
+            return { content: [{ type: "text", text: formatIncomeLimits(data) }] };
+        },
+    },
+    {
+        name: "hud_list_states",
+        description: "List all U.S. states with their HUD state codes. Use these codes with other HUD tools.",
+        annotations: { title: "HUD States", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const states = await listStates();
+            if (!states.length)
+                return { content: [{ type: "text", text: "No states returned." }] };
+            const lines = states.map((s) => `${s.state_code}: ${s.state_name}`);
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        },
+    },
+    {
+        name: "hud_list_counties",
+        description: "List counties in a state with their FIPS codes. Use FIPS codes as entity_id in hud_fair_market_rents and hud_income_limits.",
+        annotations: { title: "HUD Counties", readOnlyHint: true },
+        parameters: z.object({
+            state: z.string().max(2).describe("Two-letter state code (e.g. CA, TX, NY)"),
+        }),
+        execute: async (args) => {
+            const counties = await listCounties(args.state);
+            if (!counties.length)
+                return { content: [{ type: "text", text: `No counties found for state '${args.state}'.` }] };
+            const lines = counties.map((c) => `${c.fips_code}: ${c.county_name}`);
+            return {
+                content: [{ type: "text", text: `${counties.length} county/area(s) in ${args.state.toUpperCase()}:\n${lines.join("\n")}` }],
+            };
+        },
+    },
+    {
+        name: "hud_list_metro_areas",
+        description: "List metropolitan/CBSA areas. CBSA codes can be used as entity_id in HUD tools.",
+        annotations: { title: "HUD Metro Areas", readOnlyHint: true },
+        parameters: z.object({}),
+        execute: async () => {
+            const areas = await listMetroAreas();
+            if (!areas.length)
+                return { content: [{ type: "text", text: "No metro areas returned." }] };
+            const preview = areas.slice(0, 50);
+            const lines = preview.map((a) => `${a.cbsa_code}: ${a.area_name}`);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${areas.length} metro area(s)${areas.length > 50 ? " (showing first 50)" : ""}:\n${lines.join("\n")}`,
+                    },
+                ],
+            };
+        },
+    },
+];
+export { sdkClearCache as clearCache };
+//# sourceMappingURL=hud.js.map

package/dist/modules/hud.js.map

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

package/dist/modules/naep.d.ts

@@ -0,0 +1,27 @@
+/**
+ * NAEP (Nation's Report Card) MCP module — test scores, achievement levels, and gaps.
+ */
+import type { Tool, InputPrompt } from "fastmcp";
+export declare const name = "naep";
+export declare const displayName = "NAEP (Nation's Report Card)";
+export declare const description = "National Assessment of Educational Progress: reading, math, science test scores by state, grade, race, gender, school lunch eligibility \u2014 the gold standard for U.S. education measurement";
+export declare const workflow = "naep_scores for current data, naep_achievement_levels for proficiency %, naep_compare_years for trends, naep_compare_states for state rankings";
+export declare const tips: string;
+export declare const reference: {
+    subjects: Record<string, {
+        code: string;
+        subscale: string;
+        label: string;
+    }>;
+    variables: Record<string, string>;
+    statTypes: Record<string, string>;
+    docs: {
+        "NAEP Data Explorer": string;
+        "API Documentation": string;
+        "Assessment Schedule": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export declare const prompts: InputPrompt<any, any>[];
+export { clearCache } from "../sdk/naep.js";
+//# sourceMappingURL=naep.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"naep.d.ts","sourceRoot":"","sources":["../../src/modules/naep.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAejD,eAAO,MAAM,IAAI,SAAS,CAAC;AAC3B,eAAO,MAAM,WAAW,gCAAgC,CAAC;AACzD,eAAO,MAAM,WAAW,oMAA+L,CAAC;AACxN,eAAO,MAAM,QAAQ,mJAAmJ,CAAC;AACzK,eAAO,MAAM,IAAI,QAIsE,CAAC;AAExF,eAAO,MAAM,SAAS;;;;;;;;;;;;;CASrB,CAAC;AAIF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EA0KjC,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAe1C,CAAC;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/modules/naep.js

@@ -0,0 +1,210 @@
+/**
+ * NAEP (Nation's Report Card) MCP module — test scores, achievement levels, and gaps.
+ */
+import { z } from "zod";
+import { getScores, getAchievementLevels, compareAcrossYears, compareAcrossJurisdictions, compareAcrossGroups, SUBJECTS, VARIABLES, STAT_TYPES, } from "../sdk/naep.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "naep";
+export const displayName = "NAEP (Nation's Report Card)";
+export const description = "National Assessment of Educational Progress: reading, math, science test scores by state, grade, race, gender, school lunch eligibility — the gold standard for U.S. education measurement";
+export const workflow = "naep_scores for current data, naep_achievement_levels for proficiency %, naep_compare_years for trends, naep_compare_states for state rankings";
+export const tips = "Subjects: 'reading', 'math', 'science', 'writing', 'civics', 'history'. " +
+    "Grades: 4, 8, 12. Jurisdiction codes: 'NP' (national public), or state abbreviations (CA, TX, NY). " +
+    "Variables: 'TOTAL' (all students), 'SDRACE' (race), 'GENDER', 'SLUNCH3' (poverty/lunch eligibility). " +
+    "Years: use specific years like '2022' or 'Current'. NAEP is assessed every 2 years.";
+export const reference = {
+    subjects: SUBJECTS,
+    variables: VARIABLES,
+    statTypes: STAT_TYPES,
+    docs: {
+        "NAEP Data Explorer": "https://www.nationsreportcard.gov/ndecore/landing",
+        "API Documentation": "https://www.nationsreportcard.gov/api_documentation.aspx",
+        "Assessment Schedule": "https://nces.ed.gov/nationsreportcard/about/assessmentsched.aspx",
+    },
+};
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "naep_scores",
+        description: "Get NAEP test scores (Nation's Report Card) — the gold standard for measuring U.S. student achievement.\n" +
+            "Returns average scale scores by subject, grade, state, and demographic group.\n\n" +
+            "Subjects: 'reading', 'math', 'science', 'writing', 'civics', 'history', 'geography'\n" +
+            "Grades: 4, 8, 12\n" +
+            "Variables: 'TOTAL' (all students), 'SDRACE' (race), 'GENDER', 'SLUNCH3' (school lunch/poverty), 'PARED' (parent education)\n" +
+            "Jurisdiction: 'NP' (national public), or state codes ('CA', 'TX', 'NY', 'MS')",
+        annotations: { title: "NAEP: Test Scores", readOnlyHint: true },
+        parameters: z.object({
+            subject: z.string().describe("'reading', 'math', 'science', 'writing', 'civics', 'history', 'geography'"),
+            grade: z.number().int().describe("4, 8, or 12"),
+            variable: z.string().optional().describe("'TOTAL' (default), 'SDRACE' (race), 'GENDER', 'SLUNCH3' (poverty), 'PARED' (parent ed), 'IEP' (disability), 'LEP' (English learners)"),
+            jurisdiction: z.string().optional().describe("'NP' (national public, default), or state codes: 'CA', 'TX', 'NY', 'MS', 'MA'. Comma-separate for multiple."),
+            year: z.string().optional().describe("Assessment year: '2022', '2019', '2017'. Default: most recent. Use 'Current' for latest."),
+            stat_type: z.string().optional().describe("'MN:MN' (mean score, default), 'ALC:AP' (% at/above proficient), 'ALC:BB' (% below basic)"),
+        }),
+        execute: async ({ subject, grade, variable, jurisdiction, year, stat_type }) => {
+            const data = await getScores({
+                subject, grade,
+                variable: variable || "TOTAL",
+                jurisdiction: jurisdiction || "NP",
+                year: year || "Current",
+                stattype: stat_type,
+            });
+            if (!data.result?.length)
+                return `No NAEP data found for ${subject} grade ${grade}.`;
+            return JSON.stringify({
+                summary: `NAEP ${subject} grade ${grade}: ${data.result.length} data points`,
+                results: data.result.map(r => ({
+                    year: r.year, jurisdiction: r.jurisdiction,
+                    variable: r.variable, category: r.varValueLabel || r.varValue,
+                    value: r.value, standardError: r.se, errorFlag: r.errorFlag,
+                })),
+            });
+        },
+    },
+    {
+        name: "naep_achievement_levels",
+        description: "Get the percentage of students at each NAEP achievement level: Below Basic, Basic, Proficient, Advanced.\n" +
+            "THIS IS THE KEY LITERACY/NUMERACY METRIC — shows what % of students can read/do math at grade level.\n" +
+            "Example: '37% of 4th graders scored Below Basic in reading' comes from this data.",
+        annotations: { title: "NAEP: Achievement Levels", readOnlyHint: true },
+        parameters: z.object({
+            subject: z.string().describe("'reading', 'math', 'science'"),
+            grade: z.number().int().describe("4, 8, or 12"),
+            variable: z.string().optional().describe("'TOTAL' (default), 'SDRACE' (race), 'GENDER', 'SLUNCH3' (poverty)"),
+            jurisdiction: z.string().optional().describe("'NP' (national, default), or state codes"),
+            year: z.string().optional().describe("Year: '2022', '2019'. Default: most recent"),
+        }),
+        execute: async ({ subject, grade, variable, jurisdiction, year }) => {
+            const data = await getAchievementLevels({
+                subject, grade,
+                variable: variable || "TOTAL",
+                jurisdiction: jurisdiction || "NP",
+                year: year || "Current",
+            });
+            if (!data.result?.length)
+                return `No achievement level data found for ${subject} grade ${grade}.`;
+            return JSON.stringify({
+                summary: `NAEP achievement levels: ${subject} grade ${grade}, ${data.result.length} data points`,
+                results: data.result.map(r => ({
+                    year: r.year, jurisdiction: r.jurisdiction,
+                    variable: r.variable, category: r.varValueLabel || r.varValue,
+                    statType: r.stattype, value: r.value, standardError: r.se,
+                })),
+            });
+        },
+    },
+    {
+        name: "naep_compare_years",
+        description: "Compare NAEP scores across assessment years with significance testing.\n" +
+            "Shows whether score changes between years are statistically significant.\n" +
+            "Great for tracking the COVID learning loss and recovery.",
+        annotations: { title: "NAEP: Compare Across Years", readOnlyHint: true },
+        parameters: z.object({
+            subject: z.string().describe("'reading', 'math', 'science'"),
+            grade: z.number().int().describe("4, 8, or 12"),
+            years: z.string().describe("Comma-separated years to compare: '2022,2019' or '2022,2019,2017'"),
+            variable: z.string().optional().describe("'TOTAL' (default), 'SDRACE', 'GENDER', 'SLUNCH3'"),
+            jurisdiction: z.string().optional().describe("'NP' (default), or state codes"),
+        }),
+        execute: async ({ subject, grade, years, variable, jurisdiction }) => {
+            const data = await compareAcrossYears({
+                subject, grade, years,
+                variable: variable || "TOTAL",
+                jurisdiction: jurisdiction || "NP",
+            });
+            if (!data.result?.length)
+                return `No comparison data found.`;
+            return JSON.stringify({
+                summary: `NAEP year comparison: ${subject} grade ${grade}, years ${years}`,
+                results: data.result.map((r) => ({
+                    year: r.year, jurisdiction: r.jurisdiction,
+                    category: r.varValueLabel || r.varValue,
+                    focalValue: r.focalValue, targetValue: r.targetValue,
+                    gap: r.gap, significance: r.significance ?? r.sig,
+                })),
+            });
+        },
+    },
+    {
+        name: "naep_compare_states",
+        description: "Compare NAEP scores across states/jurisdictions with significance testing.\n" +
+            "Shows which states score significantly higher or lower than others.\n" +
+            "Example: Compare Massachusetts vs Mississippi reading scores.",
+        annotations: { title: "NAEP: Compare States", readOnlyHint: true },
+        parameters: z.object({
+            subject: z.string().describe("'reading', 'math', 'science'"),
+            grade: z.number().int().describe("4, 8, or 12"),
+            jurisdictions: z.string().describe("Comma-separated jurisdiction codes: 'NP,CA,TX,MS,MA' or 'NP,NY'"),
+            variable: z.string().optional().describe("'TOTAL' (default), 'SDRACE', 'GENDER'"),
+            year: z.string().optional().describe("Year: '2022'. Default: most recent"),
+        }),
+        execute: async ({ subject, grade, jurisdictions, variable, year }) => {
+            const data = await compareAcrossJurisdictions({
+                subject, grade, jurisdictions,
+                variable: variable || "TOTAL",
+                year: year || "Current",
+            });
+            if (!data.result?.length)
+                return `No comparison data found.`;
+            return JSON.stringify({
+                summary: `NAEP state comparison: ${subject} grade ${grade}, jurisdictions ${jurisdictions}`,
+                results: data.result.map((r) => ({
+                    year: r.year, jurisdiction: r.jurisdiction,
+                    category: r.varValueLabel || r.varValue,
+                    focalValue: r.focalValue, targetValue: r.targetValue,
+                    gap: r.gap, significance: r.significance ?? r.sig,
+                })),
+            });
+        },
+    },
+    {
+        name: "naep_compare_groups",
+        description: "Compare NAEP scores across demographic groups (race, gender, poverty) with significance testing.\n" +
+            "Shows achievement gaps between groups (e.g., White vs Black, Male vs Female, eligible vs not eligible for free lunch).",
+        annotations: { title: "NAEP: Achievement Gaps", readOnlyHint: true },
+        parameters: z.object({
+            subject: z.string().describe("'reading', 'math', 'science'"),
+            grade: z.number().int().describe("4, 8, or 12"),
+            variable: z.string().describe("'SDRACE' (race gap), 'GENDER' (gender gap), 'SLUNCH3' (poverty gap), 'IEP' (disability gap), 'LEP' (ELL gap)"),
+            jurisdiction: z.string().optional().describe("'NP' (default), or state codes"),
+            year: z.string().optional().describe("Year: '2022'. Default: most recent"),
+        }),
+        execute: async ({ subject, grade, variable, jurisdiction, year }) => {
+            const data = await compareAcrossGroups({
+                subject, grade, variable,
+                jurisdiction: jurisdiction || "NP",
+                year: year || "Current",
+            });
+            if (!data.result?.length)
+                return `No gap data found.`;
+            return JSON.stringify({
+                summary: `NAEP achievement gaps: ${subject} grade ${grade}, by ${variable}`,
+                results: data.result.map((r) => ({
+                    year: r.year, jurisdiction: r.jurisdiction,
+                    focalCategory: r.focalVarValueLabel || r.focalVarValue,
+                    targetCategory: r.targetVarValueLabel || r.targetVarValue,
+                    focalValue: r.focalValue, targetValue: r.targetValue,
+                    gap: r.gap, significance: r.significance ?? r.sig,
+                })),
+            });
+        },
+    },
+];
+// ─── Prompts ─────────────────────────────────────────────────────────
+export const prompts = [
+    {
+        name: "education_report_card",
+        description: "Comprehensive U.S. education snapshot: NAEP scores, achievement levels, trends, and demographic gaps.",
+        load: async () => "Build a comprehensive education report card:\n\n" +
+            "1. Use naep_scores for 4th grade reading (NP, TOTAL, 2022) — current national average\n" +
+            "2. Use naep_achievement_levels for 4th grade reading — what % are below basic, proficient, etc.\n" +
+            "3. Use naep_compare_years for 4th grade reading years 2022,2019,2017 — track COVID impact\n" +
+            "4. Use naep_compare_groups for 4th grade reading by SDRACE — racial achievement gap\n" +
+            "5. Use naep_compare_groups for 4th grade reading by SLUNCH3 — poverty achievement gap\n" +
+            "6. Repeat steps 1-2 for 4th grade math\n" +
+            "7. Use naep_compare_states for reading grade 4: NP,MA,MS,CA,TX — highest vs lowest states\n\n" +
+            "Cross-reference with Census poverty data and CDC PLACES health data to show how poverty, food insecurity, and health correlate with test scores.",
+    },
+];
+export { clearCache } from "../sdk/naep.js";
+//# sourceMappingURL=naep.js.map

package/dist/modules/naep.js.map

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