@cyanheads/openstates-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview List all jurisdictions covered by Open States.
+ * @module mcp-server/tools/definitions/list-jurisdictions
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const listJurisdictions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    classification: z.ZodDefault<z.ZodEnum<{
+        state: "state";
+        municipality: "municipality";
+        country: "country";
+    }>>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        legislative_sessions: "legislative_sessions";
+        organizations: "organizations";
+        latest_runs: "latest_runs";
+    }>>>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    per_page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        classification: z.ZodString;
+        url: z.ZodString;
+        latest_bill_update: z.ZodString;
+        latest_people_update: z.ZodString;
+        legislative_sessions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            identifier: z.ZodString;
+            name: z.ZodString;
+            classification: z.ZodString;
+            start_date: z.ZodString;
+            end_date: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        per_page: z.ZodNumber;
+        max_page: z.ZodNumber;
+        total_items: z.ZodNumber;
+    }, z.core.$strip>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=list-jurisdictions.tool.d.ts.map

package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.d.ts.map

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

package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.js

@@ -0,0 +1,110 @@
+/**
+ * @fileoverview List all jurisdictions covered by Open States.
+ * @module mcp-server/tools/definitions/list-jurisdictions
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const JurisdictionIncludeEnum = z.enum(['organizations', 'legislative_sessions', 'latest_runs']);
+export const listJurisdictions = tool('openstates_list_jurisdictions', {
+    title: 'List Jurisdictions',
+    description: 'List all jurisdictions covered by Open States — all 50 states, DC, and Puerto Rico. Returns coverage metadata: latest bill update time, latest people update time, and optionally all legislative sessions with their identifiers. Use this when you need to discover valid session identifiers for a state before calling openstates_search_bills with a session filter. The legislative_sessions include option returns all historical and current sessions — always check valid session identifiers here before using them in bill searches, since formats vary widely by state (e.g., "2025", "2025-2026", "2025rs", "2025s1").',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        classification: z
+            .enum(['state', 'municipality', 'country'])
+            .default('state')
+            .describe('Filter by jurisdiction type. Use "state" (default) for all 50 states, DC, and Puerto Rico.'),
+        include: z
+            .array(JurisdictionIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "legislative_sessions" returns all session identifiers and date ranges — required when you need to discover valid session values for bill searches.'),
+        page: z.coerce.number().int().min(1).default(1).describe('Page number (1-indexed).'),
+        per_page: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(52)
+            .default(52)
+            .describe('Results per page. Default 52 to cover all states, DC, and Puerto Rico in one request.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('OCD jurisdiction ID — use as jurisdiction filter in other tools.'),
+            name: z.string().describe('Jurisdiction name (e.g., "Washington").'),
+            classification: z.string().describe('Jurisdiction type: "state", "municipality", etc.'),
+            url: z.string().describe('Official legislature URL.'),
+            latest_bill_update: z
+                .string()
+                .describe('ISO 8601 timestamp of most recent bill data update.'),
+            latest_people_update: z
+                .string()
+                .describe('ISO 8601 timestamp of most recent people data update.'),
+            legislative_sessions: z
+                .array(z
+                .object({
+                identifier: z
+                    .string()
+                    .describe('Session identifier — use as session= in bill searches.'),
+                name: z.string().describe('Human-readable session name.'),
+                classification: z.string().describe('Session type: "primary", "special", etc.'),
+                start_date: z.string().describe('Session start date.'),
+                end_date: z.string().describe('Session end date.'),
+            })
+                .describe('Legislative session record.'))
+                .optional()
+                .describe('Legislative sessions when include=legislative_sessions is requested.'),
+        })
+            .describe('Jurisdiction record.'))
+            .describe('Jurisdictions matching the filter.'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page number.'),
+            per_page: z.number().describe('Results per page.'),
+            max_page: z.number().describe('Total number of pages.'),
+            total_items: z.number().describe('Total matching jurisdictions.'),
+        })
+            .describe('Pagination metadata.'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenStatesApiService();
+        const result = await svc.listJurisdictions({
+            classification: input.classification,
+            include: input.include && input.include.length > 0 ? input.include : undefined,
+            page: input.page,
+            per_page: input.per_page,
+        }, ctx);
+        ctx.log.info('Listed jurisdictions', {
+            classification: input.classification,
+            count: result.results.length,
+            total: result.pagination.total_items,
+        });
+        return result;
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.pagination.total_items} jurisdictions** (page ${result.pagination.page}/${result.pagination.max_page}, per page ${result.pagination.per_page})`,
+        ];
+        for (const jur of result.results) {
+            lines.push('');
+            lines.push(`## ${jur.name}`);
+            lines.push(`**ID:** ${jur.id}`);
+            lines.push(`**Classification:** ${jur.classification}`);
+            lines.push(`**URL:** ${jur.url}`);
+            lines.push(`**Latest bill update:** ${jur.latest_bill_update}`);
+            lines.push(`**Latest people update:** ${jur.latest_people_update}`);
+            if (jur.legislative_sessions?.length) {
+                lines.push('');
+                lines.push('**Legislative sessions:**');
+                for (const s of jur.legislative_sessions) {
+                    lines.push(`- \`${s.identifier}\` — ${s.name} (${s.classification}) ${s.start_date}–${s.end_date}`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=list-jurisdictions.tool.js.map

package/dist/mcp-server/tools/definitions/list-jurisdictions.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-jurisdictions.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/list-jurisdictions.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,sBAAsB,EAAE,aAAa,CAAC,CAAC,CAAC;AAEjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,CAAC,+BAA+B,EAAE;IACrE,KAAK,EAAE,oBAAoB;IAC3B,WAAW,EACT,qmBAAqmB;IACvmB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IAC9E,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,cAAc,EAAE,CAAC;aACd,IAAI,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;aAC1C,OAAO,CAAC,OAAO,CAAC;aAChB,QAAQ,CACP,4FAA4F,CAC7F;QACH,OAAO,EAAE,CAAC;aACP,KAAK,CAAC,uBAAuB,CAAC;aAC9B,QAAQ,EAAE;aACV,QAAQ,CACP,6KAA6K,CAC9K;QACH,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;QACpF,QAAQ,EAAE,CAAC,CAAC,MAAM;aACf,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,EAAE,CAAC;aACP,OAAO,CAAC,EAAE,CAAC;aACX,QAAQ,CACP,uFAAuF,CACxF;KACJ,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC;aACE,MAAM,CAAC;YACN,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,QAAQ,CAAC,kEAAkE,CAAC;YAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;YACpE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;YACvF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YACrD,kBAAkB,EAAE,CAAC;iBAClB,MAAM,EAAE;iBACR,QAAQ,CAAC,qDAAqD,CAAC;YAClE,oBAAoB,EAAE,CAAC;iBACpB,MAAM,EAAE;iBACR,QAAQ,CAAC,uDAAuD,CAAC;YACpE,oBAAoB,EAAE,CAAC;iBACpB,KAAK,CACJ,CAAC;iBACE,MAAM,CAAC;gBACN,UAAU,EAAE,CAAC;qBACV,MAAM,EAAE;qBACR,QAAQ,CAAC,wDAAwD,CAAC;gBACrE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;gBACzD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;gBAC/E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACtD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;aACnD,CAAC;iBACD,QAAQ,CAAC,6BAA6B,CAAC,CAC3C;iBACA,QAAQ,EAAE;iBACV,QAAQ,CAAC,sEAAsE,CAAC;SACpF,CAAC;aACD,QAAQ,CAAC,sBAAsB,CAAC,CACpC;aACA,QAAQ,CAAC,oCAAoC,CAAC;QACjD,UAAU,EAAE,CAAC;aACV,MAAM,CAAC;YACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAClD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;YACvD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;SAClE,CAAC;aACD,QAAQ,CAAC,sBAAsB,CAAC;KACpC,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG;QACtB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,iBAAiB,CACxC;YACE,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAC9E,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,EACD,GAAG,CACJ,CAAC;QACF,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE;YACnC,cAAc,EAAE,KAAK,CAAC,cAAc;YACpC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YAC5B,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW;SACrC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE;QACjB,MAAM,KAAK,GAAa;YACtB,KAAK,MAAM,CAAC,UAAU,CAAC,WAAW,0BAA0B,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,cAAc,MAAM,CAAC,UAAU,CAAC,QAAQ,GAAG;SAC5J,CAAC;QACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,uBAAuB,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC;YACxD,KAAK,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,2BAA2B,GAAG,CAAC,kBAAkB,EAAE,CAAC,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,6BAA6B,GAAG,CAAC,oBAAoB,EAAE,CAAC,CAAC;YACpE,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,EAAE,CAAC;gBACrC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;gBACxC,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,CAAC;oBACzC,KAAK,CAAC,IAAI,CACR,OAAO,CAAC,CAAC,UAAU,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,cAAc,KAAK,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,QAAQ,EAAE,CACxF,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACpD,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @fileoverview Search state legislative bills across all covered US jurisdictions.
+ * @module mcp-server/tools/definitions/search-bills
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const searchBills: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    q: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    chamber: z.ZodOptional<z.ZodEnum<{
+        upper: "upper";
+        lower: "lower";
+    }>>;
+    classification: z.ZodOptional<z.ZodString>;
+    subject: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    sponsor: z.ZodOptional<z.ZodString>;
+    sponsor_classification: z.ZodOptional<z.ZodString>;
+    sort: z.ZodDefault<z.ZodEnum<{
+        updated_asc: "updated_asc";
+        updated_desc: "updated_desc";
+        first_action_asc: "first_action_asc";
+        first_action_desc: "first_action_desc";
+        latest_action_asc: "latest_action_asc";
+        latest_action_desc: "latest_action_desc";
+    }>>;
+    action_since: z.ZodOptional<z.ZodString>;
+    updated_since: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sponsorships: "sponsorships";
+        abstracts: "abstracts";
+        other_titles: "other_titles";
+        other_identifiers: "other_identifiers";
+        actions: "actions";
+        sources: "sources";
+        documents: "documents";
+        versions: "versions";
+        votes: "votes";
+        related_bills: "related_bills";
+    }>>>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    per_page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        identifier: z.ZodString;
+        title: z.ZodString;
+        session: z.ZodString;
+        jurisdiction: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        from_organization: z.ZodObject<{
+            name: z.ZodString;
+            classification: z.ZodString;
+        }, z.core.$strip>;
+        classification: z.ZodArray<z.ZodString>;
+        subject: z.ZodArray<z.ZodString>;
+        first_action_date: z.ZodNullable<z.ZodString>;
+        latest_action_date: z.ZodNullable<z.ZodString>;
+        latest_action_description: z.ZodNullable<z.ZodString>;
+        latest_passage_date: z.ZodNullable<z.ZodString>;
+        sponsorships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            entity_type: z.ZodString;
+            primary: z.ZodBoolean;
+            classification: z.ZodString;
+        }, z.core.$strip>>>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            date: z.ZodString;
+            classification: z.ZodArray<z.ZodString>;
+            order: z.ZodNumber;
+            organization: z.ZodObject<{
+                name: z.ZodString;
+                classification: z.ZodString;
+            }, z.core.$strip>;
+        }, z.core.$strip>>>;
+        abstracts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            abstract: z.ZodString;
+            note: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        per_page: z.ZodNumber;
+        max_page: z.ZodNumber;
+        total_items: z.ZodNumber;
+    }, z.core.$strip>;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "missing_scope";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither jurisdiction nor q (full-text search) was provided.";
+    readonly recovery: "Provide a jurisdiction (state name or OCD-ID) or a full-text search term via q, or both.";
+}, {
+    readonly reason: "invalid_session";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Session identifier was not recognized by the Open States API.";
+    readonly recovery: "Use openstates_get_jurisdiction with include=legislative_sessions to list valid session identifiers for this jurisdiction.";
+}]>;
+//# sourceMappingURL=search-bills.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-bills.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-bills.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-bills.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyBjE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiStB,CAAC"}

package/dist/mcp-server/tools/definitions/search-bills.tool.js

@@ -0,0 +1,285 @@
+/**
+ * @fileoverview Search state legislative bills across all covered US jurisdictions.
+ * @module mcp-server/tools/definitions/search-bills
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const BillIncludeEnum = z.enum([
+    'sponsorships',
+    'abstracts',
+    'other_titles',
+    'other_identifiers',
+    'actions',
+    'sources',
+    'documents',
+    'versions',
+    'votes',
+    'related_bills',
+]);
+const BillSortEnum = z.enum([
+    'updated_asc',
+    'updated_desc',
+    'first_action_asc',
+    'first_action_desc',
+    'latest_action_asc',
+    'latest_action_desc',
+]);
+export const searchBills = tool('openstates_search_bills', {
+    title: 'Search Bills',
+    description: 'Search state legislative bills across all covered US jurisdictions. Supports full-text search, jurisdiction/session filtering, subject tags, sponsor lookups, and sort order. Either jurisdiction or q (full-text) is required — combining both is common and recommended for precision. Use include=sponsorships,actions to get sponsor and action history inline and avoid a follow-up openstates_get_bill call. Use sort=latest_action_desc to find bills currently moving. Use openstates_get_jurisdiction with include=legislative_sessions to discover valid session identifiers before filtering by session.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        jurisdiction: z
+            .string()
+            .optional()
+            .describe('State name, two-letter abbreviation, or OCD-ID (e.g., "Washington", "wa", or "ocd-jurisdiction/country:us/state:wa/government"). Required unless q is provided.'),
+        q: z
+            .string()
+            .optional()
+            .describe('Full-text search across bill titles, abstracts, and text. Required unless jurisdiction is provided. Combining with jurisdiction is recommended for precision.'),
+        session: z
+            .string()
+            .optional()
+            .describe('Session identifier (e.g., "2025", "2025-2026", "2025rs"). Use openstates_get_jurisdiction with include=legislative_sessions to discover valid values. Omit to search across all sessions.'),
+        chamber: z
+            .enum(['upper', 'lower'])
+            .optional()
+            .describe('Filter by originating chamber. "upper" = Senate, "lower" = House/Assembly.'),
+        classification: z
+            .string()
+            .optional()
+            .describe('Bill classification: "bill", "resolution", "constitutional amendment", etc.'),
+        subject: z
+            .array(z.string())
+            .optional()
+            .describe('Filter to bills tagged with one or more subject categories.'),
+        sponsor: z.string().optional().describe('Filter by sponsor name or OCD person ID.'),
+        sponsor_classification: z
+            .string()
+            .optional()
+            .describe('Filter sponsor type: "primary", "cosponsor".'),
+        sort: BillSortEnum.default('updated_desc').describe('Sort order. Use "latest_action_desc" for bills currently moving through the legislature.'),
+        action_since: z
+            .string()
+            .optional()
+            .describe('ISO 8601 date — only return bills with an action after this date.'),
+        updated_since: z
+            .string()
+            .optional()
+            .describe('ISO 8601 date — only return bills updated after this date.'),
+        include: z
+            .array(BillIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "sponsorships" and "actions" cover most research needs without a separate openstates_get_bill call. "votes" adds full vote tallies and per-legislator positions.'),
+        page: z.coerce.number().int().min(1).default(1).describe('Page number (1-indexed).'),
+        per_page: z.coerce
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(10)
+            .describe('Results per page. Maximum 20. Default 10.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            id: z.string().describe('OCD bill ID — use as openstates_id in openstates_get_bill.'),
+            identifier: z
+                .string()
+                .describe('Bill identifier as used by the legislature (e.g., "HB 1000").'),
+            title: z.string().describe('Bill title.'),
+            session: z.string().describe('Legislative session identifier.'),
+            jurisdiction: z
+                .object({
+                id: z.string().describe('OCD jurisdiction ID.'),
+                name: z.string().describe('Jurisdiction name.'),
+            })
+                .describe('Originating jurisdiction.'),
+            from_organization: z
+                .object({
+                name: z.string().describe('Chamber name.'),
+                classification: z
+                    .string()
+                    .describe('Chamber classification (e.g., "lower", "upper").'),
+            })
+                .describe('Originating chamber.'),
+            classification: z.array(z.string()).describe('Bill classifications.'),
+            subject: z.array(z.string()).describe('Subject tags assigned by Open States scrapers.'),
+            first_action_date: z.string().nullable().describe('Date of first recorded action.'),
+            latest_action_date: z.string().nullable().describe('Date of most recent action.'),
+            latest_action_description: z
+                .string()
+                .nullable()
+                .describe('Description of most recent action.'),
+            latest_passage_date: z
+                .string()
+                .nullable()
+                .describe('Date bill passed (when applicable).'),
+            sponsorships: z
+                .array(z
+                .object({
+                name: z.string().describe('Sponsor name.'),
+                entity_type: z.string().describe('Entity type: "person", "organization".'),
+                primary: z.boolean().describe('Whether this is the primary sponsor.'),
+                classification: z.string().describe('Sponsorship type.'),
+            })
+                .describe('Sponsorship record.'))
+                .optional()
+                .describe('Sponsorships when include=sponsorships is requested.'),
+            actions: z
+                .array(z
+                .object({
+                description: z.string().describe('Action description.'),
+                date: z.string().describe('Action date.'),
+                classification: z.array(z.string()).describe('Action classifications.'),
+                order: z.number().describe('Action sequence order.'),
+                organization: z
+                    .object({
+                    name: z.string().describe('Organization name.'),
+                    classification: z.string().describe('Organization classification.'),
+                })
+                    .describe('Chamber or committee where action occurred.'),
+            })
+                .describe('Action record.'))
+                .optional()
+                .describe('Action history when include=actions is requested.'),
+            abstracts: z
+                .array(z
+                .object({
+                abstract: z.string().describe('Plain-language bill summary.'),
+                note: z.string().describe('Source note.'),
+            })
+                .describe('Abstract record.'))
+                .optional()
+                .describe('Bill abstracts when include=abstracts is requested.'),
+        })
+            .describe('Bill record.'))
+            .describe('Bills matching the search criteria.'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page.'),
+            per_page: z.number().describe('Results per page.'),
+            max_page: z.number().describe('Total pages available.'),
+            total_items: z.number().describe('Total matching bills.'),
+        })
+            .describe('Pagination metadata.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty — echoes the filters applied and suggests how to broaden. Absent when results are returned.'),
+    }),
+    errors: [
+        {
+            reason: 'missing_scope',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither jurisdiction nor q (full-text search) was provided.',
+            recovery: 'Provide a jurisdiction (state name or OCD-ID) or a full-text search term via q, or both.',
+        },
+        {
+            reason: 'invalid_session',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Session identifier was not recognized by the Open States API.',
+            recovery: 'Use openstates_get_jurisdiction with include=legislative_sessions to list valid session identifiers for this jurisdiction.',
+        },
+    ],
+    async handler(input, ctx) {
+        if (!input.jurisdiction && !input.q) {
+            throw ctx.fail('missing_scope', 'Either jurisdiction or q is required.', {
+                ...ctx.recoveryFor('missing_scope'),
+            });
+        }
+        const svc = getOpenStatesApiService();
+        const result = await svc.searchBills({
+            jurisdiction: input.jurisdiction,
+            q: input.q,
+            session: input.session,
+            chamber: input.chamber,
+            classification: input.classification,
+            subject: input.subject && input.subject.length > 0 ? input.subject : undefined,
+            sponsor: input.sponsor,
+            sponsor_classification: input.sponsor_classification,
+            sort: input.sort,
+            action_since: input.action_since,
+            updated_since: input.updated_since,
+            include: input.include && input.include.length > 0 ? input.include : undefined,
+            page: input.page,
+            per_page: input.per_page,
+        }, ctx);
+        ctx.log.info('Searched bills', {
+            jurisdiction: input.jurisdiction,
+            q: input.q,
+            count: result.results.length,
+            total: result.pagination.total_items,
+        });
+        if (result.results.length === 0) {
+            const filters = [];
+            if (input.jurisdiction)
+                filters.push(`jurisdiction="${input.jurisdiction}"`);
+            if (input.q)
+                filters.push(`q="${input.q}"`);
+            if (input.session)
+                filters.push(`session="${input.session}"`);
+            if (input.chamber)
+                filters.push(`chamber="${input.chamber}"`);
+            return {
+                results: [],
+                pagination: result.pagination,
+                message: `No bills matched ${filters.join(', ')}. Try broadening the query, checking the session identifier with openstates_get_jurisdiction, or removing filters.`,
+            };
+        }
+        return { results: result.results, pagination: result.pagination };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.pagination.total_items} bills** (page ${result.pagination.page}/${result.pagination.max_page}, per page ${result.pagination.per_page}, showing ${result.results.length})`,
+        ];
+        if (result.message) {
+            lines.push('');
+            lines.push(`> ${result.message}`);
+        }
+        for (const bill of result.results) {
+            lines.push('');
+            lines.push(`## ${bill.identifier} — ${bill.title}`);
+            lines.push(`**ID:** ${bill.id}`);
+            lines.push(`**Session:** ${bill.session} | **Jurisdiction:** ${bill.jurisdiction.name} (${bill.jurisdiction.id})`);
+            lines.push(`**Chamber:** ${bill.from_organization.name} (${bill.from_organization.classification})`);
+            if (bill.classification.length > 0)
+                lines.push(`**Classification:** ${bill.classification.join(', ')}`);
+            if (bill.subject.length > 0)
+                lines.push(`**Subjects:** ${bill.subject.join(', ')}`);
+            if (bill.first_action_date)
+                lines.push(`**First action:** ${bill.first_action_date}`);
+            if (bill.latest_action_date) {
+                lines.push(`**Latest action:** ${bill.latest_action_date} — ${bill.latest_action_description ?? 'N/A'}`);
+            }
+            if (bill.latest_passage_date)
+                lines.push(`**Passed:** ${bill.latest_passage_date}`);
+            if (bill.sponsorships?.length) {
+                lines.push('');
+                lines.push('**Sponsors:**');
+                for (const s of bill.sponsorships) {
+                    const primary = s.primary ? '**Primary**' : 'Cosponsor';
+                    lines.push(`- ${primary}: ${s.name} (${s.classification}, entity: ${s.entity_type})`);
+                }
+            }
+            if (bill.abstracts?.length) {
+                lines.push('');
+                for (const abs of bill.abstracts) {
+                    lines.push(`*${abs.abstract}* _(${abs.note})_`);
+                }
+            }
+            if (bill.actions?.length) {
+                lines.push('');
+                lines.push('**Actions:**');
+                for (const a of bill.actions) {
+                    const cls = a.classification.length > 0 ? ` [${a.classification.join(', ')}]` : '';
+                    lines.push(`- #${a.order} ${a.date}: ${a.description}${cls} — ${a.organization.name} (${a.organization.classification})`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-bills.tool.js.map

package/dist/mcp-server/tools/definitions/search-bills.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @fileoverview Search committees for a jurisdiction (experimental — not all states have coverage).
+ * @module mcp-server/tools/definitions/search-committees
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchCommittees: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    classification: z.ZodOptional<z.ZodEnum<{
+        committee: "committee";
+        subcommittee: "subcommittee";
+    }>>;
+    chamber: z.ZodOptional<z.ZodEnum<{
+        upper: "upper";
+        lower: "lower";
+    }>>;
+    parent: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        memberships: "memberships";
+        sources: "sources";
+        links: "links";
+    }>>>;
+    page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    per_page: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        classification: z.ZodString;
+        parent_id: z.ZodNullable<z.ZodString>;
+        memberships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            person_id: z.ZodString;
+            person_name: z.ZodString;
+            role: z.ZodString;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodObject<{
+        page: z.ZodNumber;
+        per_page: z.ZodNumber;
+        max_page: z.ZodNumber;
+        total_items: z.ZodNumber;
+    }, z.core.$strip>;
+    coverage_note: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=search-committees.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-committees.tool.d.ts.map

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