@cyanheads/congressgov-mcp-server 0.3.3

package/dist/mcp-server/tools/definitions/crs-reports.tool.js

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview Tool for browsing and retrieving CRS policy analysis reports.
+ * @module mcp-server/tools/definitions/crs-reports
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const crsReportsTool = tool('congressgov_crs_reports', {
+    description: `Browse and retrieve CRS (Congressional Research Service) reports — nonpartisan policy analyses written by subject-matter experts at the Library of Congress.
+
+CRS reports cover policy areas, legislative proposals, and legal questions. Report IDs use letter-number codes (e.g., R40097, RL33612, IF12345).
+
+Use 'list' to browse available reports, 'get' for full detail including authors, topics, summary, and available download formats.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z.enum(['list', 'get']).describe('Which data to retrieve.'),
+        reportNumber: z
+            .string()
+            .optional()
+            .describe("CRS report ID (e.g., 'R40097'). Required for 'get'."),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('CRS report data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            const result = await api.listCrsReports({ limit: input.limit, offset: input.offset });
+            ctx.log.info('CRS reports listed', { count: result.data.length });
+            return result;
+        }
+        if (!input.reportNumber) {
+            throw new Error("The 'get' operation requires reportNumber. Report IDs use letter-number codes (e.g., R40097). Use 'list' to browse available reports.");
+        }
+        const result = await api.getCrsReport({ reportNumber: input.reportNumber });
+        ctx.log.info('CRS report retrieved', { reportNumber: input.reportNumber });
+        return result;
+    },
+});
+//# sourceMappingURL=crs-reports.tool.js.map

package/dist/mcp-server/tools/definitions/crs-reports.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crs-reports.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/crs-reports.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,yBAAyB,EAAE;IAC5D,WAAW,EAAE;;;;kIAImH;IAChI,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACtE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qDAAqD,CAAC;QAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACzF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KAC1E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACrF,MAAM,EAAE,YAAY;IAEpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACtF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,uIAAuI,CACxI,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAC5E,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3E,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Tool for browsing the daily Congressional Record.
+ * @module mcp-server/tools/definitions/daily-record
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const dailyRecordTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<{
+        articles: "articles";
+        list: "list";
+        issues: "issues";
+    }>;
+    volumeNumber: z.ZodOptional<z.ZodNumber>;
+    issueNumber: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$loose>>;
+//# sourceMappingURL=daily-record.tool.d.ts.map

package/dist/mcp-server/tools/definitions/daily-record.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-record.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/daily-record.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,eAAe;;;;;;;;;;kDAoE1B,CAAC"}

package/dist/mcp-server/tools/definitions/daily-record.tool.js

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Tool for browsing the daily Congressional Record.
+ * @module mcp-server/tools/definitions/daily-record
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const dailyRecordTool = tool('congressgov_daily_record', {
+    description: `Browse the daily Congressional Record — floor speeches, debates, and legislative text published each day Congress is in session.
+
+Navigation is hierarchical: list → volumes, issues → individual articles. Use 'list' to find recent volumes, 'issues' to see what's in a volume, and 'articles' to access individual speeches and debate sections.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z.enum(['list', 'issues', 'articles']).describe('Which data to retrieve.'),
+        volumeNumber: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Volume number. Required for 'issues' and 'articles'."),
+        issueNumber: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Issue number within a volume. Required for 'articles'."),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('Congressional Record data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            const result = await api.listDailyRecord({ limit: input.limit, offset: input.offset });
+            ctx.log.info('Daily record listed');
+            return result;
+        }
+        if (!input.volumeNumber) {
+            throw new Error(`The '${input.operation}' operation requires volumeNumber. Use 'list' to browse available Congressional Record volumes.`);
+        }
+        if (input.operation === 'issues') {
+            const result = await api.getDailyIssues({
+                volumeNumber: input.volumeNumber,
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Daily record issues retrieved', { volumeNumber: input.volumeNumber });
+            return result;
+        }
+        if (!input.issueNumber) {
+            throw new Error("The 'articles' operation requires both volumeNumber and issueNumber. Use 'issues' to see available issues within a volume.");
+        }
+        const result = await api.getDailyArticles({
+            volumeNumber: input.volumeNumber,
+            issueNumber: input.issueNumber,
+            limit: input.limit,
+            offset: input.offset,
+        });
+        ctx.log.info('Daily record articles retrieved', {
+            volumeNumber: input.volumeNumber,
+            issueNumber: input.issueNumber,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=daily-record.tool.js.map

package/dist/mcp-server/tools/definitions/daily-record.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daily-record.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/daily-record.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAEjF,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,0BAA0B,EAAE;IAC9D,WAAW,EAAE;;mNAEoM;IACjN,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QACrF,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,sDAAsD,CAAC;QACnE,WAAW,EAAE,CAAC;aACX,MAAM,EAAE;aACR,GAAG,EAAE;aACL,QAAQ,EAAE;aACV,QAAQ,EAAE;aACV,QAAQ,CAAC,wDAAwD,CAAC;QACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;QACzF,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;KAC1E,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC/F,MAAM,EAAE,YAAY;IAEpB,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAE7B,IAAI,KAAK,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACvF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;YACpC,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACb,QAAQ,KAAK,CAAC,SAAS,iGAAiG,CACzH,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC;gBACtC,YAAY,EAAE,KAAK,CAAC,YAAY;gBAChC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM;aACrB,CAAC,CAAC;YACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC;YACpF,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CACb,4HAA4H,CAC7H,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC;YACxC,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE;YAC9C,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,WAAW,EAAE,KAAK,CAAC,WAAW;SAC/B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Tool for browsing enacted public and private laws from Congress.gov.
+ * @module mcp-server/tools/definitions/enacted-laws
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const enactedLawsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<{
+        get: "get";
+        list: "list";
+    }>;
+    congress: z.ZodNumber;
+    lawType: z.ZodOptional<z.ZodEnum<{
+        pub: "pub";
+        priv: "priv";
+    }>>;
+    lawNumber: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$loose>>;
+//# sourceMappingURL=enacted-laws.tool.d.ts.map

package/dist/mcp-server/tools/definitions/enacted-laws.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enacted-laws.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,eAAe;;;;;;;;;;;;;kDAkD1B,CAAC"}

package/dist/mcp-server/tools/definitions/enacted-laws.tool.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Tool for browsing enacted public and private laws from Congress.gov.
+ * @module mcp-server/tools/definitions/enacted-laws
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const enactedLawsTool = tool('congressgov_enacted_laws', {
+    description: `Browse enacted public and private laws from Congress.gov.
+
+Use 'list' to browse laws by congress. Each law references its origin bill — use 'congressgov_bill_lookup' with that reference for the full legislative history.
+
+Law types:
+- pub: Public laws (general application, most common)
+- priv: Private laws (specific individuals or entities)`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z.enum(['list', 'get']).describe('Which data to retrieve.'),
+        congress: z.number().int().positive().describe('Congress number.'),
+        lawType: z.enum(['pub', 'priv']).optional().describe("Law type. Required for 'get'."),
+        lawNumber: z.number().int().positive().optional().describe("Law number. Required for 'get'."),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('Law data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            const result = await api.listLaws({
+                congress: input.congress,
+                lawType: input.lawType,
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Laws listed', { congress: input.congress, count: result.data.length });
+            return result;
+        }
+        if (!input.lawType || !input.lawNumber) {
+            throw new Error("The 'get' operation requires lawType ('pub' or 'priv') and lawNumber.");
+        }
+        const result = await api.getLaw({
+            congress: input.congress,
+            lawType: input.lawType,
+            lawNumber: input.lawNumber,
+        });
+        ctx.log.info('Law retrieved', {
+            congress: input.congress,
+            lawType: input.lawType,
+            lawNumber: input.lawNumber,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=enacted-laws.tool.js.map

package/dist/mcp-server/tools/definitions/enacted-laws.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enacted-laws.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/enacted-laws.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Tool for discovering congressional members and their legislative activity.
+ * @module mcp-server/tools/definitions/member-lookup
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const memberLookupTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<{
+        get: "get";
+        list: "list";
+        sponsored: "sponsored";
+        cosponsored: "cosponsored";
+    }>;
+    bioguideId: z.ZodOptional<z.ZodString>;
+    congress: z.ZodOptional<z.ZodNumber>;
+    stateCode: z.ZodOptional<z.ZodString>;
+    district: z.ZodOptional<z.ZodNumber>;
+    currentMember: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$loose>>;
+//# sourceMappingURL=member-lookup.tool.d.ts.map

package/dist/mcp-server/tools/definitions/member-lookup.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/member-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;kDAyF3B,CAAC"}

package/dist/mcp-server/tools/definitions/member-lookup.tool.js

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Tool for discovering congressional members and their legislative activity.
+ * @module mcp-server/tools/definitions/member-lookup
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const memberLookupTool = tool('congressgov_member_lookup', {
+    description: `Discover congressional members and their legislative activity.
+
+The API does not support name search. To find a member:
+- By location: use 'list' with stateCode (and optionally district)
+- By congress: use 'list' with congress number
+- By current status: use 'list' with currentMember=true
+
+Once you have a bioguideId, use 'get' for full profile or 'sponsored'/'cosponsored' for legislative portfolio. The bioguideId also works with the congress://member/{bioguideId} resource.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z
+            .enum(['list', 'get', 'sponsored', 'cosponsored'])
+            .describe('Which data to retrieve.'),
+        bioguideId: z
+            .string()
+            .optional()
+            .describe("Unique member identifier (e.g., 'P000197'). Required for get/sponsored/cosponsored."),
+        congress: z.number().int().positive().optional().describe('Congress number to filter by.'),
+        stateCode: z
+            .string()
+            .length(2)
+            .optional()
+            .describe("Two-letter state code (e.g., 'CA', 'TX')."),
+        district: z
+            .number()
+            .int()
+            .min(0)
+            .optional()
+            .describe('Congressional district number. Requires stateCode. Use 0 for at-large.'),
+        currentMember: z
+            .boolean()
+            .optional()
+            .describe('Filter to currently serving members. Defaults to false.'),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('Member data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            if (input.district !== undefined && !input.stateCode) {
+                throw new Error("The 'district' parameter requires 'stateCode'. Provide both to look up a specific House representative.");
+            }
+            const result = await api.listMembers({
+                congress: input.congress,
+                stateCode: input.stateCode,
+                district: input.district,
+                currentMember: input.currentMember,
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Members listed', { count: result.data.length });
+            return result;
+        }
+        if (!input.bioguideId) {
+            throw new Error(`The '${input.operation}' operation requires bioguideId. Use 'list' with stateCode or congress to discover members.`);
+        }
+        if (input.operation === 'get') {
+            const result = await api.getMember(input.bioguideId);
+            ctx.log.info('Member retrieved', { bioguideId: input.bioguideId });
+            return result;
+        }
+        const type = input.operation === 'sponsored' ? 'sponsored-legislation' : 'cosponsored-legislation';
+        const result = await api.getMemberLegislation({
+            bioguideId: input.bioguideId,
+            type,
+            limit: input.limit,
+            offset: input.offset,
+        });
+        ctx.log.info('Member legislation retrieved', {
+            bioguideId: input.bioguideId,
+            type: input.operation,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=member-lookup.tool.js.map

package/dist/mcp-server/tools/definitions/member-lookup.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member-lookup.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/member-lookup.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Tool for retrieving House roll call vote data and member voting positions.
+ * @module mcp-server/tools/definitions/roll-votes
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const rollVotesTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<{
+        members: "members";
+        get: "get";
+        list: "list";
+    }>;
+    congress: z.ZodNumber;
+    session: z.ZodNumber;
+    voteNumber: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$loose>>;
+//# sourceMappingURL=roll-votes.tool.d.ts.map

package/dist/mcp-server/tools/definitions/roll-votes.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roll-votes.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/roll-votes.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,aAAa;;;;;;;;;;;kDAgExB,CAAC"}

package/dist/mcp-server/tools/definitions/roll-votes.tool.js

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Tool for retrieving House roll call vote data and member voting positions.
+ * @module mcp-server/tools/definitions/roll-votes
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const rollVotesTool = tool('congressgov_roll_votes', {
+    description: `Retrieve House roll call vote data and individual member voting positions.
+
+NOTE: Covers House votes only — Senate vote data is not yet in the Congress.gov API.
+
+Use 'list' to find votes by congress and session, 'get' for vote details (question, result, associated bill), and 'members' for how each representative voted.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z.enum(['list', 'get', 'members']).describe('Which data to retrieve.'),
+        congress: z.number().int().positive().describe('Congress number.'),
+        session: z
+            .number()
+            .int()
+            .min(1)
+            .max(2)
+            .describe('Session number (1 or 2). Odd years are session 1, even years session 2.'),
+        voteNumber: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe("Roll call vote number. Required for 'get' and 'members'."),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('Vote data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            const result = await api.listVotes({
+                congress: input.congress,
+                session: input.session,
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Votes listed', { congress: input.congress, session: input.session });
+            return result;
+        }
+        if (!input.voteNumber) {
+            throw new Error(`The '${input.operation}' operation requires voteNumber. Use 'list' to browse available votes.`);
+        }
+        const voteParams = {
+            congress: input.congress,
+            session: input.session,
+            voteNumber: input.voteNumber,
+        };
+        const result = input.operation === 'members'
+            ? await api.getVoteMembers(voteParams)
+            : await api.getVote(voteParams);
+        ctx.log.info('Vote retrieved', {
+            ...voteParams,
+            operation: input.operation,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=roll-votes.tool.js.map

package/dist/mcp-server/tools/definitions/roll-votes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"roll-votes.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/roll-votes.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Tool for browsing presidential nominations and the Senate confirmation pipeline.
+ * @module mcp-server/tools/definitions/senate-nominations
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const senateNominationsTool: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    operation: z.ZodEnum<{
+        actions: "actions";
+        committees: "committees";
+        hearings: "hearings";
+        nominees: "nominees";
+        get: "get";
+        list: "list";
+    }>;
+    congress: z.ZodNumber;
+    nominationNumber: z.ZodOptional<z.ZodString>;
+    ordinal: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$loose>>;
+//# sourceMappingURL=senate-nominations.tool.d.ts.map

package/dist/mcp-server/tools/definitions/senate-nominations.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senate-nominations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/senate-nominations.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAKjD,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;kDA2FhC,CAAC"}

package/dist/mcp-server/tools/definitions/senate-nominations.tool.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview Tool for browsing presidential nominations and the Senate confirmation pipeline.
+ * @module mcp-server/tools/definitions/senate-nominations
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { formatResult } from '../../../mcp-server/tools/format-helpers.js';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const senateNominationsTool = tool('congressgov_senate_nominations', {
+    description: `Browse presidential nominations to federal positions and track the Senate confirmation process.
+
+Nominations use 'PN' (Presidential Nomination) numbering. A single nomination may contain multiple nominees — use 'nominees' to see individual appointees.
+
+Partitioned nominations (e.g., PN230-1, PN230-2) occur when nominees within one nomination follow different confirmation paths.`,
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        operation: z
+            .enum(['list', 'get', 'nominees', 'actions', 'committees', 'hearings'])
+            .describe('Which data to retrieve.'),
+        congress: z.number().int().positive().describe('Congress number.'),
+        nominationNumber: z
+            .string()
+            .optional()
+            .describe("Nomination number (e.g., '1064'). Required for detail operations."),
+        ordinal: z
+            .number()
+            .int()
+            .positive()
+            .optional()
+            .describe('Position ordinal within a nomination (for multi-nominee nominations).'),
+        limit: z.number().int().min(1).max(250).default(20).describe('Results per page (1-250).'),
+        offset: z.number().int().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({}).passthrough().describe('Nomination data from Congress.gov API.'),
+    format: formatResult,
+    async handler(input, ctx) {
+        const api = getCongressApi();
+        if (input.operation === 'list') {
+            const result = await api.listNominations({
+                congress: input.congress,
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Nominations listed', {
+                congress: input.congress,
+                count: result.data.length,
+            });
+            return result;
+        }
+        if (!input.nominationNumber) {
+            throw new Error(`The '${input.operation}' operation requires nominationNumber. Use 'list' to browse nominations.`);
+        }
+        if (input.operation === 'get') {
+            const result = await api.getNomination(input.congress, input.nominationNumber);
+            ctx.log.info('Nomination retrieved', {
+                congress: input.congress,
+                nominationNumber: input.nominationNumber,
+            });
+            return result;
+        }
+        if (input.operation === 'nominees') {
+            if (!input.ordinal) {
+                throw new Error("The 'nominees' operation requires 'ordinal' — the position number within the nomination. Use 'get' first to see available ordinals in the nominees array.");
+            }
+            const result = await api.getNominee(input.congress, input.nominationNumber, input.ordinal, {
+                limit: input.limit,
+                offset: input.offset,
+            });
+            ctx.log.info('Nominee retrieved', {
+                congress: input.congress,
+                nominationNumber: input.nominationNumber,
+                ordinal: input.ordinal,
+            });
+            return result;
+        }
+        const result = await api.getNominationSubResource({
+            congress: input.congress,
+            nominationNumber: input.nominationNumber,
+            subResource: input.operation,
+            limit: input.limit,
+            offset: input.offset,
+        });
+        ctx.log.info('Nomination sub-resource retrieved', {
+            congress: input.congress,
+            nominationNumber: input.nominationNumber,
+            subResource: input.operation,
+        });
+        return result;
+    },
+});
+//# sourceMappingURL=senate-nominations.tool.js.map

package/dist/mcp-server/tools/definitions/senate-nominations.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"senate-nominations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/senate-nominations.tool.ts"],"names":[],"mappings":"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"}

package/dist/mcp-server/tools/format-helpers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Shared formatting for tool output — lists, details, HTML stripping.
+ * @module mcp-server/tools/format-helpers
+ */
+type TextBlock = {
+    type: 'text';
+    text: string;
+};
+/** Format any tool result into readable text content blocks. */
+export declare function formatResult(result: Record<string, unknown>): TextBlock[];
+export {};
+//# sourceMappingURL=format-helpers.d.ts.map

package/dist/mcp-server/tools/format-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-helpers.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhD,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EAAE,CAEzE"}