@cyanheads/congressgov-mcp-server 0.3.3

package/README.md

@@ -0,0 +1,296 @@
+<div align="center">
+  <h1>@cyanheads/congressgov-mcp-server</h1>
+  <p><b>Access U.S. congressional data - bills, votes, members, committees - through MCP. STDIO & Streamable HTTP.</b>
+  <div>10 Tools • 5 Resources • 2 Prompts</div>
+  </p>
+</div>
+
+<div align="center">
+
+[![npm](https://img.shields.io/npm/v/@cyanheads/congressgov-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/congressgov-mcp-server) [![Version](https://img.shields.io/badge/Version-0.3.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-259?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.27.1-green.svg?style=flat-square)](https://modelcontextprotocol.io/)
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+---
+
+## Tools
+
+Ten read-only tools for querying U.S. legislative data:
+
+| Tool | Description |
+|:---|:---|
+| `congressgov_bill_lookup` | Browse and retrieve U.S. legislative bill data — actions, sponsors, summaries, text, related bills |
+| `congressgov_enacted_laws` | Browse enacted public and private laws by congress |
+| `congressgov_member_lookup` | Discover congressional members by state/district/congress, retrieve legislative portfolios |
+| `congressgov_committee_lookup` | Browse congressional committees and their legislation, reports, and nominations |
+| `congressgov_roll_votes` | Retrieve House roll call vote data and individual member voting positions |
+| `congressgov_senate_nominations` | Browse presidential nominations to federal positions and track the Senate confirmation process |
+| `congressgov_bill_summaries` | Browse recent CRS bill summaries — the "what's happening" feed |
+| `congressgov_crs_reports` | Browse and retrieve nonpartisan CRS policy analysis reports |
+| `congressgov_committee_reports` | Browse and retrieve committee reports accompanying legislation |
+| `congressgov_daily_record` | Browse the daily Congressional Record — floor speeches, debates, and proceedings |
+
+### `congressgov_bill_lookup`
+
+Browse and retrieve U.S. legislative bill data from Congress.gov.
+
+- Filter by congress number, bill type, and date range
+- Retrieve detailed sub-resources: actions, amendments, committees, cosponsors, related bills, subjects, summaries, text versions, and titles
+- Pagination support for browsing large result sets
+
+---
+
+### `congressgov_member_lookup`
+
+Discover congressional members and their legislative activity.
+
+- Browse by state, district, congress number, and chamber
+- Retrieve a member's sponsored and cosponsored legislation
+- Look up specific members by bioguide ID
+
+---
+
+### `congressgov_committee_lookup`
+
+Browse congressional committees and their legislation, reports, and nominations.
+
+- Filter by chamber (House, Senate, Joint)
+- Retrieve committee bills, reports, and nominations
+- Look up specific committees by committee code
+
+---
+
+### `congressgov_roll_votes`
+
+Retrieve House roll call vote data and individual member voting positions.
+
+- Browse roll call votes by congress and session
+- Retrieve individual member voting positions per roll call
+
+---
+
+### `congressgov_bill_summaries`
+
+Browse recent CRS bill summaries.
+
+- Filter by congress and bill type
+- Browse chronologically to see what's moving through Congress
+
+---
+
+### `congressgov_crs_reports`
+
+Browse and retrieve CRS reports — nonpartisan policy analyses written by subject-matter experts at the Library of Congress.
+
+- Browse the full report catalog
+- Retrieve individual reports by product number
+
+---
+
+### `congressgov_daily_record`
+
+Browse the daily Congressional Record — floor speeches, debates, and legislative text published each day Congress is in session.
+
+- Browse volumes by congress number
+- Retrieve specific issue articles
+
+## Resources
+
+| URI Pattern | Description |
+|:---|:---|
+| `congress://current` | Current congress number, session dates, chamber info |
+| `congress://bill-types` | Reference table of valid bill type codes |
+| `congress://member/{bioguideId}` | Member profile by bioguide ID |
+| `congress://bill/{congress}/{billType}/{billNumber}` | Bill detail by congress, type, and number |
+| `congress://committee/{committeeCode}` | Committee detail by committee code |
+
+## Prompts
+
+| Prompt | Description |
+|:---|:---|
+| `congressgov_bill_analysis` | Structured framework for analyzing a bill |
+| `congressgov_legislative_research` | Research framework for a policy area across Congress |
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core):
+
+- Declarative tool definitions — single file per tool, framework handles registration and validation
+- Unified error handling across all tools
+- Pluggable auth (`none`, `jwt`, `oauth`)
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`
+- Structured logging with optional OpenTelemetry tracing
+- Runs locally (stdio/HTTP) or in Docker from the same codebase
+
+Congress.gov-specific:
+
+- Type-safe client for the Congress.gov REST API v3
+- Authentication via free API key from [api.data.gov](https://api.data.gov/signup/)
+- Automatic pagination and response normalization
+- Rate limiting awareness (5,000 requests/hour per key)
+- All tools are read-only and idempotent
+
+## Getting started
+
+### MCP client configuration
+
+Add the following to your MCP client configuration file.
+
+```json
+{
+  "mcpServers": {
+    "congressgov": {
+      "type": "stdio",
+      "command": "bunx",
+      "args": ["@cyanheads/congressgov-mcp-server@latest"],
+      "env": {
+        "CONGRESS_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Or with npx (no Bun required):
+
+```json
+{
+  "mcpServers": {
+    "congressgov": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@cyanheads/congressgov-mcp-server@latest"],
+      "env": {
+        "CONGRESS_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Or with Docker:
+
+```json
+{
+  "mcpServers": {
+    "congressgov": {
+      "type": "stdio",
+      "command": "docker",
+      "args": ["run", "-i", "--rm", "-e", "CONGRESS_API_KEY=your-api-key", "-e", "MCP_TRANSPORT_TYPE=stdio", "ghcr.io/cyanheads/congressgov-mcp-server:latest"]
+    }
+  }
+}
+```
+
+For Streamable HTTP, set the transport and start the server:
+
+```sh
+MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 bun run start:http
+# Server listens at http://localhost:3010/mcp
+```
+
+Get a free API key at [api.data.gov/signup](https://api.data.gov/signup/) (5,000 requests/hour).
+
+### Prerequisites
+
+- [Bun v1.3.2](https://bun.sh/) or higher.
+
+### Installation
+
+1. **Clone the repository:**
+
+```sh
+git clone https://github.com/cyanheads/congressgov-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+
+```sh
+cd congressgov-mcp-server
+```
+
+3. **Install dependencies:**
+
+```sh
+bun install
+```
+
+4. **Configure environment:**
+
+```sh
+cp .env.example .env
+# Edit .env and add your CONGRESS_API_KEY
+```
+
+## Configuration
+
+All configuration is validated at startup via Zod schemas in `src/config/server-config.ts`. Key environment variables:
+
+| Variable | Description | Default |
+|:---|:---|:---|
+| `CONGRESS_API_KEY` | **Required.** API key from [api.data.gov](https://api.data.gov/signup/) | — |
+| `CONGRESS_API_BASE_URL` | Congress.gov API base URL | `https://api.congress.gov/v3` |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |
+| `MCP_HTTP_PORT` | HTTP server port | `3010` |
+| `MCP_AUTH_MODE` | Authentication: `none`, `jwt`, or `oauth` | `none` |
+| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `warning`, `error`, etc.) | `info` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend | `in-memory` |
+| `OTEL_ENABLED` | Enable OpenTelemetry | `false` |
+
+## Running the server
+
+### Local development
+
+- **Build and run the production version:**
+
+  ```sh
+  bun run rebuild
+  bun run start:http   # or start:stdio
+  ```
+
+- **Run checks and tests:**
+  ```sh
+  bun run devcheck     # Lints, formats, type-checks
+  bun run test         # Runs test suite
+  ```
+
+### Docker
+
+```sh
+docker build -t congressgov-mcp-server .
+docker run -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server
+```
+
+## Project structure
+
+| Directory | Purpose |
+|:---|:---|
+| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Ten Congress.gov tools. |
+| `src/mcp-server/resources/definitions/` | Resource definitions. Congress, bill, member, and committee resources. |
+| `src/mcp-server/prompts/definitions/` | Prompt definitions. Bill analysis and legislative research prompts. |
+| `src/services/congress-api/` | Congress.gov API client — auth, pagination, rate limiting. |
+| `src/config/` | Server-specific environment variable parsing and validation with Zod. |
+| `tests/` | Unit and integration tests, mirroring the `src/` structure. |
+
+## Development guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for logging, `ctx.state` for storage
+- All tools are read-only with `readOnlyHint: true` and `idempotentHint: true`
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks and tests before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+This project is licensed under the Apache 2.0 License. See the [LICENSE](./LICENSE) file for details.

package/dist/config/server-config.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Server-specific configuration for the Congress.gov MCP server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    baseUrl: z.ZodDefault<z.ZodString>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+export declare function getServerConfig(): ServerConfig;
+export {};
+//# sourceMappingURL=server-config.d.ts.map

package/dist/config/server-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.d.ts","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,QAAA,MAAM,kBAAkB;;;iBAOtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}

package/dist/config/server-config.js

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Server-specific configuration for the Congress.gov MCP server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+const ServerConfigSchema = z.object({
+    apiKey: z.string().min(1).describe('Congress.gov API key from api.data.gov'),
+    baseUrl: z
+        .string()
+        .url()
+        .default('https://api.congress.gov/v3')
+        .describe('Congress.gov API base URL'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= ServerConfigSchema.parse({
+        apiKey: process.env.CONGRESS_API_KEY,
+        baseUrl: process.env.CONGRESS_API_BASE_URL,
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

package/dist/config/server-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IAC5E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,EAAE;SACL,OAAO,CAAC,6BAA6B,CAAC;SACtC,QAAQ,CAAC,2BAA2B,CAAC;CACzC,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,kBAAkB,CAAC,KAAK,CAAC;QACnC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;QACpC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB;KAC3C,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview congressgov-mcp-server entry point — Congress.gov API v3 for MCP.
+ * @module index
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview congressgov-mcp-server entry point — Congress.gov API v3 for MCP.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { billAnalysisPrompt } from './mcp-server/prompts/definitions/bill-analysis.prompt.js';
+import { legislativeResearchPrompt } from './mcp-server/prompts/definitions/legislative-research.prompt.js';
+import { billResource } from './mcp-server/resources/definitions/bill.resource.js';
+import { billTypesResource } from './mcp-server/resources/definitions/bill-types.resource.js';
+import { committeeResource } from './mcp-server/resources/definitions/committee.resource.js';
+import { currentCongressResource } from './mcp-server/resources/definitions/current-congress.resource.js';
+import { memberResource } from './mcp-server/resources/definitions/member.resource.js';
+import { billLookupTool } from './mcp-server/tools/definitions/bill-lookup.tool.js';
+import { billSummariesTool } from './mcp-server/tools/definitions/bill-summaries.tool.js';
+import { committeeLookupTool } from './mcp-server/tools/definitions/committee-lookup.tool.js';
+import { committeeReportsTool } from './mcp-server/tools/definitions/committee-reports.tool.js';
+import { crsReportsTool } from './mcp-server/tools/definitions/crs-reports.tool.js';
+import { dailyRecordTool } from './mcp-server/tools/definitions/daily-record.tool.js';
+import { enactedLawsTool } from './mcp-server/tools/definitions/enacted-laws.tool.js';
+import { memberLookupTool } from './mcp-server/tools/definitions/member-lookup.tool.js';
+import { rollVotesTool } from './mcp-server/tools/definitions/roll-votes.tool.js';
+import { senateNominationsTool } from './mcp-server/tools/definitions/senate-nominations.tool.js';
+import { initCongressApi } from './services/congress-api/congress-api-service.js';
+await createApp({
+    tools: [
+        billLookupTool,
+        enactedLawsTool,
+        memberLookupTool,
+        committeeLookupTool,
+        rollVotesTool,
+        senateNominationsTool,
+        billSummariesTool,
+        crsReportsTool,
+        committeeReportsTool,
+        dailyRecordTool,
+    ],
+    resources: [
+        currentCongressResource,
+        billTypesResource,
+        memberResource,
+        billResource,
+        committeeResource,
+    ],
+    prompts: [billAnalysisPrompt, legislativeResearchPrompt],
+    setup() {
+        initCongressApi();
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0DAA0D,CAAC;AAC9F,OAAO,EAAE,yBAAyB,EAAE,MAAM,iEAAiE,CAAC;AAC5G,OAAO,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAC9F,OAAO,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAC7F,OAAO,EAAE,uBAAuB,EAAE,MAAM,iEAAiE,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,MAAM,yDAAyD,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,qDAAqD,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,mDAAmD,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2DAA2D,CAAC;AAClG,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,cAAc;QACd,eAAe;QACf,gBAAgB;QAChB,mBAAmB;QACnB,aAAa;QACb,qBAAqB;QACrB,iBAAiB;QACjB,cAAc;QACd,oBAAoB;QACpB,eAAe;KAChB;IACD,SAAS,EAAE;QACT,uBAAuB;QACvB,iBAAiB;QACjB,cAAc;QACd,YAAY;QACZ,iBAAiB;KAClB;IACD,OAAO,EAAE,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACxD,KAAK;QACH,eAAe,EAAE,CAAC;IACpB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Prompt providing a structured framework for analyzing a bill.
+ * @module mcp-server/prompts/definitions/bill-analysis
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const billAnalysisPrompt: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    congress: z.ZodString;
+    billType: z.ZodString;
+    billNumber: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=bill-analysis.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-analysis.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bill-analysis.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,kBAAkB;;;;kBA8B7B,CAAC"}

package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.js

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Prompt providing a structured framework for analyzing a bill.
+ * @module mcp-server/prompts/definitions/bill-analysis
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const billAnalysisPrompt = prompt('congressgov_bill_analysis', {
+    description: 'Structured framework for analyzing a bill: summary, sponsors, committee referrals, action timeline, related legislation, and policy implications.',
+    args: z.object({
+        congress: z.string().describe('Congress number (e.g., 118).'),
+        billType: z.string().describe('Bill type code (e.g., hr, s).'),
+        billNumber: z.string().describe('Bill number (e.g., 3076).'),
+    }),
+    generate: (args) => [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: `Analyze bill ${args.billType.toUpperCase()} ${args.billNumber} from the ${args.congress}th Congress. Use the congressgov_bill_lookup tool to gather data, then provide:
+
+1. **Summary** — What does this bill do? Use the CRS summary if available, otherwise summarize from the bill text.
+2. **Sponsors & Cosponsors** — Who introduced it? How many cosponsors? Bipartisan support?
+3. **Committee Referrals** — Which committees has it been referred to? Any reported out?
+4. **Action Timeline** — Key legislative actions from introduction to current status.
+5. **Related Legislation** — Companion bills, related bills, or predecessors in prior congresses.
+6. **Policy Implications** — What policy area does this affect? What are the likely impacts?
+7. **Outlook** — Based on committee activity, sponsor influence, and legislative history, what is the realistic path forward?
+
+Use these tools as needed:
+- congressgov_bill_lookup (operations: get, actions, cosponsors, committees, summaries, text, related)
+- congressgov_member_lookup (to understand sponsor/cosponsor profiles)
+- congressgov_committee_lookup (to understand committee context)`,
+            },
+        },
+    ],
+});
+//# sourceMappingURL=bill-analysis.prompt.js.map

package/dist/mcp-server/prompts/definitions/bill-analysis.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-analysis.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bill-analysis.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,2BAA2B,EAAE;IACpE,WAAW,EACT,mJAAmJ;IACrJ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC7D,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,gBAAgB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,IAAI,CAAC,UAAU,aAAa,IAAI,CAAC,QAAQ;;;;;;;;;;;;;iEAarC;aAC1D;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/legislative-research.prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Prompt providing a research framework for investigating a policy area across Congress.
+ * @module mcp-server/prompts/definitions/legislative-research
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const legislativeResearchPrompt: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    topic: z.ZodString;
+    congress: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=legislative-research.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/legislative-research.prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislative-research.prompt.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/legislative-research.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAU,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,eAAO,MAAM,yBAAyB;;;kBA0CpC,CAAC"}

package/dist/mcp-server/prompts/definitions/legislative-research.prompt.js

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Prompt providing a research framework for investigating a policy area across Congress.
+ * @module mcp-server/prompts/definitions/legislative-research
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const legislativeResearchPrompt = prompt('congressgov_legislative_research', {
+    description: 'Research framework for investigating a policy area across Congress: relevant bills, key members, committee activity, CRS reports, and floor activity.',
+    args: z.object({
+        topic: z
+            .string()
+            .describe('Policy topic or area to research (e.g., "AI regulation", "immigration reform").'),
+        congress: z
+            .string()
+            .optional()
+            .describe('Congress number to focus on. Defaults to current congress.'),
+    }),
+    generate: (args) => {
+        const congressNote = args.congress
+            ? `Focus on the ${args.congress}th Congress.`
+            : 'Start with the current congress (use the congress://current resource to find the number).';
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Research the topic "${args.topic}" across congressional activity. ${congressNote}
+
+Since the Congress.gov API has no keyword search, use these discovery strategies:
+
+1. **CRS Reports** — Use congressgov_crs_reports to find nonpartisan policy analyses on this topic.
+2. **Recent Summaries** — Use congressgov_bill_summaries with a broad date range to find recently summarized bills that may relate to this topic.
+3. **Committee Activity** — Identify relevant committees using congressgov_committee_lookup, then check their recent bills and reports.
+4. **Key Members** — Identify members known for this policy area, then check their sponsored legislation via congressgov_member_lookup.
+5. **Floor Activity** — Check congressgov_daily_record for recent floor debate on the topic.
+
+Synthesize findings into:
+- **Landscape** — What legislation is active on this topic? What stage are key bills at?
+- **Key Players** — Which members and committees are driving activity?
+- **Policy Analysis** — What do CRS reports say about the issues?
+- **Recent Activity** — What happened in the last 30 days?
+- **Outlook** — What is the likely trajectory for this policy area?`,
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=legislative-research.prompt.js.map

package/dist/mcp-server/prompts/definitions/legislative-research.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislative-research.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/legislative-research.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAM,CAAC,kCAAkC,EAAE;IAClF,WAAW,EACT,uJAAuJ;IACzJ,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,CAAC,iFAAiF,CAAC;QAC9F,QAAQ,EAAE,CAAC;aACR,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,4DAA4D,CAAC;KAC1E,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ;YAChC,CAAC,CAAC,gBAAgB,IAAI,CAAC,QAAQ,cAAc;YAC7C,CAAC,CAAC,2FAA2F,CAAC;QAEhG,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,uBAAuB,IAAI,CAAC,KAAK,oCAAoC,YAAY;;;;;;;;;;;;;;;oEAe7B;iBAC3D;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/bill-types.resource.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Resource providing a reference table of valid bill type codes.
+ * @module mcp-server/resources/definitions/bill-types
+ */
+export declare const billTypesResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<import("zod").ZodObject<Readonly<{
+    [k: string]: import("zod/v4/core").$ZodType<unknown, unknown, import("zod/v4/core").$ZodTypeInternals<unknown, unknown>>;
+}>, import("zod/v4/core").$strip>, undefined>;
+//# sourceMappingURL=bill-types.resource.d.ts.map

package/dist/mcp-server/resources/definitions/bill-types.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-types.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bill-types.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA8BH,eAAO,MAAM,iBAAiB;;6CAQ5B,CAAC"}

package/dist/mcp-server/resources/definitions/bill-types.resource.js

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Resource providing a reference table of valid bill type codes.
+ * @module mcp-server/resources/definitions/bill-types
+ */
+import { resource } from '@cyanheads/mcp-ts-core';
+const BILL_TYPES = [
+    { code: 'hr', description: 'House Bill', chamber: 'House', example: 'H.R. 1234' },
+    { code: 's', description: 'Senate Bill', chamber: 'Senate', example: 'S. 1234' },
+    { code: 'hjres', description: 'House Joint Resolution', chamber: 'House', example: 'H.J.Res. 1' },
+    {
+        code: 'sjres',
+        description: 'Senate Joint Resolution',
+        chamber: 'Senate',
+        example: 'S.J.Res. 1',
+    },
+    {
+        code: 'hconres',
+        description: 'House Concurrent Resolution',
+        chamber: 'House',
+        example: 'H.Con.Res. 1',
+    },
+    {
+        code: 'sconres',
+        description: 'Senate Concurrent Resolution',
+        chamber: 'Senate',
+        example: 'S.Con.Res. 1',
+    },
+    { code: 'hres', description: 'House Simple Resolution', chamber: 'House', example: 'H.Res. 1' },
+    { code: 'sres', description: 'Senate Simple Resolution', chamber: 'Senate', example: 'S.Res. 1' },
+];
+export const billTypesResource = resource('congress://bill-types', {
+    name: 'bill-types',
+    description: 'Reference table of valid bill type codes (hr, s, hjres, etc.) with descriptions.',
+    mimeType: 'application/json',
+    handler() {
+        return { billTypes: BILL_TYPES };
+    },
+});
+//# sourceMappingURL=bill-types.resource.js.map

package/dist/mcp-server/resources/definitions/bill-types.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill-types.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bill-types.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,UAAU,GAAG;IACjB,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE;IACjF,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;IAChF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,wBAAwB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE;IACjG;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,yBAAyB;QACtC,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,YAAY;KACtB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,6BAA6B;QAC1C,OAAO,EAAE,OAAO;QAChB,OAAO,EAAE,cAAc;KACxB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,8BAA8B;QAC3C,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,cAAc;KACxB;IACD,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE;IAC/F,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,0BAA0B,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE;CAClG,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,uBAAuB,EAAE;IACjE,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE,kFAAkF;IAC/F,QAAQ,EAAE,kBAAkB;IAE5B,OAAO;QACL,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,CAAC;IACnC,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/resources/definitions/bill.resource.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Resource for fetching bill detail by congress, type, and number.
+ * @module mcp-server/resources/definitions/bill
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const billResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    congress: z.ZodString;
+    billType: z.ZodString;
+    billNumber: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=bill.resource.d.ts.map

package/dist/mcp-server/resources/definitions/bill.resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bill.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAIrD,eAAO,MAAM,YAAY;;;;6BAwBvB,CAAC"}

package/dist/mcp-server/resources/definitions/bill.resource.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Resource for fetching bill detail by congress, type, and number.
+ * @module mcp-server/resources/definitions/bill
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { getCongressApi } from '../../../services/congress-api/congress-api-service.js';
+export const billResource = resource('congress://bill/{congress}/{billType}/{billNumber}', {
+    name: 'bill-detail',
+    description: 'Bill detail: sponsor, status, policy area, committees, latest action.',
+    mimeType: 'application/json',
+    params: z.object({
+        congress: z.string().describe('Congress number (e.g., 118).'),
+        billType: z.string().describe('Bill type code (e.g., hr, s, hjres).'),
+        billNumber: z.string().describe('Bill number (e.g., 3076).'),
+    }),
+    async handler(params, ctx) {
+        const api = getCongressApi();
+        const result = await api.getBill({
+            congress: Number(params.congress),
+            billType: params.billType,
+            billNumber: Number(params.billNumber),
+        });
+        ctx.log.info('Bill resource fetched', {
+            congress: params.congress,
+            billType: params.billType,
+            billNumber: params.billNumber,
+        });
+        return result.bill;
+    },
+});
+//# sourceMappingURL=bill.resource.js.map

package/dist/mcp-server/resources/definitions/bill.resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bill.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/bill.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AAGjF,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC,oDAAoD,EAAE;IACzF,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE,uEAAuE;IACpF,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;QAC7D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;QACrE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;KAC7D,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC;YAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;YACjC,QAAQ,EAAE,MAAM,CAAC,QAAoB;YACrC,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;SACtC,CAAC,CAAC;QACH,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE;YACpC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;CACF,CAAC,CAAC"}