us-gov-open-data-mcp 1.0.0

package/dist/modules/congress.js

@@ -0,0 +1,883 @@
+/**
+ * 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 { z } from "zod";
+import { searchBills, getBillDetails, searchMembers, getHouseVotes, getSenateVotes, getRecentLaws, getMemberBills, getBillActions, getBillAmendments, getBillCommittees, getBillRelatedBills, getBillSubjects, getBillSummaries, getBillTextVersions, getMemberDetails, searchAmendments, getAmendmentDetails, listCommittees, getCommitteeBills, listNominations, getNominationDetails, listTreaties, getTreatyDetails, searchCrsReports, getCongressionalRecord, currentCongress, billTypeToUrlSegment, } from "../sdk/congress.js";
+// ─── Metadata (server.ts reads these) ────────────────────────────────
+export const name = "congress";
+export const displayName = "Congress.gov";
+export 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 const auth = { envVar: "DATA_GOV_API_KEY", signup: "https://api.data.gov/signup/" };
+export const workflow = "congress_search_bills → congress_bill_details for sponsors/cosponsors/status → congress_house_votes or congress_senate_votes for party-line breakdown → cross-reference with FEC (donors), lobbying_search (who lobbied), and FRED (economic impact)";
+export 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 const reference = {
+    billTypes: {
+        hr: "House Bill", s: "Senate Bill",
+        hjres: "House Joint Resolution", sjres: "Senate Joint Resolution",
+        hconres: "House Concurrent Resolution", sconres: "Senate Concurrent Resolution",
+        hres: "House Simple Resolution", sres: "Senate Simple Resolution",
+    },
+    congressNumbers: {
+        119: "2025-2026", 118: "2023-2024", 117: "2021-2022",
+        116: "2019-2020", 115: "2017-2018", 114: "2015-2016",
+    },
+    docs: {
+        "API Docs": "https://api.congress.gov/",
+        "Interactive Docs": "https://api.congress.gov/#/",
+        "Sign Up": "https://api.congress.gov/sign-up/",
+    },
+};
+// ─── Helpers ─────────────────────────────────────────────────────────
+function summarizeBill(b) {
+    return {
+        type: b.type ?? null,
+        number: b.number ?? null,
+        title: b.title ?? null,
+        congress: b.congress ?? null,
+        introducedDate: b.introducedDate ?? null,
+        sponsor: b.sponsor ? { name: b.sponsor.name, party: b.sponsor.party, state: b.sponsor.state } : null,
+        latestAction: b.latestAction ? { text: b.latestAction.text, date: b.latestAction.actionDate } : null,
+        url: b.url ?? null,
+    };
+}
+function summarizeMember(m) {
+    return {
+        name: m.name ?? (m.firstName && m.lastName ? `${m.firstName} ${m.lastName}` : null),
+        party: m.partyName ?? m.party ?? null,
+        state: m.state ?? null,
+        chamber: m.chamber ?? null,
+        district: m.district ?? null,
+        bioguideId: m.bioguideId ?? null,
+        startYear: m.startYear ?? null,
+        endYear: m.endYear ?? null,
+    };
+}
+function summarizeVote(v) {
+    return {
+        voteNumber: v.rollCallNumber ?? v.voteNumber ?? null,
+        date: v.startDate ?? v.date ?? null,
+        question: v.voteQuestion ?? v.question ?? null,
+        result: v.result ?? null,
+        voteType: v.voteType ?? null,
+        legislation: v.legislationType && v.legislationNumber
+            ? { type: v.legislationType, number: v.legislationNumber, url: v.legislationUrl }
+            : v.bill ? { type: v.bill.type, number: v.bill.number, title: v.bill.title } : null,
+    };
+}
+function summarizeLaw(l) {
+    return {
+        type: l.type ?? null,
+        number: l.number ?? null,
+        title: l.title ?? null,
+        signedDate: l.latestAction?.actionDate ?? null,
+        url: l.url ?? null,
+    };
+}
+function summarizeSponsoredBill(b) {
+    return {
+        type: b.type ?? null,
+        number: b.number ?? null,
+        title: b.title ?? null,
+        congress: b.congress ?? null,
+        introducedDate: b.introducedDate ?? null,
+        latestAction: b.latestAction ? { text: b.latestAction.text, date: b.latestAction.actionDate } : null,
+    };
+}
+// ─── Tools ───────────────────────────────────────────────────────────
+export const tools = [
+    {
+        name: "congress_search_bills",
+        description: "Search for bills in Congress by keyword, congress number, or bill type. " +
+            "Returns bill number, title, sponsor, latest action, and status.\n\n" +
+            "Congress numbers: 118th (2023-2024), 119th (2025-2026), 117th (2021-2022).\n" +
+            "Bill types: hr (House), s (Senate), hjres, sjres, hconres, sconres, hres, sres",
+        annotations: { title: "Congress: Search Bills", readOnlyHint: true },
+        parameters: z.object({
+            query: z.string().optional().describe("Keyword/text search across bill titles and summaries (e.g., 'infrastructure', 'tax reform', 'climate')"),
+            congress: z.number().int().optional().describe("Congress number (e.g., 119 for 2025-2026, 118 for 2023-2024). Default: current"),
+            bill_type: z.string().optional().describe("Bill type: 'hr', 's', 'hjres', 'sjres', 'hconres', 'sconres', 'hres', 'sres'"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+            offset: z.number().int().optional().describe("Results offset for pagination (default: 0)"),
+        }),
+        execute: async ({ query, congress, bill_type, limit, offset }) => {
+            const data = await searchBills({ query, congress, bill_type, limit, offset });
+            const bills = data.bills;
+            if (!bills.length) {
+                return JSON.stringify({ summary: query ? `No bills found matching "${query}".` : "No bills found.", bills: [] });
+            }
+            return JSON.stringify({
+                summary: `Bill search${query ? ` "${query}"` : ""}${congress ? ` (${congress}th Congress)` : ""}: ${bills.length} results`,
+                bills: bills.map(summarizeBill),
+            });
+        },
+    },
+    {
+        name: "congress_bill_details",
+        description: "Get detailed information about a specific bill including sponsors, cosponsors with party breakdown, " +
+            "actions, committees, and current status.",
+        annotations: { title: "Congress: Bill Details", 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, 25, 3076)"),
+        }),
+        execute: async ({ congress, bill_type, bill_number }) => {
+            const { bill, cosponsors, cosponsorPartyBreakdown } = await getBillDetails(congress, bill_type, bill_number);
+            const sponsors = bill.sponsors;
+            const sponsor = sponsors?.[0];
+            return JSON.stringify({
+                summary: `${bill.type ?? ""}${bill.number ?? ""}: ${bill.title ?? "No title"} (${congress}th Congress)`,
+                congress,
+                type: bill.type ?? null,
+                number: bill.number ?? null,
+                title: bill.title ?? null,
+                introducedDate: bill.introducedDate ?? null,
+                sponsor: sponsor ? {
+                    name: `${sponsor.firstName ?? ""} ${sponsor.lastName ?? ""}`.trim(),
+                    party: sponsor.party ?? null,
+                    state: sponsor.state ?? null,
+                } : null,
+                cosponsors: {
+                    total: cosponsors.length,
+                    partyBreakdown: cosponsorPartyBreakdown,
+                },
+                policyArea: bill.policyArea?.name ?? null,
+                latestAction: bill.latestAction ? { text: bill.latestAction.text, date: bill.latestAction.actionDate } : null,
+                laws: bill.laws?.map(l => ({ type: l.type, number: l.number })) ?? [],
+                congressGovUrl: `https://www.congress.gov/bill/${congress}th-congress/${billTypeToUrlSegment(bill_type)}/${bill_number}`,
+            });
+        },
+    },
+    {
+        name: "congress_search_members",
+        description: "Search for members of Congress by state, congress number, or get all current members.",
+        annotations: { title: "Congress: Search Members", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current)"),
+            state: z.string().optional().describe("Two-letter state code to filter by, e.g. 'CA', 'TX'"),
+            district: z.number().int().optional().describe("House district number (use with state)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 50)"),
+        }),
+        execute: async ({ congress, state, district, limit }) => {
+            const data = await searchMembers({ congress, state, district, limit });
+            const members = data.members;
+            if (!members.length) {
+                return JSON.stringify({ summary: "No members found.", members: [] });
+            }
+            return JSON.stringify({
+                summary: `Members of Congress: ${members.length} results${state ? ` (${state.toUpperCase()})` : ""}`,
+                members: members.map(summarizeMember),
+            });
+        },
+    },
+    {
+        name: "congress_house_votes",
+        description: "Get House of Representatives roll call vote results with member-level party breakdown. " +
+            "Primary source: Congress.gov API (118th-119th Congress); falls back to clerk.house.gov XML for older congresses. " +
+            "Coverage: 1990 to present. Use year param for historical votes. " +
+            "Cross-reference with: congress_senate_votes (same bill's Senate vote), FEC (congress_member donors via fec_candidate_financials), " +
+            "lobbying_search (who lobbied on the bill), FRED (economic impact 1-3 years after passage). " +
+            "For Senate votes, use congress_senate_votes.",
+        annotations: { title: "Congress: House Roll Call Votes", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current). Used with session to determine year."),
+            session: z.number().int().optional().describe("Session (1 or 2). Default: current session"),
+            year: z.number().int().optional().describe("Calendar year (e.g. 2024). Overrides congress+session if provided."),
+            vote_number: z.number().int().optional().describe("Specific roll call vote number. Omit to list recent votes."),
+            limit: z.number().int().positive().max(250).optional().describe("Max results when listing votes (default: 20)"),
+        }),
+        execute: async ({ congress, session, year, vote_number, limit }) => {
+            const data = await getHouseVotes({ congress, session, year, vote_number, limit });
+            const congressNum = congress ?? currentCongress();
+            // Specific vote with member breakdown
+            if (data.members && data.partyTally) {
+                return JSON.stringify({
+                    summary: `House Vote #${vote_number} (${congressNum}th Congress, Session ${session}): ${data.members.length} members voting`,
+                    congress: congressNum,
+                    session,
+                    voteNumber: vote_number,
+                    totalVoting: data.members.length,
+                    partyBreakdown: data.partyTally,
+                });
+            }
+            // Specific vote without member breakdown (fallback)
+            if (data.vote) {
+                const v = data.vote;
+                return JSON.stringify({
+                    summary: `House Vote #${vote_number} (${congressNum}th Congress): ${v.result ?? "Unknown result"}`,
+                    congress: congressNum,
+                    session,
+                    voteNumber: vote_number,
+                    question: v.question ?? null,
+                    description: v.description ?? null,
+                    result: v.result ?? null,
+                    date: v.date ?? null,
+                    bill: v.bill ? { type: v.bill.type, number: v.bill.number } : null,
+                });
+            }
+            // List of recent votes
+            const votes = data.votes ?? [];
+            if (!votes.length) {
+                return JSON.stringify({ summary: "No House votes found.", votes: [] });
+            }
+            return JSON.stringify({
+                summary: `House votes (${congressNum}th Congress${session ? `, Session ${session}` : ""}): ${votes.length} results`,
+                congress: congressNum,
+                votes: votes.map(summarizeVote),
+            });
+        },
+    },
+    {
+        name: "congress_senate_votes",
+        description: "Get Senate roll call vote results from senate.gov XML. " +
+            "Shows how senators voted by party on specific legislation, nominations, and procedural motions. " +
+            "Coverage: 101st Congress (1989) to present. " +
+            "Cross-reference with: congress_house_votes (same bill's House vote), FEC (senator donors via fec_candidate_financials), " +
+            "lobbying_search (who lobbied on the bill), congress_member_bills (senator's voting vs sponsoring patterns). " +
+            "For House votes, use congress_house_votes.",
+        annotations: { title: "Congress: Senate Roll Call Votes", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current). Coverage: 101st (1989) to present"),
+            session: z.number().int().optional().describe("Session (1 or 2). Default: current session (1 for odd years, 2 for even)"),
+            vote_number: z.number().int().optional().describe("Specific roll call vote number. Omit to list recent votes."),
+            limit: z.number().int().positive().max(250).optional().describe("Max results when listing votes (default: 20)"),
+        }),
+        execute: async ({ congress, session, vote_number, limit }) => {
+            const data = await getSenateVotes({ congress, session, vote_number, limit });
+            const congressNum = congress ?? currentCongress();
+            const sessionNum = session ?? (new Date().getFullYear() % 2 === 1 ? 1 : 2);
+            // Specific vote with member breakdown
+            if (data.members && data.partyTally && data.vote) {
+                return JSON.stringify({
+                    summary: `Senate Vote #${vote_number} (${congressNum}th Congress, Session ${sessionNum}): ${data.vote.result} — ${data.members.length} senators voting`,
+                    congress: congressNum,
+                    session: sessionNum,
+                    voteNumber: vote_number,
+                    question: data.vote.question,
+                    result: data.vote.result,
+                    title: data.vote.title,
+                    date: data.vote.date,
+                    majorityRequired: data.vote.majorityRequired,
+                    count: data.vote.count,
+                    document: data.vote.document ?? null,
+                    tieBreaker: data.vote.tieBreaker ?? null,
+                    totalVoting: data.members.length,
+                    partyBreakdown: data.partyTally,
+                });
+            }
+            // List of recent votes
+            const votes = data.votes ?? [];
+            if (!votes.length) {
+                return JSON.stringify({ summary: "No Senate votes found.", votes: [] });
+            }
+            return JSON.stringify({
+                summary: `Senate votes (${congressNum}th Congress, Session ${sessionNum}): ${votes.length} results`,
+                congress: congressNum,
+                session: sessionNum,
+                votes: votes.map((v) => ({
+                    voteNumber: v.voteNumber,
+                    date: v.date,
+                    question: v.question,
+                    result: v.result,
+                    title: v.title,
+                    issue: v.description,
+                    count: v.count,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_recent_laws",
+        description: "Get recently enacted laws (bills signed by the President). " +
+            "Shows what legislation has become law.",
+        annotations: { title: "Congress: Recent Laws", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ congress, limit }) => {
+            const congressNum = congress ?? currentCongress();
+            const data = await getRecentLaws({ congress, limit });
+            const laws = data.laws;
+            if (!laws.length) {
+                return JSON.stringify({ summary: `No laws found for the ${congressNum}th Congress.`, laws: [] });
+            }
+            return JSON.stringify({
+                summary: `Laws enacted (${congressNum}th Congress): ${laws.length} results`,
+                congress: congressNum,
+                laws: laws.map(summarizeLaw),
+            });
+        },
+    },
+    {
+        name: "congress_member_bills",
+        description: "Get bills sponsored or cosponsored by a specific member of Congress. " +
+            "Requires the member's BioGuide ID (use congress_search_members to find it).",
+        annotations: { title: "Congress: Member's Sponsored Bills", readOnlyHint: true },
+        parameters: z.object({
+            bioguide_id: z.string().describe("Member's BioGuide ID (e.g., 'S000033' for Bernie Sanders, 'C001098' for Ted Cruz)"),
+            type: z.string().optional().describe("'sponsored' (default) or 'cosponsored'"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ bioguide_id, type, limit }) => {
+            const legType = (type === "cosponsored" ? "cosponsored" : "sponsored");
+            const data = await getMemberBills(bioguide_id, legType, limit ?? 20);
+            const bills = data.bills;
+            if (!bills.length) {
+                return JSON.stringify({ summary: `No ${legType} legislation found for member ${bioguide_id}.`, bioguideId: bioguide_id, bills: [] });
+            }
+            return JSON.stringify({
+                summary: `${legType === "cosponsored" ? "Cosponsored" : "Sponsored"} legislation for ${bioguide_id}: ${bills.length} results`,
+                bioguideId: bioguide_id,
+                type: legType,
+                bills: bills.map(summarizeSponsoredBill),
+            });
+        },
+    },
+    // ─── Bill Sub-resource Tools ─────────────────────────────────────
+    {
+        name: "congress_bill_actions",
+        description: "Get the full action history / timeline for a bill — every step from introduction through committee, " +
+            "floor votes, amendments, and signing. Shows recorded roll-call vote numbers when available.\n\n" +
+            "Use congress_search_bills first to find the congress number, bill type, and bill number.",
+        annotations: { title: "Congress: Bill Actions/Timeline", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number (e.g., 118)"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', 'hjres', 'sjres', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+            limit: z.number().int().positive().max(250).optional().describe("Max actions to return (default: 100)"),
+        }),
+        execute: async ({ congress, bill_type, bill_number, limit }) => {
+            const data = await getBillActions(congress, billTypeToUrlSegment(bill_type), bill_number, limit ?? 100);
+            if (!data.actions.length) {
+                return JSON.stringify({ summary: `No actions found for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, actions: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.actions.length} actions`,
+                actions: data.actions.map(a => ({
+                    date: a.actionDate ?? null,
+                    text: a.text ?? null,
+                    type: a.type ?? null,
+                    actionCode: a.actionCode ?? null,
+                    sourceSystem: a.sourceSystem?.name ?? null,
+                    committees: a.committees?.map(c => c.name) ?? null,
+                    recordedVotes: a.recordedVotes?.map(rv => ({ rollNumber: rv.rollNumber, chamber: rv.chamber, date: rv.date })) ?? null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_bill_amendments",
+        description: "Get amendments filed on a specific bill. Shows amendment sponsors, " +
+            "purposes, and status. Critical for tracking how bills are modified (e.g., 'gutted and replaced').",
+        annotations: { title: "Congress: Bill Amendments", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', 'hjres', 'sjres', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 50)"),
+        }),
+        execute: async ({ congress, bill_type, bill_number, limit }) => {
+            const data = await getBillAmendments(congress, billTypeToUrlSegment(bill_type), bill_number, limit ?? 50);
+            if (!data.amendments.length) {
+                return JSON.stringify({ summary: `No amendments found for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, amendments: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.amendments.length} amendments`,
+                amendments: data.amendments.map(a => ({
+                    number: a.number ?? null,
+                    type: a.type ?? null,
+                    congress: a.congress ?? null,
+                    description: a.description ?? null,
+                    purpose: a.purpose ?? null,
+                    sponsor: a.sponsor ? { name: `${a.sponsor.firstName ?? ""} ${a.sponsor.lastName ?? ""}`.trim(), party: a.sponsor.party, state: a.sponsor.state, bioguideId: a.sponsor.bioguideId } : null,
+                    latestAction: a.latestAction ? { text: a.latestAction.text, date: a.latestAction.actionDate } : null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_bill_summaries",
+        description: "Get CRS (Congressional Research Service) summaries of a bill. " +
+            "These are plain-English, non-partisan summaries written by CRS analysts. " +
+            "Multiple versions may exist (as introduced, as reported, as passed).",
+        annotations: { title: "Congress: Bill Summaries", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+        }),
+        execute: async ({ congress, bill_type, bill_number }) => {
+            const data = await getBillSummaries(congress, billTypeToUrlSegment(bill_type), bill_number);
+            if (!data.summaries.length) {
+                return JSON.stringify({ summary: `No CRS summaries available for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, summaries: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.summaries.length} CRS summaries`,
+                summaries: data.summaries.map(s => ({
+                    versionCode: s.versionCode ?? null,
+                    actionDate: s.actionDate ?? null,
+                    actionDesc: s.actionDesc ?? null,
+                    text: s.text ?? null,
+                    updateDate: s.updateDate ?? null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_bill_text",
+        description: "Get available text versions for a bill (e.g., introduced, reported, engrossed, enrolled). " +
+            "Returns version types and format URLs. For full bill text content, use govinfo_bill_text.",
+        annotations: { title: "Congress: Bill Text Versions", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+        }),
+        execute: async ({ congress, bill_type, bill_number }) => {
+            const data = await getBillTextVersions(congress, billTypeToUrlSegment(bill_type), bill_number);
+            if (!data.textVersions.length) {
+                return JSON.stringify({ summary: `No text versions found for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, textVersions: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.textVersions.length} text versions`,
+                textVersions: data.textVersions.map(t => ({
+                    type: t.type ?? null,
+                    date: t.date ?? null,
+                    formats: t.formats?.map(f => ({ type: f.type, url: f.url })) ?? null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_bill_related",
+        description: "Find related/companion bills. Identifies House-Senate companion bills, " +
+            "identical bills, and bills with related provisions. Useful for tracking legislation across chambers.",
+        annotations: { title: "Congress: Related Bills", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 50)"),
+        }),
+        execute: async ({ congress, bill_type, bill_number, limit }) => {
+            const data = await getBillRelatedBills(congress, billTypeToUrlSegment(bill_type), bill_number, limit ?? 50);
+            if (!data.relatedBills.length) {
+                return JSON.stringify({ summary: `No related bills found for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, relatedBills: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.relatedBills.length} related bills`,
+                relatedBills: data.relatedBills.map(r => ({
+                    type: r.type ?? null,
+                    number: r.number ?? null,
+                    congress: r.congress ?? null,
+                    title: r.title ?? null,
+                    relationship: r.relationshipDetails?.map(rd => rd.type) ?? null,
+                    latestAction: r.latestAction ? { text: r.latestAction.text, date: r.latestAction.actionDate } : null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_bill_subjects",
+        description: "Get legislative subjects tagged on a bill, plus the primary policy area. " +
+            "Useful for finding all bills on a topic and for cross-referencing with lobbying data.",
+        annotations: { title: "Congress: Bill Subjects", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 100)"),
+        }),
+        execute: async ({ congress, bill_type, bill_number, limit }) => {
+            const data = await getBillSubjects(congress, billTypeToUrlSegment(bill_type), bill_number, limit ?? 100);
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): ${data.subjects.length} subjects${data.policyArea ? `, policy area: ${data.policyArea}` : ""}`,
+                policyArea: data.policyArea ?? null,
+                subjects: data.subjects.map(s => s.name),
+            });
+        },
+    },
+    {
+        name: "congress_bill_committees",
+        description: "Get committees a bill was referred to, with activity dates. " +
+            "Shows which committees had jurisdiction and what actions they took (referral, hearings, markup, reporting).",
+        annotations: { title: "Congress: Bill Committees", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            bill_type: z.string().describe("Bill type: 'hr', 's', etc."),
+            bill_number: z.number().int().describe("Bill number"),
+        }),
+        execute: async ({ congress, bill_type, bill_number }) => {
+            const data = await getBillCommittees(congress, billTypeToUrlSegment(bill_type), bill_number);
+            if (!data.committees.length) {
+                return JSON.stringify({ summary: `No committee data for ${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress).`, committees: [] });
+            }
+            return JSON.stringify({
+                summary: `${bill_type.toUpperCase()} ${bill_number} (${congress}th Congress): referred to ${data.committees.length} committees`,
+                committees: data.committees.map(c => ({
+                    name: c.name ?? null,
+                    systemCode: c.systemCode ?? null,
+                    chamber: c.chamber ?? null,
+                    type: c.type ?? null,
+                    activities: c.activities?.map(a => ({ name: a.name, date: a.date })) ?? null,
+                })),
+            });
+        },
+    },
+    // ─── Member Details ──────────────────────────────────────────────
+    {
+        name: "congress_member_details",
+        description: "Get detailed information about a specific member of Congress by BioGuide ID. " +
+            "Returns full bio, party history, all terms served, committee assignments, photo URL, and official website.\n\n" +
+            "Use congress_search_members first to find the BioGuide ID.",
+        annotations: { title: "Congress: Member Details", readOnlyHint: true },
+        parameters: z.object({
+            bioguide_id: z.string().describe("BioGuide ID (e.g., 'P000197' for Pelosi, 'M000355' for McConnell)"),
+        }),
+        execute: async ({ bioguide_id }) => {
+            const data = await getMemberDetails(bioguide_id);
+            const m = data.member;
+            return JSON.stringify({
+                summary: `${m.directOrderName ?? m.invertedOrderName ?? `${m.firstName} ${m.lastName}`} (${m.party ?? "Unknown"}-${m.state ?? "?"})`,
+                bioguideId: m.bioguideId ?? bioguide_id,
+                name: m.directOrderName ?? `${m.firstName ?? ""} ${m.lastName ?? ""}`.trim(),
+                party: m.party ?? null,
+                state: m.state ?? null,
+                birthYear: m.birthYear ?? null,
+                deathYear: m.deathYear ?? null,
+                currentMember: m.currentMember ?? null,
+                officialWebsiteUrl: m.officialWebsiteUrl ?? null,
+                depiction: m.depiction ?? null,
+                partyHistory: m.partyHistory ?? null,
+                terms: m.terms ?? null,
+            });
+        },
+    },
+    // ─── Committees ──────────────────────────────────────────────────
+    {
+        name: "congress_committees",
+        description: "List congressional committees. Filter by congress number and/or chamber (house, senate, joint). " +
+            "Returns committee name, system code, and chamber.",
+        annotations: { title: "Congress: List Committees", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (e.g., 119). Default: current"),
+            chamber: z.string().optional().describe("Chamber: 'house', 'senate', or 'joint'"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 50)"),
+        }),
+        execute: async ({ congress, chamber, limit }) => {
+            const data = await listCommittees({ congress, chamber, limit });
+            if (!data.committees.length) {
+                return JSON.stringify({ summary: "No committees found matching criteria.", committees: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.committees.length} committees${congress ? ` (${congress}th Congress)` : ""}${chamber ? ` — ${chamber}` : ""}`,
+                committees: data.committees.map(c => ({
+                    name: c.name ?? null,
+                    systemCode: c.systemCode ?? null,
+                    chamber: c.chamber ?? null,
+                    type: c.type ?? null,
+                    isCurrent: c.isCurrent ?? null,
+                    subcommittees: c.subcommittees?.map(sc => sc.name) ?? null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_committee_bills",
+        description: "Get bills referred to a specific committee. Use congress_committees to find the committee system code. " +
+            "Useful for tracking which bills die in committee vs. get reported out.",
+        annotations: { title: "Congress: Committee Bills", readOnlyHint: true },
+        parameters: z.object({
+            chamber: z.string().describe("Chamber: 'house', 'senate', or 'joint'"),
+            committee_code: z.string().describe("Committee system code (e.g., 'hsba00' for House Financial Services, 'ssfi00' for Senate Finance)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ chamber, committee_code, limit }) => {
+            const data = await getCommitteeBills(chamber, committee_code, limit ?? 20);
+            if (!data.bills.length) {
+                return JSON.stringify({ summary: `No bills found for committee ${committee_code}.`, bills: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.bills.length} bills referred to committee ${committee_code}`,
+                committee: committee_code,
+                bills: data.bills.map(summarizeBill),
+            });
+        },
+    },
+    // ─── Amendments ──────────────────────────────────────────────────
+    {
+        name: "congress_amendments",
+        description: "Search/list amendments by congress and optional type (hamdt = House, samdt = Senate, suamdt = Senate Unnumbered). " +
+            "Returns amendment number, type, sponsor, purpose, and status.",
+        annotations: { title: "Congress: Search Amendments", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current)"),
+            amendment_type: z.string().optional().describe("Amendment type: 'hamdt' (House), 'samdt' (Senate), 'suamdt' (Senate Unnumbered)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ congress, amendment_type, limit }) => {
+            const data = await searchAmendments({ congress, amendmentType: amendment_type, limit });
+            if (!data.amendments.length) {
+                return JSON.stringify({ summary: "No amendments found.", amendments: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.amendments.length} amendments${congress ? ` (${congress}th Congress)` : ""}`,
+                amendments: data.amendments.map(a => ({
+                    number: a.number ?? null,
+                    type: a.type ?? null,
+                    congress: a.congress ?? null,
+                    description: a.description ?? null,
+                    purpose: a.purpose ?? null,
+                    latestAction: a.latestAction ? { text: a.latestAction.text, date: a.latestAction.actionDate } : null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_amendment_details",
+        description: "Get detailed information about a specific amendment, including its actions/timeline. " +
+            "Requires congress number, amendment type (hamdt/samdt), and amendment number.",
+        annotations: { title: "Congress: Amendment Details", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            amendment_type: z.string().describe("'hamdt' (House) or 'samdt' (Senate)"),
+            amendment_number: z.union([z.string(), z.number()]).describe("Amendment number"),
+        }),
+        execute: async ({ congress, amendment_type, amendment_number }) => {
+            const data = await getAmendmentDetails(congress, amendment_type, amendment_number);
+            const a = data.amendment;
+            return JSON.stringify({
+                summary: `${amendment_type.toUpperCase()} ${amendment_number} (${congress}th Congress)`,
+                amendment: {
+                    number: a.number ?? null,
+                    type: a.type ?? null,
+                    congress: a.congress ?? null,
+                    description: a.description ?? null,
+                    purpose: a.purpose ?? null,
+                    sponsor: a.sponsor ? { name: `${a.sponsor.firstName ?? ""} ${a.sponsor.lastName ?? ""}`.trim(), party: a.sponsor.party, state: a.sponsor.state, bioguideId: a.sponsor.bioguideId } : null,
+                    latestAction: a.latestAction ? { text: a.latestAction.text, date: a.latestAction.actionDate } : null,
+                },
+                actions: data.actions.map(act => ({
+                    date: act.actionDate ?? null,
+                    text: act.text ?? null,
+                    type: act.type ?? null,
+                })),
+            });
+        },
+    },
+    // ─── Nominations ─────────────────────────────────────────────────
+    {
+        name: "congress_nominations",
+        description: "List presidential nominations to federal offices (judges, cabinet, ambassadors, agency heads). " +
+            "Shows nominee name, position, organization, and confirmation status.",
+        annotations: { title: "Congress: Nominations", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: current)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ congress, limit }) => {
+            const congressNum = congress ?? currentCongress();
+            const data = await listNominations({ congress, limit });
+            if (!data.nominations.length) {
+                return JSON.stringify({ summary: `No nominations found for ${congressNum}th Congress.`, nominations: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.nominations.length} nominations (${congressNum}th Congress)`,
+                nominations: data.nominations.map(n => ({
+                    number: n.number ?? null,
+                    congress: n.congress ?? null,
+                    description: n.description ?? null,
+                    organization: n.organization ?? null,
+                    receivedDate: n.receivedDate ?? null,
+                    nominees: n.nominees ?? null,
+                    latestAction: n.latestAction ? { text: n.latestAction.text, date: n.latestAction.actionDate } : null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_nomination_details",
+        description: "Get detailed information about a specific presidential nomination, including all actions (committee referral, hearing, vote, confirmation/rejection).",
+        annotations: { title: "Congress: Nomination Details", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress number"),
+            nomination_number: z.union([z.string(), z.number()]).describe("Nomination number (PN number)"),
+        }),
+        execute: async ({ congress, nomination_number }) => {
+            const data = await getNominationDetails(congress, nomination_number);
+            const n = data.nomination;
+            return JSON.stringify({
+                summary: `Nomination PN${nomination_number} (${congress}th Congress)`,
+                nomination: {
+                    number: n.number ?? null,
+                    congress: n.congress ?? null,
+                    description: n.description ?? null,
+                    organization: n.organization ?? null,
+                    receivedDate: n.receivedDate ?? null,
+                    nominees: n.nominees ?? null,
+                    latestAction: n.latestAction ? { text: n.latestAction.text, date: n.latestAction.actionDate } : null,
+                },
+                actions: data.actions.map(a => ({
+                    date: a.actionDate ?? null,
+                    text: a.text ?? null,
+                    type: a.type ?? null,
+                })),
+            });
+        },
+    },
+    // ─── Treaties ────────────────────────────────────────────────────
+    {
+        name: "congress_treaties",
+        description: "List treaties submitted to the Senate. Shows treaty topic, " +
+            "date transmitted, and ratification status.",
+        annotations: { title: "Congress: Treaties", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().optional().describe("Congress number (default: all)"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ congress, limit }) => {
+            const data = await listTreaties({ congress, limit });
+            if (!data.treaties.length) {
+                return JSON.stringify({ summary: "No treaties found.", treaties: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.treaties.length} treaties${congress ? ` (${congress}th Congress)` : ""}`,
+                treaties: data.treaties.map(t => ({
+                    number: t.number ?? null,
+                    suffix: t.suffix ?? null,
+                    congress: t.congress ?? null,
+                    topic: t.topic ?? null,
+                    transmittedDate: t.transmittedDate ?? null,
+                    inForceDate: t.inForceDate ?? null,
+                    latestAction: t.latestAction ? { text: t.latestAction.text, date: t.latestAction.actionDate } : null,
+                })),
+            });
+        },
+    },
+    {
+        name: "congress_treaty_details",
+        description: "Get detailed information about a specific treaty, including all Senate actions (committee referral, hearings, ratification vote).",
+        annotations: { title: "Congress: Treaty Details", readOnlyHint: true },
+        parameters: z.object({
+            congress: z.number().int().describe("Congress in which the treaty was received"),
+            treaty_number: z.union([z.string(), z.number()]).describe("Treaty document number"),
+        }),
+        execute: async ({ congress, treaty_number }) => {
+            const data = await getTreatyDetails(congress, treaty_number);
+            const t = data.treaty;
+            return JSON.stringify({
+                summary: `Treaty Doc. ${treaty_number} (${congress}th Congress): ${t.topic ?? "No topic"}`,
+                treaty: {
+                    number: t.number ?? null,
+                    suffix: t.suffix ?? null,
+                    congress: t.congress ?? null,
+                    congressReceived: t.congressReceived ?? null,
+                    topic: t.topic ?? null,
+                    transmittedDate: t.transmittedDate ?? null,
+                    inForceDate: t.inForceDate ?? null,
+                    resolutionText: t.resolutionText ?? null,
+                    latestAction: t.latestAction ? { text: t.latestAction.text, date: t.latestAction.actionDate } : null,
+                },
+                actions: data.actions.map(a => ({
+                    date: a.actionDate ?? null,
+                    text: a.text ?? null,
+                    type: a.type ?? null,
+                })),
+            });
+        },
+    },
+    // ─── CRS Reports ─────────────────────────────────────────────────
+    {
+        name: "congress_crs_reports",
+        description: "Get Congressional Research Service reports — authoritative, nonpartisan analysis on legislative topics. " +
+            "CRS reports are considered the gold standard for policy research.",
+        annotations: { title: "Congress: CRS Reports", readOnlyHint: true },
+        parameters: z.object({
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ limit }) => {
+            const data = await searchCrsReports({ limit });
+            if (!data.reports.length) {
+                return JSON.stringify({ summary: "No CRS reports found.", reports: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.reports.length} CRS reports`,
+                reports: data.reports.map(r => ({
+                    reportNumber: r.reportNumber ?? null,
+                    title: r.title ?? null,
+                    type: r.type ?? null,
+                    activeRecord: r.activeRecord ?? null,
+                })),
+            });
+        },
+    },
+    // ─── Congressional Record ────────────────────────────────────────
+    {
+        name: "congress_congressional_record",
+        description: "Get Congressional Record issues — the official daily record of debate, speeches, and proceedings in Congress. " +
+            "Filter by year, month, and day.",
+        annotations: { title: "Congress: Congressional Record", readOnlyHint: true },
+        parameters: z.object({
+            year: z.number().int().optional().describe("Year (e.g., 2024)"),
+            month: z.number().int().min(1).max(12).optional().describe("Month (1-12)"),
+            day: z.number().int().min(1).max(31).optional().describe("Day of month"),
+            limit: z.number().int().positive().max(250).optional().describe("Max results (default: 20)"),
+        }),
+        execute: async ({ year, month, day, limit }) => {
+            const data = await getCongressionalRecord({ year, month, day, limit });
+            if (!data.issues.length) {
+                return JSON.stringify({ summary: "No Congressional Record issues found.", issues: [] });
+            }
+            return JSON.stringify({
+                summary: `${data.issues.length} Congressional Record issues`,
+                issues: data.issues.map(i => ({
+                    issueNumber: i.issueNumber ?? null,
+                    volumeNumber: i.volumeNumber ?? null,
+                    issueDate: i.issueDate ?? null,
+                    congress: i.congress ?? null,
+                    sessionNumber: i.sessionNumber ?? null,
+                    url: i.url ?? null,
+                })),
+            });
+        },
+    },
+];
+// ─── Re-export cache control from SDK ────────────────────────────────
+export { clearCache } from "../sdk/congress.js";
+// ─── Prompts (FastMCP InputPrompt type) ──────────────────────────────
+export const prompts = [
+    {
+        name: "legislation_tracker",
+        description: "Track the status and details of a specific bill or recent legislation on a topic, with full cross-source analysis.",
+        arguments: [
+            { name: "topic", description: "Topic or bill name, e.g. 'CHIPS Act', 'border security', 'student loans'", required: true },
+        ],
+        load: async ({ topic }) => `Find and analyze legislation related to "${topic}".\n\n` +
+            `== LEGISLATION DETAILS ==\n` +
+            `1. Use congress_search_bills to find relevant bills (try current and recent congresses)\n` +
+            `2. For the most relevant bill(s), use congress_bill_details to get sponsors, cosponsors (with party breakdown), and status\n` +
+            `3. Use congress_bill_actions to see the full legislative timeline\n` +
+            `4. Use congress_bill_summaries for the CRS summary\n` +
+            `5. Use congress_bill_committees to see which committees handled the bill\n` +
+            `6. Check congress_bill_amendments to see if the bill was modified\n` +
+            `7. Use congress_bill_subjects to understand the policy areas\n` +
+            `8. Use congress_bill_related to find companion bills in the other chamber\n\n` +
+            `== VOTE ANALYSIS ==\n` +
+            `9. If the bill had a House vote, use congress_house_votes for party-line breakdown\n` +
+            `10. If the bill had a Senate vote, use congress_senate_votes for party-line breakdown\n` +
+            `11. Compare House and Senate votes to show bicameral alignment or divergence\n\n` +
+            `== CROSS-SOURCE CONNECTIONS ==\n` +
+            `12. If it became law, use congress_recent_laws to confirm\n` +
+            `13. Use lobbying_search to find who lobbied for/against this bill\n` +
+            `14. Use fec_search_candidates for top sponsors — check their top donors for potential connections\n` +
+            `15. If it affected spending, use usa_spending_over_time to see spending trends before/after\n` +
+            `16. Check Federal Register (fr_search_rules) for implementing regulations\n` +
+            `17. Use FRED series to check relevant economic indicators before and after passage\n\n` +
+            `Present a clear timeline: introduced → committee → floor vote → signed/vetoed.\n` +
+            `Always show party-line vote breakdown alongside donor/lobbying data for transparency.`,
+    },
+];
+//# sourceMappingURL=congress.js.map