@cyanheads/openstates-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/get-bill.tool.js

@@ -0,0 +1,319 @@
+/**
+ * @fileoverview Fetch full detail for a specific state bill.
+ * @module mcp-server/tools/definitions/get-bill
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } 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',
+]);
+export const getBill = tool('openstates_get_bill', {
+    title: 'Get Bill',
+    description: 'Fetch full detail for a specific state bill. Accepts either the three-part path (jurisdiction + session + bill_id) or a direct OCD bill ID (openstates_id from search results). Use include to request votes, actions, sponsorships, documents, and versions in one call rather than searching again. include=votes returns the full vote tally and per-legislator positions. include=actions returns the complete action history. Prefer openstates_id when available to avoid session identifier lookup.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        openstates_id: z
+            .string()
+            .optional()
+            .describe('OCD bill ID from openstates_search_bills results (e.g., "ocd-bill/..."). Preferred over the three-part path when available.'),
+        jurisdiction: z
+            .string()
+            .optional()
+            .describe('State name, abbreviation, or OCD-ID. Required when using path-based lookup with session + bill_id.'),
+        session: z
+            .string()
+            .optional()
+            .describe('Session identifier. Required with jurisdiction + bill_id.'),
+        bill_id: z
+            .string()
+            .optional()
+            .describe('Bill identifier as used by the legislature (e.g., "HB 1000", "SB 42"). Required with jurisdiction + session.'),
+        include: z
+            .array(BillIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "sponsorships", "actions", "votes" are most commonly needed. "versions" and "documents" provide links to bill text and fiscal notes.'),
+    }),
+    output: z.object({
+        id: z.string().describe('OCD bill ID.'),
+        identifier: z.string().describe('Bill identifier as used by the legislature.'),
+        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.'),
+        })
+            .describe('Originating chamber.'),
+        classification: z.array(z.string()).describe('Bill classifications.'),
+        subject: z.array(z.string()).describe('Subject tags.'),
+        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('Most recent action description.'),
+        latest_passage_date: z.string().nullable().describe('Date bill passed (when applicable).'),
+        openstates_url: z.string().optional().describe('Open States URL for this bill.'),
+        sponsorships: z
+            .array(z
+            .object({
+            name: z.string().describe('Sponsor name.'),
+            entity_type: z.string().describe('Entity type.'),
+            primary: z.boolean().describe('Whether this is the primary sponsor.'),
+            classification: z.string().describe('Sponsorship classification.'),
+            person: z
+                .object({
+                id: z.string().describe('OCD person ID.'),
+                name: z.string().describe('Person name.'),
+            })
+                .optional()
+                .describe('Linked person record when available.'),
+        })
+            .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('Sequence order.'),
+            organization: z
+                .object({
+                name: z.string().describe('Organization name.'),
+                classification: z.string().describe('Organization classification.'),
+            })
+                .describe('Chamber or committee.'),
+        })
+            .describe('Action record.'))
+            .optional()
+            .describe('Full action history when include=actions is requested.'),
+        votes: z
+            .array(z
+            .object({
+            id: z.string().describe('Vote event ID.'),
+            motion_text: z.string().describe('Motion text.'),
+            start_date: z.string().describe('Vote date.'),
+            result: z.string().describe('Vote result: "pass" or "fail".'),
+            identifier: z.string().describe('Vote identifier.'),
+            counts: z
+                .array(z
+                .object({
+                option: z.string().describe('Vote option (e.g., "yes", "no", "absent").'),
+                value: z.number().describe('Count of votes for this option.'),
+            })
+                .describe('Vote tally entry.'))
+                .describe('Vote tallies by option.'),
+            votes: z
+                .array(z
+                .object({
+                option: z.string().describe('How this legislator voted.'),
+                voter_name: z.string().describe('Voter name.'),
+                voter: z
+                    .object({
+                    id: z.string().describe('OCD person ID.'),
+                    name: z.string().describe('Person name.'),
+                })
+                    .optional()
+                    .describe('Linked person record when available.'),
+            })
+                .describe('Individual legislator vote.'))
+                .describe('Per-legislator vote positions.'),
+        })
+            .describe('Vote event record.'))
+            .optional()
+            .describe('Vote events when include=votes is requested.'),
+        abstracts: z
+            .array(z
+            .object({
+            abstract: z.string().describe('Plain-language summary.'),
+            note: z.string().describe('Source note.'),
+        })
+            .describe('Abstract record.'))
+            .optional()
+            .describe('Bill abstracts when include=abstracts is requested.'),
+        versions: z
+            .array(z
+            .object({
+            id: z.string().describe('Version ID.'),
+            note: z.string().describe('Version note.'),
+            date: z.string().describe('Version date.'),
+            links: z
+                .array(z
+                .object({
+                url: z.string().describe('Document URL.'),
+                media_type: z.string().describe('MIME type.'),
+            })
+                .describe('Document link.'))
+                .describe('Document links.'),
+        })
+            .describe('Bill text version record.'))
+            .optional()
+            .describe('Bill text versions when include=versions is requested.'),
+        documents: z
+            .array(z
+            .object({
+            id: z.string().describe('Document ID.'),
+            note: z.string().describe('Document note.'),
+            date: z.string().describe('Document date.'),
+            links: z
+                .array(z
+                .object({
+                url: z.string().describe('Document URL.'),
+                media_type: z.string().describe('MIME type.'),
+            })
+                .describe('Document link.'))
+                .describe('Document links.'),
+        })
+            .describe('Bill document record.'))
+            .optional()
+            .describe('Bill documents (fiscal notes, etc.) when include=documents is requested.'),
+        related_bills: z
+            .array(z
+            .object({
+            identifier: z.string().describe('Related bill identifier.'),
+            legislative_session: z.string().describe('Session of the related bill.'),
+            relation_type: z
+                .string()
+                .describe('Relationship type (e.g., "companion", "identical").'),
+        })
+            .describe('Related bill record.'))
+            .optional()
+            .describe('Related bills when include=related_bills is requested.'),
+    }),
+    errors: [
+        {
+            reason: 'missing_lookup_params',
+            code: JsonRpcErrorCode.InvalidParams,
+            when: 'Neither openstates_id nor the complete jurisdiction+session+bill_id triple was provided.',
+            recovery: 'Provide either openstates_id (from openstates_search_bills results) or all three of: jurisdiction, session, and bill_id.',
+        },
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Bill does not exist at the given path or OCD ID.',
+            recovery: 'Verify the session identifier with openstates_get_jurisdiction and confirm the bill_id format matches the legislature convention (e.g., "HB 1000" not "HB1000").',
+        },
+    ],
+    async handler(input, ctx) {
+        const hasOcdId = !!input.openstates_id;
+        const hasPathLookup = !!input.jurisdiction && !!input.session && !!input.bill_id;
+        if (!hasOcdId && !hasPathLookup) {
+            throw ctx.fail('missing_lookup_params', 'Provide openstates_id OR jurisdiction + session + bill_id.', {
+                ...ctx.recoveryFor('missing_lookup_params'),
+            });
+        }
+        const svc = getOpenStatesApiService();
+        const include = input.include && input.include.length > 0 ? input.include : undefined;
+        const bill = await (hasOcdId
+            ? svc.getBillById(input.openstates_id, include, ctx)
+            : svc.getBillByPath(input.jurisdiction, input.session, input.bill_id, include, ctx)).catch((err) => {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                const id = input.openstates_id ?? `${input.jurisdiction}/${input.session}/${input.bill_id}`;
+                throw ctx.fail('not_found', `Bill not found: ${id}`, { ...ctx.recoveryFor('not_found') });
+            }
+            throw err;
+        });
+        ctx.log.info('Fetched bill', { id: bill.id, identifier: bill.identifier });
+        return bill;
+    },
+    format: (result) => {
+        const lines = [
+            `# ${result.identifier} — ${result.title}`,
+            `**ID:** ${result.id}`,
+            `**Session:** ${result.session} | **Jurisdiction:** ${result.jurisdiction.name} (${result.jurisdiction.id})`,
+            `**Chamber:** ${result.from_organization.name} (${result.from_organization.classification})`,
+        ];
+        if (result.classification.length > 0)
+            lines.push(`**Classification:** ${result.classification.join(', ')}`);
+        if (result.subject.length > 0)
+            lines.push(`**Subjects:** ${result.subject.join(', ')}`);
+        if (result.first_action_date)
+            lines.push(`**First action:** ${result.first_action_date}`);
+        if (result.latest_action_date) {
+            lines.push(`**Latest action:** ${result.latest_action_date} — ${result.latest_action_description ?? 'N/A'}`);
+        }
+        if (result.latest_passage_date)
+            lines.push(`**Passed:** ${result.latest_passage_date}`);
+        if (result.openstates_url)
+            lines.push(`**URL:** ${result.openstates_url}`);
+        if (result.abstracts?.length) {
+            lines.push('');
+            lines.push('## Summary');
+            for (const abs of result.abstracts) {
+                lines.push(`${abs.abstract} _(${abs.note})_`);
+            }
+        }
+        if (result.sponsorships?.length) {
+            lines.push('');
+            lines.push('## Sponsors');
+            for (const s of result.sponsorships) {
+                const marker = s.primary ? '**Primary**' : 'Cosponsor';
+                const person = s.person ? ` [person: ${s.person.name} (${s.person.id})]` : '';
+                lines.push(`- ${marker}: ${s.name} (${s.classification}, ${s.entity_type})${person}`);
+            }
+        }
+        if (result.actions?.length) {
+            lines.push('');
+            lines.push('## Action History');
+            for (const a of result.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})`);
+            }
+        }
+        if (result.votes?.length) {
+            lines.push('');
+            lines.push('## Votes');
+            for (const v of result.votes) {
+                lines.push(`### ${v.motion_text} (${v.start_date})`);
+                lines.push(`**Result:** ${v.result} | **ID:** ${v.id} | **Identifier:** ${v.identifier}`);
+                const counts = v.counts.map((c) => `${c.option}: ${c.value}`).join(', ');
+                lines.push(`**Tally:** ${counts}`);
+                if (v.votes.length > 0) {
+                    lines.push('**Individual votes:**');
+                    for (const pv of v.votes) {
+                        const voterLink = pv.voter ? ` (ID: ${pv.voter.id}, name: ${pv.voter.name})` : '';
+                        lines.push(`- ${pv.voter_name}${voterLink}: ${pv.option}`);
+                    }
+                }
+            }
+        }
+        if (result.versions?.length) {
+            lines.push('');
+            lines.push('## Bill Text Versions');
+            for (const v of result.versions) {
+                lines.push(`- [${v.id}] ${v.note} (${v.date}): ${v.links.map((l) => `${l.url} [${l.media_type}]`).join(', ')}`);
+            }
+        }
+        if (result.documents?.length) {
+            lines.push('');
+            lines.push('## Documents');
+            for (const d of result.documents) {
+                lines.push(`- [${d.id}] ${d.note} (${d.date}): ${d.links.map((l) => `${l.url} [${l.media_type}]`).join(', ')}`);
+            }
+        }
+        if (result.related_bills?.length) {
+            lines.push('');
+            lines.push('## Related Bills');
+            for (const r of result.related_bills) {
+                lines.push(`- ${r.identifier} (${r.legislative_session}) — ${r.relation_type}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-bill.tool.js.map

package/dist/mcp-server/tools/definitions/get-bill.tool.js.map

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

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

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Fetch full committee detail by OCD organization ID (experimental).
+ * @module mcp-server/tools/definitions/get-committee
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getCommittee: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    committee_id: z.ZodString;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        memberships: "memberships";
+        sources: "sources";
+        links: "links";
+    }>>>;
+}, z.core.$strip>, 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>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Committee ID does not exist in Open States.";
+    readonly recovery: "Use openstates_search_committees to discover valid committee IDs for a jurisdiction. Note that committee data is experimental and not all states have coverage.";
+}]>;
+//# sourceMappingURL=get-committee.tool.d.ts.map

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

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

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

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Fetch full committee detail by OCD organization ID (experimental).
+ * @module mcp-server/tools/definitions/get-committee
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+const CommitteeIncludeEnum = z.enum(['memberships', 'links', 'sources']);
+export const getCommittee = tool('openstates_get_committee', {
+    title: 'Get Committee',
+    description: 'Fetch committee detail by OCD organization ID. Returns name, classification, and membership roster when include=memberships is requested. Experimental — not all states have committee data in Open States. Obtain the committee_id from openstates_search_committees.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    input: z.object({
+        committee_id: z
+            .string()
+            .min(1)
+            .describe('OCD organization ID (from openstates_search_committees results).'),
+        include: z
+            .array(CommitteeIncludeEnum)
+            .optional()
+            .describe('Related data to inline. "memberships" includes the full roster with member roles.'),
+    }),
+    output: z.object({
+        id: z.string().describe('OCD organization ID.'),
+        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.'),
+    }),
+    errors: [
+        {
+            reason: 'not_found',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'Committee ID does not exist in Open States.',
+            recovery: 'Use openstates_search_committees to discover valid committee IDs for a jurisdiction. Note that committee data is experimental and not all states have coverage.',
+        },
+    ],
+    async handler(input, ctx) {
+        const svc = getOpenStatesApiService();
+        const committee = await svc
+            .getCommittee(input.committee_id, input.include && input.include.length > 0 ? input.include : undefined, ctx)
+            .catch((err) => {
+            if (err instanceof McpError && err.code === JsonRpcErrorCode.NotFound) {
+                throw ctx.fail('not_found', `Committee not found: ${input.committee_id}`, {
+                    ...ctx.recoveryFor('not_found'),
+                });
+            }
+            throw err;
+        });
+        ctx.log.info('Fetched committee', { id: committee.id, name: committee.name });
+        return {
+            id: committee.id,
+            name: committee.name,
+            classification: committee.classification,
+            parent_id: committee.parent_id,
+            ...(committee.memberships ? { memberships: committee.memberships } : {}),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `# ${result.name}`,
+            `**ID:** ${result.id}`,
+            `**Classification:** ${result.classification}`,
+        ];
+        if (result.parent_id)
+            lines.push(`**Parent ID:** ${result.parent_id}`);
+        if (result.memberships?.length) {
+            lines.push('');
+            lines.push('## Members');
+            for (const m of result.memberships) {
+                lines.push(`- ${m.person_name} (${m.role}) — ID: ${m.person_id}`);
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=get-committee.tool.js.map

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

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

package/dist/mcp-server/tools/definitions/get-event.tool.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Fetch full event detail by OCD event ID (experimental).
+ * @module mcp-server/tools/definitions/get-event
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getEvent: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    event_id: z.ZodString;
+    include: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        sources: "sources";
+        documents: "documents";
+        links: "links";
+        media: "media";
+        participants: "participants";
+        agenda: "agenda";
+    }>>>;
+}, z.core.$strip>, 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>>;
+    links: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>>;
+    media: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        note: 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>, readonly [{
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Event ID does not exist in Open States.";
+    readonly recovery: "Use openstates_search_events with a jurisdiction and date range to discover valid event IDs. Note that event data is experimental and coverage varies widely by state.";
+}]>;
+//# sourceMappingURL=get-event.tool.d.ts.map

package/dist/mcp-server/tools/definitions/get-event.tool.d.ts.map

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