@cyanheads/congressgov-mcp-server 0.3.31 → 0.4.0

package/AGENTS.md

@@ -1,8 +1,8 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.3.31
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.9`
+**Version:** 0.4.0
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.10`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
 **Zod:** ^4.4.3
@@ -40,8 +40,12 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 | Env Var | Required | Description |
 |:--------|:---------|:------------|
-| `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 1,000 req/hr. |
+| `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 5,000 req/hr. |
 | `CONGRESS_API_BASE_URL` | No | Defaults to `https://api.congress.gov/v3` |
+| `CONGRESS_MIRROR_ENABLED` | No | Enable the local bill search mirror and `congressgov_search_bills`. Defaults to `false`. |
+| `CONGRESS_MIRROR_PATH` | No | Filesystem path to the SQLite mirror index. Defaults to `.mirror/bills.sqlite3`. |
+| `CONGRESS_MIRROR_REFRESH_CRON` | No | Cron schedule for the in-process mirror refresh (HTTP transport only). Unset runs `mirror:refresh` manually. |
+| `CONGRESS_MIRROR_CONGRESSES` | No | Comma-separated congress numbers to mirror (e.g. `118,119`). Defaults to the current congress plus the prior one. |
 
 ---
 
@@ -60,7 +64,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 ## MCP Surface
 
-### Tools (10)
+### Tools (11)
 
 | Name | Description |
 |:-----|:------------|
@@ -74,6 +78,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 | `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 daily Congressional Record — floor speeches, debates, proceedings |
+| `congressgov_search_bills` | Keyword-search bill titles/summaries via the opt-in local FTS mirror — off by default |
 
 ### Resources (5)
 
@@ -105,6 +110,12 @@ src/
     congress-api/
       congress-api-service.ts           # API client — auth, pagination, rate limiting
       types.ts                          # API response types
+    congress-mirror/
+      congress-mirror-service.ts        # Mirror read path — FTS5 search, ready(), sync accessor
+      ingest.ts                         # Bill list + CRS summaries sync generator
+      normalize.ts                      # HTML→plain-text, FTS5 MATCH escaping
+      schema.ts                         # SQLite mirror store spec (bills table, FTS index)
+      types.ts                          # Mirror row, search filters, search page types
     senate-lis/
       senate-vote-service.ts            # Senate LIS XML client — fetch, retry, not-found
       parse.ts                          # pure XML → domain parsers (fast-xml-parser)
@@ -121,6 +132,7 @@ src/
       crs-reports.tool.ts             # congressgov_crs_reports
       committee-reports.tool.ts        # congressgov_committee_reports
       daily-record.tool.ts            # congressgov_daily_record
+      search-bills.tool.ts            # congressgov_search_bills (opt-in — disabledTool() when the mirror is off)
     resources/definitions/
       current-congress.resource.ts     # congress://current
       bill-types.resource.ts           # congress://bill-types
@@ -130,13 +142,18 @@ src/
     prompts/definitions/
       bill-analysis.prompt.ts          # congressgov_bill_analysis
       legislative-research.prompt.ts   # congressgov_legislative_research
+scripts/
+  _mirror-context.ts                    # Shared bootstrap for the mirror lifecycle CLI scripts
+  congress-mirror-init.ts               # mirror:init — full out-of-band mirror build
+  congress-mirror-refresh.ts            # mirror:refresh — incremental mirror refresh
+  congress-mirror-verify.ts             # mirror:verify — readiness + integrity check
 ```
 
 ---
 
 ## Services
 
-Two services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace).
+Three services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace); `CongressMirrorService` backs `congressgov_search_bills` only.
 
 **`CongressApiService`** — wraps the Congress.gov REST API v3:
 - API key via `X-Api-Key` header (never logged; kept out of the URL so it can't leak in upstream error messages)
@@ -151,6 +168,10 @@ Two services. `CongressApiService` backs nine tools and the House branch of `con
 - The host returns HTTP 200 with an HTML page for unknown congress/session/vote, so "not found" is detected from the body, not the status code
 - Party totals are derived from the roster (the feed publishes none)
 
+**`CongressMirrorService`** — local SQLite FTS5 mirror of bill title + CRS summary text, backing `congressgov_search_bills` only:
+- Opt-in via `CONGRESS_MIRROR_ENABLED` (off by default); built out-of-band via the `mirror:init`/`mirror:refresh` scripts, never on server startup
+- No live-API fallback — ingests through the existing `CongressApiService`, and a mirror that hasn't finished its initial build returns an empty result with a notice, not an error
+
 **Usage in tools:**
 ```ts
 import { getCongressApi } from '@/services/congress-api/congress-api-service.js';

package/CLAUDE.md

@@ -1,8 +1,8 @@
 # Agent Protocol
 
 **Server:** congressgov-mcp-server
-**Version:** 0.3.31
-**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.9`
+**Version:** 0.4.0
+**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.10`
 **Engines:** Bun ≥1.3.0, Node ≥24.0.0
 **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
 **Zod:** ^4.4.3
@@ -40,8 +40,12 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 | Env Var | Required | Description |
 |:--------|:---------|:------------|
-| `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 1,000 req/hr. |
+| `CONGRESS_API_KEY` | No | Optional. Defaults to `DEMO_KEY` (30 req/hr). Own key from [api.data.gov](https://api.data.gov/signup/): 5,000 req/hr. |
 | `CONGRESS_API_BASE_URL` | No | Defaults to `https://api.congress.gov/v3` |
+| `CONGRESS_MIRROR_ENABLED` | No | Enable the local bill search mirror and `congressgov_search_bills`. Defaults to `false`. |
+| `CONGRESS_MIRROR_PATH` | No | Filesystem path to the SQLite mirror index. Defaults to `.mirror/bills.sqlite3`. |
+| `CONGRESS_MIRROR_REFRESH_CRON` | No | Cron schedule for the in-process mirror refresh (HTTP transport only). Unset runs `mirror:refresh` manually. |
+| `CONGRESS_MIRROR_CONGRESSES` | No | Comma-separated congress numbers to mirror (e.g. `118,119`). Defaults to the current congress plus the prior one. |
 
 ---
 
@@ -60,7 +64,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 
 ## MCP Surface
 
-### Tools (10)
+### Tools (11)
 
 | Name | Description |
 |:-----|:------------|
@@ -74,6 +78,7 @@ Tailor suggestions to what's actually missing or stale — don't recite the full
 | `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 daily Congressional Record — floor speeches, debates, proceedings |
+| `congressgov_search_bills` | Keyword-search bill titles/summaries via the opt-in local FTS mirror — off by default |
 
 ### Resources (5)
 
@@ -105,6 +110,12 @@ src/
     congress-api/
       congress-api-service.ts           # API client — auth, pagination, rate limiting
       types.ts                          # API response types
+    congress-mirror/
+      congress-mirror-service.ts        # Mirror read path — FTS5 search, ready(), sync accessor
+      ingest.ts                         # Bill list + CRS summaries sync generator
+      normalize.ts                      # HTML→plain-text, FTS5 MATCH escaping
+      schema.ts                         # SQLite mirror store spec (bills table, FTS index)
+      types.ts                          # Mirror row, search filters, search page types
     senate-lis/
       senate-vote-service.ts            # Senate LIS XML client — fetch, retry, not-found
       parse.ts                          # pure XML → domain parsers (fast-xml-parser)
@@ -121,6 +132,7 @@ src/
       crs-reports.tool.ts             # congressgov_crs_reports
       committee-reports.tool.ts        # congressgov_committee_reports
       daily-record.tool.ts            # congressgov_daily_record
+      search-bills.tool.ts            # congressgov_search_bills (opt-in — disabledTool() when the mirror is off)
     resources/definitions/
       current-congress.resource.ts     # congress://current
       bill-types.resource.ts           # congress://bill-types
@@ -130,13 +142,18 @@ src/
     prompts/definitions/
       bill-analysis.prompt.ts          # congressgov_bill_analysis
       legislative-research.prompt.ts   # congressgov_legislative_research
+scripts/
+  _mirror-context.ts                    # Shared bootstrap for the mirror lifecycle CLI scripts
+  congress-mirror-init.ts               # mirror:init — full out-of-band mirror build
+  congress-mirror-refresh.ts            # mirror:refresh — incremental mirror refresh
+  congress-mirror-verify.ts             # mirror:verify — readiness + integrity check
 ```
 
 ---
 
 ## Services
 
-Two services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace).
+Three services. `CongressApiService` backs nine tools and the House branch of `congressgov_roll_votes`; `SenateVoteService` backs only the Senate branch of `congressgov_roll_votes` (the Congress.gov API exposes no Senate vote namespace); `CongressMirrorService` backs `congressgov_search_bills` only.
 
 **`CongressApiService`** — wraps the Congress.gov REST API v3:
 - API key via `X-Api-Key` header (never logged; kept out of the URL so it can't leak in upstream error messages)
@@ -151,6 +168,10 @@ Two services. `CongressApiService` backs nine tools and the House branch of `con
 - The host returns HTTP 200 with an HTML page for unknown congress/session/vote, so "not found" is detected from the body, not the status code
 - Party totals are derived from the roster (the feed publishes none)
 
+**`CongressMirrorService`** — local SQLite FTS5 mirror of bill title + CRS summary text, backing `congressgov_search_bills` only:
+- Opt-in via `CONGRESS_MIRROR_ENABLED` (off by default); built out-of-band via the `mirror:init`/`mirror:refresh` scripts, never on server startup
+- No live-API fallback — ingests through the existing `CongressApiService`, and a mirror that hasn't finished its initial build returns an empty result with a notice, not an error
+
 **Usage in tools:**
 ```ts
 import { getCongressApi } from '@/services/congress-api/congress-api-service.js';

package/Dockerfile

@@ -71,6 +71,19 @@ RUN if [ "$OTEL_ENABLED" = "true" ]; then \
 # Copy the compiled application code from the build stage
 COPY --from=build /usr/src/app/dist ./dist
 
+# Copy the mirror lifecycle scripts (mirror:init / mirror:refresh / mirror:verify)
+# and the shared context shim they import, then emit a runtime tsconfig so Bun
+# resolves the @/ path alias against the compiled ./dist (the source ./src never
+# reaches the runtime image). Same `bun run mirror:*` commands work in dev and the
+# image; run `docker exec <container> bun run mirror:init` to build the index.
+# See the api-mirror skill for the full recipe.
+COPY --from=build /usr/src/app/scripts/congress-mirror-init.ts \
+                  /usr/src/app/scripts/congress-mirror-refresh.ts \
+                  /usr/src/app/scripts/congress-mirror-verify.ts \
+                  /usr/src/app/scripts/_mirror-context.ts \
+                  ./scripts/
+RUN echo '{"compilerOptions":{"baseUrl":".","paths":{"@/*":["./dist/*"]}}}' > tsconfig.json
+
 # The 'oven/bun' image already provides a non-root user named 'bun'.
 # We will use this existing user for enhanced security.
 

package/README.md

@@ -1,13 +1,13 @@
 <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>
+  <div>11 Tools • 5 Resources • 2 Prompts</div>
   </p>
 </div>
 
 <div align="center">
 
-[![Version](https://img.shields.io/badge/Version-0.3.31-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/congressgov-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![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) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-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/)
+[![Version](https://img.shields.io/badge/Version-0.4.0-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/congressgov-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![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) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-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>
 
@@ -29,7 +29,7 @@
 
 ## Tools
 
-Ten read-only tools for querying U.S. legislative data:
+Eleven read-only tools for querying U.S. legislative data:
 
 | Tool | Description |
 |:---|:---|
@@ -43,6 +43,7 @@ Ten read-only tools for querying U.S. legislative data:
 | `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_search_bills` | Keyword-search bill titles and CRS summaries via a local full-text mirror (opt-in, off by default) |
 
 ### `congressgov_bill_lookup`
 
@@ -112,6 +113,16 @@ Browse the daily Congressional Record — floor speeches, debates, and legislati
 - Browse volumes by congress number
 - Retrieve specific issue articles
 
+---
+
+### `congressgov_search_bills`
+
+Keyword-search bill titles and CRS summaries against a local full-text mirror — the discovery path the Congress.gov API itself lacks.
+
+- **Opt-in:** off by default. Requires `CONGRESS_MIRROR_ENABLED=true` and a locally built index (`bun run mirror:init`) — until then the tool is visible but not callable
+- Narrow with `congress`, `billType`, and `originChamber` filters
+- Returns BM25-ranked matches with each bill's derived id, ready for a follow-up `congressgov_bill_lookup` call
+
 ## Resources
 
 | URI Pattern | Description |
@@ -143,7 +154,7 @@ Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core):
 Congress.gov-specific:
 
 - Type-safe client for the Congress.gov REST API v3
-- Optional API key from [api.data.gov](https://api.data.gov/signup/) — defaults to `DEMO_KEY` (30 req/hr); own key gets 1,000 req/hr
+- Optional API key from [api.data.gov](https://api.data.gov/signup/) — defaults to `DEMO_KEY` (30 req/hr); own key gets 5,000 req/hr
 - Automatic pagination and response normalization
 - Rate limiting awareness
 - All tools are read-only and idempotent
@@ -201,7 +212,7 @@ Or with npx (no Bun required):
 }
 ```
 
-Get a free API key at [api.data.gov/signup](https://api.data.gov/signup/) for 1,000 req/hr. Without a key the server falls back to `DEMO_KEY` (30 req/hr).
+Get a free API key at [api.data.gov/signup](https://api.data.gov/signup/) for 5,000 req/hr. Without a key the server falls back to `DEMO_KEY` (30 req/hr).
 
 ### Prerequisites
 
@@ -233,7 +244,7 @@ All configuration is validated at startup via Zod schemas in `src/config/server-
 
 | Variable | Description | Default |
 |:---|:---|:---|
-| `CONGRESS_API_KEY` | Optional. API key from [api.data.gov](https://api.data.gov/signup/). Omit to use `DEMO_KEY` (30 req/hr); own key: 1,000 req/hr. | `DEMO_KEY` |
+| `CONGRESS_API_KEY` | Optional. API key from [api.data.gov](https://api.data.gov/signup/). Omit to use `DEMO_KEY` (30 req/hr); own key: 5,000 req/hr. | `DEMO_KEY` |
 | `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` |
@@ -271,7 +282,7 @@ docker run -e CONGRESS_API_KEY=your-api-key -p 3010:3010 congressgov-mcp-server
 
 | Directory | Purpose |
 |:---|:---|
-| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Ten Congress.gov tools. |
+| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). Eleven 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. |

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

@@ -3,11 +3,26 @@
  * @module config/server-config
  */
 import { z } from '@cyanheads/mcp-ts-core';
+/** Default on-disk location of the SQLite bill FTS mirror. */
+export declare const DEFAULT_MIRROR_PATH = ".mirror/bills.sqlite3";
+/**
+ * Congress number covering a given date. The 1st U.S. Congress convened in 1789
+ * and each Congress spans two years, so `floor((year - 1789) / 2) + 1` yields the
+ * ordinal (2025–2026 → 119). Used to seed the default mirror window when
+ * `CONGRESS_MIRROR_CONGRESSES` is unset.
+ */
+export declare function currentCongressNumber(date?: Date): number;
 declare const ServerConfigSchema: z.ZodObject<{
     apiKey: z.ZodDefault<z.ZodString>;
     baseUrl: z.ZodDefault<z.ZodString>;
+    mirrorEnabled: z.ZodPreprocess<z.ZodCodec<z.ZodString, z.ZodBoolean>>;
+    mirrorPath: z.ZodDefault<z.ZodString>;
+    mirrorRefreshCron: z.ZodPreprocess<z.ZodOptional<z.ZodString>>;
+    congresses: z.ZodPreprocess<z.ZodArray<z.ZodNumber>>;
 }, z.core.$strip>;
 export type ServerConfig = z.infer<typeof ServerConfigSchema>;
 export declare function getServerConfig(): ServerConfig;
+/** Reset the cached config — test-only. */
+export declare function resetServerConfig(): void;
 export {};
 //# sourceMappingURL=server-config.d.ts.map

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

@@ -1 +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;AAG3C,QAAA,MAAM,kBAAkB;;;iBAYtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAM9C"}
+{"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;AAG3C,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,0BAA0B,CAAC;AAE3D;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAErE;AAoBD,QAAA,MAAM,kBAAkB;;;;;;;iBA0CtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,eAAe,IAAI,YAAY,CAU9C;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/config/server-config.js

@@ -4,23 +4,88 @@
  */
 import { z } from '@cyanheads/mcp-ts-core';
 import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+/** Default on-disk location of the SQLite bill FTS mirror. */
+export const DEFAULT_MIRROR_PATH = '.mirror/bills.sqlite3';
+/**
+ * Congress number covering a given date. The 1st U.S. Congress convened in 1789
+ * and each Congress spans two years, so `floor((year - 1789) / 2) + 1` yields the
+ * ordinal (2025–2026 → 119). Used to seed the default mirror window when
+ * `CONGRESS_MIRROR_CONGRESSES` is unset.
+ */
+export function currentCongressNumber(date = new Date()) {
+    return Math.floor((date.getUTCFullYear() - 1789) / 2) + 1;
+}
+/**
+ * Parse `CONGRESS_MIRROR_CONGRESSES` — a comma-separated list of congress numbers
+ * ("118,119") — into a positive-integer array. Unset/empty falls back to the
+ * current congress plus the one prior (the realistic "what's this recent bill
+ * about" search window); a fully malformed value resolves to an empty array,
+ * which the `.min(1)` guard rejects loudly at startup.
+ */
+function parseCongresses(value) {
+    if (typeof value === 'string' && value.trim() !== '') {
+        return value
+            .split(',')
+            .map((s) => Number.parseInt(s.trim(), 10))
+            .filter((n) => Number.isInteger(n) && n > 0);
+    }
+    const current = currentCongressNumber();
+    return [current, current - 1];
+}
 const ServerConfigSchema = z.object({
     apiKey: z
         .string()
         .default('DEMO_KEY')
-        .describe('Congress.gov API key from api.data.gov — optional (DEMO_KEY: 30 req/hr, own key: 1000 req/hr)'),
+        .describe('Congress.gov API key from api.data.gov — optional (DEMO_KEY: 30 req/hr, own key: 5000 req/hr)'),
     baseUrl: z
         .string()
         .url()
         .default('https://api.congress.gov/v3')
         .describe('Congress.gov API base URL'),
+    /**
+     * Master switch for the local bill FTS mirror + `congressgov_search_bills`.
+     * Off by default so the standard deploy stays config-free and the live-API
+     * tools are unaffected. Unset/empty/malformed resolves to `false`.
+     */
+    mirrorEnabled: z
+        .preprocess((v) => (v === undefined || v === null || v === '' ? 'false' : v), z.stringbool())
+        .describe('Enable the local bill search mirror and the congressgov_search_bills tool.'),
+    /** Filesystem path to the SQLite mirror index file (matches the Dockerfile `.mirror` dir). */
+    mirrorPath: z
+        .string()
+        .min(1)
+        .default(DEFAULT_MIRROR_PATH)
+        .describe('Filesystem path to the SQLite bill mirror index.'),
+    /**
+     * Cron expression for the in-process incremental refresh (HTTP transport only).
+     * Unset means no in-process schedule — run `bun run mirror:refresh` out-of-band.
+     */
+    mirrorRefreshCron: z
+        .preprocess((v) => (v === '' || v === null ? undefined : v), z.string().min(1).optional())
+        .describe('Cron schedule for the in-process mirror refresh (HTTP only; omit to run manually).'),
+    /**
+     * Congresses to mirror. Defaults to the current congress plus the one prior.
+     * Comma-separated env value (e.g. "118,119"); widening the window is a config
+     * change, not a redesign.
+     */
+    congresses: z
+        .preprocess(parseCongresses, z.array(z.number().int().positive()).min(1))
+        .describe('Congress numbers included in the mirror (default: current + 1 prior).'),
 });
 let _config;
 export function getServerConfig() {
     _config ??= parseEnvConfig(ServerConfigSchema, {
         apiKey: 'CONGRESS_API_KEY',
         baseUrl: 'CONGRESS_API_BASE_URL',
+        mirrorEnabled: 'CONGRESS_MIRROR_ENABLED',
+        mirrorPath: 'CONGRESS_MIRROR_PATH',
+        mirrorRefreshCron: 'CONGRESS_MIRROR_REFRESH_CRON',
+        congresses: 'CONGRESS_MIRROR_CONGRESSES',
     });
     return _config;
 }
+/** Reset the cached config — test-only. */
+export function resetServerConfig() {
+    _config = undefined;
+}
 //# sourceMappingURL=server-config.js.map

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

@@ -1 +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;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,OAAO,CAAC,UAAU,CAAC;SACnB,QAAQ,CACP,+FAA+F,CAChG;IACH,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,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,kBAAkB;QAC1B,OAAO,EAAE,uBAAuB;KACjC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,8 @@
  * @module index
  */
 import { createApp } from '@cyanheads/mcp-ts-core';
+import { logger, schedulerService } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from './config/server-config.js';
 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';
@@ -20,8 +22,10 @@ import { dailyRecordTool } from './mcp-server/tools/definitions/daily-record.too
 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 { searchBillsTool } from './mcp-server/tools/definitions/search-bills.tool.js';
 import { senateNominationsTool } from './mcp-server/tools/definitions/senate-nominations.tool.js';
 import { initCongressApi } from './services/congress-api/congress-api-service.js';
+import { getCongressMirror, initCongressMirror, } from './services/congress-mirror/congress-mirror-service.js';
 import { initSenateVoteService } from './services/senate-lis/senate-vote-service.js';
 const REPO_ROOT = 'https://github.com/cyanheads/congressgov-mcp-server';
 /**
@@ -46,6 +50,7 @@ await createApp({
         withSource(crsReportsTool, 'tools', 'crs-reports.tool.ts'),
         withSource(committeeReportsTool, 'tools', 'committee-reports.tool.ts'),
         withSource(dailyRecordTool, 'tools', 'daily-record.tool.ts'),
+        withSource(searchBillsTool, 'tools', 'search-bills.tool.ts'),
     ],
     resources: [
         withSource(currentCongressResource, 'resources', 'current-congress.resource.ts'),
@@ -58,15 +63,38 @@ await createApp({
         withSource(billAnalysisPrompt, 'prompts', 'bill-analysis.prompt.ts'),
         withSource(legislativeResearchPrompt, 'prompts', 'legislative-research.prompt.ts'),
     ],
-    instructions: `Use the congressgov_* tools to access U.S. legislative data via the Congress.gov API v3: bills, enacted laws, members, committees, roll call votes, presidential nominations, CRS reports, and the daily Congressional Record. There is no keyword search — browse by congress number, bill/report type, date range, chamber, state, and district. Bills are addressed by congress + billType + billNumber (e.g. 118/hr/1234), members by bioguideId, committees by chamber-prefix codes. congressgov_roll_votes serves both chambers via its 'chamber' parameter — House votes come from the Congress.gov API, Senate votes from the Senate's official LIS feed.`,
+    instructions: `Use the congressgov_* tools to access U.S. legislative data via the Congress.gov API v3: bills, enacted laws, members, committees, roll call votes, presidential nominations, CRS reports, and the daily Congressional Record. The Congress.gov API itself has no keyword search — browse by congress number, bill/report type, date range, chamber, state, and district. An optional local FTS mirror adds congressgov_search_bills (keyword search over bill titles and summaries) when CONGRESS_MIRROR_ENABLED is set; off by default, the tool is visible but not callable. Bills are addressed by congress + billType + billNumber (e.g. 118/hr/1234), members by bioguideId, committees by chamber-prefix codes. congressgov_roll_votes serves both chambers via its 'chamber' parameter — House votes come from the Congress.gov API, Senate votes from the Senate's official LIS feed.`,
     landing: {
         repoRoot: REPO_ROOT,
         tagline: 'U.S. legislative data — bills, votes, members, committees — via MCP.',
         requireAuth: false,
     },
-    setup() {
+    setup(core) {
         initCongressApi();
         initSenateVoteService();
+        /**
+         * The bill FTS mirror is opt-in (off by default). When enabled, wire the
+         * service; a full init runs out-of-band via `mirror:init` (never on startup).
+         * The in-process incremental refresh is scheduled only under HTTP transport
+         * (a long-lived process owns the cron) and only when a cron is configured —
+         * stdio operators run `mirror:refresh` out-of-band.
+         */
+        const config = getServerConfig();
+        if (config.mirrorEnabled) {
+            initCongressMirror({ mirrorPath: config.mirrorPath, congresses: config.congresses });
+            if (core.config.mcpTransportType === 'http' && config.mirrorRefreshCron) {
+                void scheduleMirrorRefresh(config.mirrorRefreshCron);
+            }
+        }
     },
 });
+/** Register and start the in-process incremental mirror refresh job. */
+async function scheduleMirrorRefresh(cron) {
+    await schedulerService.schedule('congress-bills-refresh', cron, async (jobCtx) => {
+        logger.info('Starting scheduled Congress bill mirror refresh', jobCtx);
+        const result = await getCongressMirror().mirrorInstance.runSync({ mode: 'refresh' });
+        logger.info(`Scheduled Congress bill mirror refresh complete: ${result.recordsApplied} records applied (total ${result.total})`, jobCtx);
+    }, 'Incremental refresh of the local Congress bill FTS mirror from Congress.gov.');
+    schedulerService.start('congress-bills-refresh');
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"committee-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/committee-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAqGjD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsM9B,CAAC"}
+{"version":3,"file":"committee-lookup.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/committee-lookup.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAqGjD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyM9B,CAAC"}

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

@@ -127,15 +127,17 @@ export const committeeLookupTool = tool('congressgov_committee_lookup', {
         const api = getCongressApi();
         if (input.operation === 'list') {
             const filter = input.filter?.trim() || undefined;
-            // When filtering, fetch the full chamber set so client-side matching covers all rows.
-            const fetchLimit = filter ? 250 : input.limit;
-            const fetchOffset = filter ? 0 : input.offset;
-            const result = await api.listCommittees({
-                congress: input.congress,
-                chamber: input.chamber,
-                limit: fetchLimit,
-                offset: fetchOffset,
-            }, ctx);
+            // When filtering, page through the complete scoped committee set before
+            // matching client-side — the roster (455 House, 818 all chambers) exceeds
+            // the 250-row request cap, so a single fetch drops matches past row 250.
+            const result = filter
+                ? await fetchAllCommittees({ congress: input.congress, chamber: input.chamber }, ctx)
+                : await api.listCommittees({
+                    congress: input.congress,
+                    chamber: input.chamber,
+                    limit: input.limit,
+                    offset: input.offset,
+                }, ctx);
             const matched = filter ? filterCommittees(result.data, filter) : result.data;
             ctx.log.info('Committees listed', {
                 count: matched.length,
@@ -164,7 +166,9 @@ export const committeeLookupTool = tool('congressgov_committee_lookup', {
         // path uses, restricted to parent committees (systemCode ending '00').
         let committeeCode = input.committeeCode;
         if (/\s/.test(committeeCode)) {
-            const all = await api.listCommittees({ limit: 250, offset: 0 }, ctx);
+            // Page the complete cross-chamber committee set so name resolution matches
+            // rows past the 250-row request cap.
+            const all = await fetchAllCommittees({}, ctx);
             const parents = all.data.filter((c) => typeof c.systemCode === 'string' && c.systemCode.endsWith('00'));
             const matches = filterCommittees(parents, committeeCode);
             if (matches.length !== 1) {
@@ -235,6 +239,32 @@ export const committeeLookupTool = tool('congressgov_committee_lookup', {
         return result;
     },
 });
+/**
+ * Fetch the COMPLETE committee set for a scope, paging past the 250-row request
+ * cap. `/committee/{chamber}` returns the full historical roster — 455 for the
+ * House, 818 across all chambers — but one request returns at most 250 rows, so
+ * client-side name filtering (`list` + `filter`) and name→code resolution must
+ * page until the upstream `pagination.nextOffset` is exhausted and aggregate
+ * every row. Mirrors `fetchCommitteeBillsRecent`: multi-request orchestration
+ * lives in the tool layer, not the service. Worst case ≈4 requests (818 ÷ 250).
+ * Resolves cyanheads/congressgov-mcp-server#41.
+ */
+async function fetchAllCommittees(params, ctx) {
+    const api = getCongressApi();
+    const PAGE_SIZE = 250;
+    const data = [];
+    let offset = 0;
+    let count = 0;
+    for (;;) {
+        const page = await api.listCommittees({ congress: params.congress, chamber: params.chamber, limit: PAGE_SIZE, offset }, ctx);
+        data.push(...page.data);
+        count = page.pagination.count;
+        if (page.pagination.nextOffset == null)
+            break;
+        offset = page.pagination.nextOffset;
+    }
+    return { data, pagination: { count, nextOffset: null } };
+}
 /**
  * Fetch committee bills in newest-first order.
  *