us-gov-open-data-mcp 1.0.0

package/dist/modules/college-scorecard.js

@@ -0,0 +1,192 @@
+/**
+ * College Scorecard MCP module — college costs, graduation rates, earnings, debt.
+ */
+import { z } from "zod";
+import { searchSchools, querySchools, getMostExpensive, getHighestEarners, getHighestGraduationRates, OWNERSHIP, DEGREE_TYPES, } from "../sdk/college-scorecard.js";
+// ─── Metadata ────────────────────────────────────────────────────────
+export const name = "college-scorecard";
+export const displayName = "College Scorecard";
+export const description = "College costs, graduation rates, post-graduation earnings, student debt, admission rates for every U.S. college and university";
+export const auth = { envVar: "DATA_GOV_API_KEY", signup: "https://api.data.gov/signup/" };
+export const workflow = "scorecard_search to find schools → scorecard_compare for side-by-side → scorecard_top for rankings";
+export const tips = "Ownership: 1=Public, 2=Private nonprofit, 3=Private for-profit. " +
+    "Degree types: 1=Certificate, 2=Associate, 3=Bachelor's, 4=Graduate. " +
+    "Use state abbreviations for filtering: 'CA', 'NY', 'TX'. " +
+    "Sort by cost, earnings, or graduation rate to find best/worst schools.";
+export const reference = {
+    ownership: OWNERSHIP,
+    degreeTypes: DEGREE_TYPES,
+    popularFields: {
+        "latest.cost.tuition.in_state": "In-state tuition ($)",
+        "latest.cost.tuition.out_of_state": "Out-of-state tuition ($)",
+        "latest.cost.avg_net_price.overall": "Average net price after aid ($)",
+        "latest.admissions.admission_rate.overall": "Admission rate (0-1)",
+        "latest.completion.rate_suppressed.overall": "Graduation rate (0-1)",
+        "latest.earnings.10_yrs_after_entry.median": "Median earnings 10 years after entry ($)",
+        "latest.earnings.6_yrs_after_entry.median": "Median earnings 6 years after entry ($)",
+        "latest.aid.median_debt.completers.overall": "Median debt at graduation ($)",
+        "latest.aid.pell_grant_rate": "Pell grant rate (proxy for low-income students)",
+        "latest.student.size": "Undergraduate enrollment",
+    },
+    docs: {
+        "College Scorecard": "https://collegescorecard.ed.gov/",
+        "API Documentation": "https://collegescorecard.ed.gov/data/documentation/",
+        "Data Dictionary": "https://collegescorecard.ed.gov/assets/CollegeScorecardDataDictionary.xlsx",
+        "Get API Key": "https://api.data.gov/signup/",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function formatSchool(r) {
+    return {
+        id: r.id ?? r["id"],
+        name: r["school.name"],
+        state: r["school.state"],
+        city: r["school.city"],
+        ownership: OWNERSHIP[r["school.ownership"]] ?? r["school.ownership"],
+        admissionRate: r["latest.admissions.admission_rate.overall"] != null
+            ? `${(Number(r["latest.admissions.admission_rate.overall"]) * 100).toFixed(1)}%` : null,
+        tuitionInState: r["latest.cost.tuition.in_state"],
+        tuitionOutOfState: r["latest.cost.tuition.out_of_state"],
+        avgNetPrice: r["latest.cost.avg_net_price.overall"],
+        graduationRate: r["latest.completion.rate_suppressed.overall"] != null
+            ? `${(Number(r["latest.completion.rate_suppressed.overall"]) * 100).toFixed(1)}%` : null,
+        medianEarnings10yr: r["latest.earnings.10_yrs_after_entry.median"],
+        medianEarnings6yr: r["latest.earnings.6_yrs_after_entry.median"],
+        medianDebt: r["latest.aid.median_debt.completers.overall"],
+        pellGrantRate: r["latest.aid.pell_grant_rate"] != null
+            ? `${(Number(r["latest.aid.pell_grant_rate"]) * 100).toFixed(1)}%` : null,
+        studentSize: r["latest.student.size"],
+    };
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "scorecard_search",
+        description: "Search U.S. colleges and universities from the College Scorecard.\n" +
+            "Returns tuition, admission rate, graduation rate, median earnings after graduation, student debt.\n\n" +
+            "Search by name, state, or school type. Sort by cost, earnings, or graduation rate.",
+        annotations: { title: "College Scorecard: Search Schools", readOnlyHint: true },
+        parameters: z.object({
+            name: z.string().optional().describe("School name (partial match): 'Harvard', 'community college', 'MIT'"),
+            state: z.string().optional().describe("Two-letter state code: 'CA', 'NY', 'TX'"),
+            ownership: z.number().int().optional().describe("1=Public, 2=Private nonprofit, 3=Private for-profit"),
+            sort: z.string().optional().describe("Sort field: 'latest.cost.tuition.out_of_state:desc', 'latest.earnings.10_yrs_after_entry.median:desc', 'latest.completion.rate_suppressed.overall:desc'"),
+            per_page: z.number().int().max(100).optional().describe("Results per page (default 20, max 100)"),
+        }),
+        execute: async ({ name, state, ownership, sort, per_page }) => {
+            const data = await searchSchools({ name, state, ownership, sort, perPage: per_page });
+            if (!data.results?.length)
+                return `No schools found${name ? ` matching "${name}"` : ""}.`;
+            return JSON.stringify({
+                summary: `College Scorecard: ${data.metadata.total} schools found, showing ${data.results.length}`,
+                total: data.metadata.total,
+                schools: data.results.map(formatSchool),
+            });
+        },
+    },
+    {
+        name: "scorecard_compare",
+        description: "Compare specific colleges side-by-side on cost, graduation rate, earnings, and debt.\n" +
+            "Provide school names to search and compare.",
+        annotations: { title: "College Scorecard: Compare Schools", readOnlyHint: true },
+        parameters: z.object({
+            schools: z.string().describe("Comma-separated school names to compare: 'Harvard,MIT,Stanford' or 'Ohio State,Michigan'"),
+        }),
+        execute: async ({ schools }) => {
+            const names = schools.split(",").map((s) => s.trim()).filter(Boolean);
+            const results = await Promise.all(names.map(async (n) => {
+                const data = await searchSchools({ name: n, perPage: 1 });
+                return data.results?.[0] ? formatSchool(data.results[0]) : { name: n, error: "Not found" };
+            }));
+            return JSON.stringify({
+                summary: `Comparing ${results.length} schools`,
+                schools: results,
+            });
+        },
+    },
+    {
+        name: "scorecard_top",
+        description: "Get top-ranked colleges by earnings, graduation rate, or lowest cost.\n" +
+            "Rankings: 'earnings' (highest median pay 10yr after entry), 'graduation' (highest completion rate), 'expensive' (highest tuition)",
+        annotations: { title: "College Scorecard: Rankings", readOnlyHint: true },
+        parameters: z.object({
+            ranking: z.string().describe("'earnings' (highest pay), 'graduation' (highest grad rate), 'expensive' (highest cost)"),
+            state: z.string().optional().describe("Filter to state: 'CA', 'NY', 'TX'"),
+            ownership: z.number().int().optional().describe("1=Public, 2=Private nonprofit, 3=Private for-profit"),
+            per_page: z.number().int().max(100).optional().describe("Number of schools (default 20)"),
+        }),
+        execute: async ({ ranking, state, ownership, per_page }) => {
+            let data;
+            if (ranking === "earnings") {
+                data = await getHighestEarners({ ownership, perPage: per_page });
+            }
+            else if (ranking === "graduation") {
+                data = await getHighestGraduationRates({ state, perPage: per_page });
+            }
+            else if (ranking === "expensive") {
+                data = await getMostExpensive({ ownership, perPage: per_page });
+            }
+            else {
+                data = await getHighestEarners({ ownership, perPage: per_page });
+            }
+            if (!data.results?.length)
+                return `No schools found for "${ranking}" ranking.`;
+            return JSON.stringify({
+                summary: `Top schools by ${ranking}: ${data.results.length} schools`,
+                ranking,
+                schools: data.results.map(formatSchool),
+            });
+        },
+    },
+    {
+        name: "scorecard_query",
+        description: "Advanced College Scorecard query with custom field filters and ranges.\n\n" +
+            "Filter examples:\n" +
+            "- 'latest.admissions.admission_rate.overall__range=0..0.10' (schools with <10% admission rate)\n" +
+            "- 'latest.cost.tuition.in_state__range=..5000' (tuition under $5K)\n" +
+            "- 'school.degrees_awarded.predominant=3' (bachelor's-granting)\n" +
+            "- 'latest.earnings.10_yrs_after_entry.median__range=80000..' (high-earning graduates)",
+        annotations: { title: "College Scorecard: Advanced Query", readOnlyHint: true },
+        parameters: z.object({
+            filters: z.string().describe("Semicolon-separated filter params: 'school.state=CA;latest.admissions.admission_rate.overall__range=0..0.20;school.degrees_awarded.predominant=3'"),
+            sort: z.string().optional().describe("Sort: 'latest.earnings.10_yrs_after_entry.median:desc'"),
+            per_page: z.number().int().max(100).optional().describe("Results per page (default 20)"),
+        }),
+        execute: async ({ filters, sort, per_page }) => {
+            const params = {};
+            for (const f of filters.split(";")) {
+                const [key, ...rest] = f.split("=");
+                if (key && rest.length)
+                    params[key.trim()] = rest.join("=").trim();
+            }
+            if (sort)
+                params.sort = sort;
+            if (per_page)
+                params.per_page = per_page;
+            const data = await querySchools(params);
+            if (!data.results?.length)
+                return "No schools found matching the filters.";
+            return JSON.stringify({
+                summary: `College Scorecard query: ${data.metadata.total} schools found, showing ${data.results.length}`,
+                total: data.metadata.total,
+                schools: data.results.map(formatSchool),
+            });
+        },
+    },
+];
+// ─── Prompts ─────────────────────────────────────────────────────────
+export const prompts = [
+    {
+        name: "college_roi",
+        description: "Analyze the return on investment of college — compare costs, debt, and earnings across school types.",
+        load: async () => "Analyze college ROI using the College Scorecard:\n\n" +
+            "1. Use scorecard_top ranking='earnings' per_page=10 — schools with highest post-grad earnings\n" +
+            "2. Use scorecard_top ranking='expensive' per_page=10 — most expensive schools\n" +
+            "3. Use scorecard_search ownership=1 sort='latest.earnings.10_yrs_after_entry.median:desc' per_page=10 — top public schools by earnings\n" +
+            "4. Use scorecard_search ownership=2 sort='latest.earnings.10_yrs_after_entry.median:desc' per_page=10 — top private nonprofit by earnings\n\n" +
+            "Compare: tuition vs earnings, debt vs earnings ratio, public vs private ROI. " +
+            "Cross-reference with FRED (SLOAS — student loan debt outstanding) and BLS (employment by education level).",
+    },
+];
+export { clearCache } from "../sdk/college-scorecard.js";
+//# sourceMappingURL=college-scorecard.js.map

package/dist/modules/college-scorecard.js.map

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

package/dist/modules/congress.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Congress.gov MCP module — tools + metadata. Delegates all API calls to sdk/congress.
+ *
+ * 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 = "congress";
+export declare const displayName = "Congress.gov";
+export declare const description = "Bills, votes, members, laws, amendments, and committee data from Congress.gov. House votes use Congress.gov API (118th+) with clerk.house.gov fallback (1990+). Senate votes from senate.gov (101st/1989+).";
+export declare const auth: {
+    envVar: string;
+    signup: string;
+};
+export declare const workflow = "congress_search_bills \u2192 congress_bill_details for sponsors/cosponsors/status \u2192 congress_house_votes or congress_senate_votes for party-line breakdown \u2192 cross-reference with FEC (donors), lobbying_search (who lobbied), and FRED (economic impact)";
+export declare const tips = "Congress numbers: 119th (2025-2026), 118th (2023-2024), 117th (2021-2022). Bill types: hr, s, hjres, sjres, hconres, sconres, hres, sres. House votes: use year param for historical (1990+). Senate votes: 101st Congress (1989) to present. Always compare House and Senate votes on the same bill to reveal bicameral differences. For accountability investigations: use congress_member_details to get committee assignments (e.g. Banking Committee chair), then congress_senate_votes/congress_house_votes for party-line breakdown, then cross-reference with FEC disbursements and lobbying spend.";
+export declare const reference: {
+    billTypes: Record<string, string>;
+    congressNumbers: Record<number, string>;
+    docs: {
+        "API Docs": string;
+        "Interactive Docs": string;
+        "Sign Up": string;
+    };
+};
+export declare const tools: Tool<any, any>[];
+export { clearCache } from "../sdk/congress.js";
+export declare const prompts: InputPrompt<any, any>[];
+//# sourceMappingURL=congress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"congress.d.ts","sourceRoot":"","sources":["../../src/modules/congress.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAsDjD,eAAO,MAAM,IAAI,aAAa,CAAC;AAC/B,eAAO,MAAM,WAAW,iBAAiB,CAAC;AAC1C,eAAO,MAAM,WAAW,gNAAgN,CAAC;AACzO,eAAO,MAAM,IAAI;;;CAAyE,CAAC;AAC3F,eAAO,MAAM,QAAQ,wQAAyP,CAAC;AAC/Q,eAAO,MAAM,IAAI,glBAAglB,CAAC;AAElmB,eAAO,MAAM,SAAS;eAMf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;qBAItB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;CAM5B,CAAC;AAkEF,eAAO,MAAM,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAozBjC,CAAC;AAIF,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,eAAO,MAAM,OAAO,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAgC1C,CAAC"}