@cyanheads/openstates-mcp-server 0.1.1

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

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Search committees for a jurisdiction (experimental — not all states have coverage).
+ * @module mcp-server/tools/definitions/search-committees
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const CommitteeIncludeEnum = z.enum(['memberships', 'links', 'sources']);
+export const searchCommittees = tool('openstates_search_committees', {
+    title: 'Search Committees',
+    description: 'List committees for a jurisdiction. Experimental — Open States is actively working to restore committee support and not all states have data. Use chamber to scope to upper (senate) or lower (house) committees. Use classification=subcommittee to find subcommittees of a parent. Use include=memberships to get the full roster with member roles. The coverage_note field in the output will always note the experimental coverage limitations.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        jurisdiction: z
+            .string()
+            .optional()
+            .describe('State name, abbreviation, or OCD-ID. Strongly recommended.'),
+        classification: z
+            .enum(['committee', 'subcommittee'])
+            .optional()
+            .describe('Filter to parent committees or subcommittees only. Omit for all.'),
+        chamber: z
+            .enum(['upper', 'lower'])
+            .optional()
+            .describe('Filter by chamber. "upper" = Senate, "lower" = House/Assembly.'),
+        parent: z
+            .string()
+            .optional()
+            .describe('OCD organization ID of a parent committee to retrieve its subcommittees.'),
+        include: z
+            .array(CommitteeIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "memberships" includes the full roster with member roles.'),
+        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.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            id: z
+                .string()
+                .describe('OCD organization ID — use as committee_id in openstates_get_committee.'),
+            name: z.string().describe('Committee name.'),
+            classification: z
+                .string()
+                .describe('Committee classification: "committee" or "subcommittee".'),
+            parent_id: z
+                .string()
+                .nullable()
+                .describe('OCD ID of parent committee, or null for top-level committees.'),
+            memberships: z
+                .array(z
+                .object({
+                person_id: z.string().describe('OCD person ID of the member.'),
+                person_name: z.string().describe('Member name.'),
+                role: z.string().describe('Member role (e.g., "chair", "member").'),
+            })
+                .describe('Committee membership record.'))
+                .optional()
+                .describe('Membership roster when include=memberships is requested.'),
+        })
+            .describe('Committee record.'))
+            .describe('Committees 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.'),
+            total_items: z.number().describe('Total matching committees.'),
+        })
+            .describe('Pagination metadata.'),
+        coverage_note: z
+            .string()
+            .describe('Committee data is experimental — not all states have coverage in Open States. Empty results may indicate the state lacks data, not that no committees exist.'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenStatesApiService();
+        const result = await svc.searchCommittees({
+            jurisdiction: input.jurisdiction,
+            classification: input.classification,
+            chamber: input.chamber,
+            parent: input.parent,
+            include: input.include && input.include.length > 0 ? input.include : undefined,
+            page: input.page,
+            per_page: input.per_page,
+        }, ctx);
+        ctx.log.info('Searched committees', {
+            jurisdiction: input.jurisdiction,
+            count: result.results.length,
+            total: result.pagination.total_items,
+        });
+        return {
+            results: result.results,
+            pagination: result.pagination,
+            coverage_note: 'Committee data is experimental — Open States is working to restore support and not all states have coverage. Empty results may indicate the state lacks data, not that no committees exist.',
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.pagination.total_items} committees** (page ${result.pagination.page}/${result.pagination.max_page}, per page ${result.pagination.per_page}, showing ${result.results.length})`,
+            '',
+            `> ${result.coverage_note}`,
+        ];
+        for (const committee of result.results) {
+            lines.push('');
+            lines.push(`## ${committee.name}`);
+            lines.push(`**ID:** ${committee.id}`);
+            lines.push(`**Classification:** ${committee.classification}`);
+            if (committee.parent_id)
+                lines.push(`**Parent ID:** ${committee.parent_id}`);
+            if (committee.memberships?.length) {
+                lines.push('**Members:**');
+                for (const m of committee.memberships) {
+                    lines.push(`- ${m.person_name} (${m.role}) — ID: ${m.person_id}`);
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-committees.tool.js.map

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

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

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

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview Search hearings, floor sessions, and committee meetings (experimental).
+ * @module mcp-server/tools/definitions/search-events
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchEvents: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    after: z.ZodOptional<z.ZodString>;
+    before: z.ZodOptional<z.ZodString>;
+    require_bills: z.ZodDefault<z.ZodBoolean>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sources: "sources";
+        documents: "documents";
+        links: "links";
+        media: "media";
+        participants: "participants";
+        agenda: "agenda";
+    }>>>;
+    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;
+        description: z.ZodString;
+        classification: z.ZodString;
+        start_date: z.ZodString;
+        end_date: z.ZodOptional<z.ZodString>;
+        status: z.ZodString;
+        jurisdiction: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        location: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            url: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        participants: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            entity_type: z.ZodString;
+            role: z.ZodString;
+        }, z.core.$strip>>>;
+        agenda: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            description: z.ZodString;
+            classification: z.ZodArray<z.ZodString>;
+            subjects: z.ZodArray<z.ZodString>;
+            related_entities: z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                entity_type: z.ZodString;
+            }, z.core.$strip>>;
+        }, 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;
+    message: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=search-events.tool.d.ts.map

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

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

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

@@ -0,0 +1,198 @@
+/**
+ * @fileoverview Search hearings, floor sessions, and committee meetings (experimental).
+ * @module mcp-server/tools/definitions/search-events
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const EventIncludeEnum = z.enum([
+    'links',
+    'sources',
+    'media',
+    'documents',
+    'participants',
+    'agenda',
+]);
+export const searchEvents = tool('openstates_search_events', {
+    title: 'Search Events',
+    description: 'Search hearings, floor sessions, and committee meetings. Experimental — most states do not publish event data to Open States. Use after and before to scope to a date range. Set require_bills=true to filter to events with bills on the agenda, which is the most useful filter for tracking legislation through committee. Use include=agenda,participants for full meeting context. Empty results often indicate the state lacks event data rather than no events occurring.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        jurisdiction: z
+            .string()
+            .optional()
+            .describe('State name, abbreviation, or OCD-ID. Strongly recommended.'),
+        after: z
+            .string()
+            .optional()
+            .describe('ISO 8601 datetime — events starting after this time. Use to find upcoming hearings.'),
+        before: z.string().optional().describe('ISO 8601 datetime — events starting before this time.'),
+        require_bills: z
+            .boolean()
+            .default(false)
+            .describe('When true, only return events with at least one bill on the agenda. Most useful for tracking legislation through committee.'),
+        include: z
+            .array(EventIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "agenda" includes the meeting agenda with bill references. "participants" includes the committee or chamber hosting the event.'),
+        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.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            id: z.string().describe('OCD event ID — use in openstates_get_event.'),
+            name: z.string().describe('Event name.'),
+            description: z.string().describe('Event description.'),
+            classification: z
+                .string()
+                .describe('Event classification (e.g., "committee-meeting").'),
+            start_date: z.string().describe('Event start datetime.'),
+            end_date: z
+                .string()
+                .optional()
+                .describe('Event end datetime. Absent when not recorded.'),
+            status: z.string().describe('Event status.'),
+            jurisdiction: z
+                .object({
+                id: z.string().describe('OCD jurisdiction ID.'),
+                name: z.string().describe('Jurisdiction name.'),
+            })
+                .describe('Hosting jurisdiction.'),
+            location: z
+                .object({
+                name: z.string().describe('Location name.'),
+                url: z.string().optional().describe('Location URL when available.'),
+            })
+                .optional()
+                .describe('Event location when available.'),
+            participants: z
+                .array(z
+                .object({
+                name: z.string().describe('Participant name.'),
+                entity_type: z
+                    .string()
+                    .describe('Entity type (e.g., "organization", "person").'),
+                role: z.string().describe('Participant role.'),
+            })
+                .describe('Participant record.'))
+                .optional()
+                .describe('Participants when include=participants is requested.'),
+            agenda: z
+                .array(z
+                .object({
+                description: z.string().describe('Agenda item description.'),
+                classification: z.array(z.string()).describe('Agenda item classification.'),
+                subjects: z.array(z.string()).describe('Subject tags for this agenda item.'),
+                related_entities: z
+                    .array(z
+                    .object({
+                    name: z.string().describe('Related entity name.'),
+                    entity_type: z
+                        .string()
+                        .describe('Entity type (e.g., "bill", "person", "organization").'),
+                })
+                    .describe('Related entity record.'))
+                    .describe('Bills, people, or organizations referenced in this agenda item.'),
+            })
+                .describe('Agenda item record.'))
+                .optional()
+                .describe('Agenda items when include=agenda is requested.'),
+        })
+            .describe('Event record.'))
+            .describe('Events 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.'),
+            total_items: z.number().describe('Total matching events.'),
+        })
+            .describe('Pagination metadata.'),
+        coverage_note: z
+            .string()
+            .describe('Event data is experimental — most states do not publish event data to Open States. Empty results may indicate the state lacks data, not that no events occurred.'),
+        message: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty. Absent when results are returned.'),
+    }),
+    async handler(input, ctx) {
+        const svc = getOpenStatesApiService();
+        const result = await svc.searchEvents({
+            jurisdiction: input.jurisdiction,
+            after: input.after,
+            before: input.before,
+            require_bills: input.require_bills,
+            include: input.include && input.include.length > 0 ? input.include : undefined,
+            page: input.page,
+            per_page: input.per_page,
+        }, ctx);
+        ctx.log.info('Searched events', {
+            jurisdiction: input.jurisdiction,
+            count: result.results.length,
+            total: result.pagination.total_items,
+        });
+        const coverage_note = 'Event data is experimental — most states do not publish event data to Open States. Empty results may indicate the state lacks data, not that no events occurred.';
+        if (result.results.length === 0) {
+            return {
+                results: [],
+                pagination: result.pagination,
+                coverage_note,
+                message: 'No events found. Event coverage is experimental — most states do not publish event data to Open States. If you expected results, the state may lack event data entirely.',
+            };
+        }
+        return { results: result.results, pagination: result.pagination, coverage_note };
+    },
+    format: (result) => {
+        const lines = [
+            `**${result.pagination.total_items} events** (page ${result.pagination.page}/${result.pagination.max_page}, per page ${result.pagination.per_page}, showing ${result.results.length})`,
+            '',
+            `> ${result.coverage_note}`,
+        ];
+        if (result.message) {
+            lines.push('');
+            lines.push(`> ${result.message}`);
+        }
+        for (const event of result.results) {
+            lines.push('');
+            lines.push(`## ${event.name}`);
+            lines.push(`**ID:** ${event.id}`);
+            lines.push(`**Classification:** ${event.classification} | **Status:** ${event.status}`);
+            lines.push(event.end_date
+                ? `**Start:** ${event.start_date} | **End:** ${event.end_date}`
+                : `**Start:** ${event.start_date}`);
+            lines.push(`**Jurisdiction:** ${event.jurisdiction.name} (${event.jurisdiction.id})`);
+            if (event.description)
+                lines.push(event.description);
+            if (event.location) {
+                const locStr = event.location.url
+                    ? `${event.location.name} — ${event.location.url}`
+                    : event.location.name;
+                lines.push(`**Location:** ${locStr}`);
+            }
+            if (event.participants?.length) {
+                lines.push(`**Participants:** ${event.participants.map((p) => `${p.name} (${p.role}, ${p.entity_type})`).join(', ')}`);
+            }
+            if (event.agenda?.length) {
+                lines.push('**Agenda:**');
+                for (const item of event.agenda) {
+                    const cls = item.classification.length > 0 ? ` [${item.classification.join(', ')}]` : '';
+                    const subj = item.subjects.length > 0 ? ` | Subjects: ${item.subjects.join(', ')}` : '';
+                    lines.push(`- ${item.description}${cls}${subj}`);
+                    if (item.related_entities.length > 0) {
+                        lines.push(`  Related: ${item.related_entities.map((e) => `${e.name} (${e.entity_type})`).join(', ')}`);
+                    }
+                }
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-events.tool.js.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Search state legislators and officials by name, jurisdiction, chamber, or district.
+ * @module mcp-server/tools/definitions/search-people
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchPeople: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    name: z.ZodOptional<z.ZodString>;
+    org_classification: z.ZodOptional<z.ZodEnum<{
+        upper: "upper";
+        lower: "lower";
+        legislature: "legislature";
+        executive: "executive";
+        government: "government";
+    }>>;
+    district: z.ZodOptional<z.ZodString>;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        other_identifiers: "other_identifiers";
+        sources: "sources";
+        links: "links";
+        other_names: "other_names";
+        offices: "offices";
+    }>>>;
+    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;
+        party: z.ZodString;
+        current_role: z.ZodNullable<z.ZodObject<{
+            title: z.ZodString;
+            org_classification: z.ZodString;
+            district: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+        jurisdiction: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>;
+        given_name: z.ZodString;
+        family_name: z.ZodString;
+        email: z.ZodString;
+        openstates_url: z.ZodString;
+        offices: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            classification: z.ZodString;
+            voice: z.ZodOptional<z.ZodString>;
+            fax: z.ZodOptional<z.ZodString>;
+            address: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>;
+        links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            url: 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>, undefined>;
+//# sourceMappingURL=search-people.tool.d.ts.map

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

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