openstates-mcp-server 0.1.1

package/changelog/template.md

@@ -0,0 +1,119 @@
+---
+# FORMAT REFERENCE — do not edit. Copy this file to
+# `changelog/<major.minor>.x/<version>.md` (e.g. `changelog/0.8.x/0.8.6.md`)
+# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
+# with a concrete date.
+
+# Required. One-line GitHub Release-style headline. 350 character cap.
+# Default short and scannable. Don't pad, don't stitch unrelated changes with
+# semicolons — pick the headline. Quotes required: unquoted YAML treats `: `
+# inside the value as a key separator and fails GitHub's strict parser.
+summary: ""
+
+# Set `true` when consumers must change code to upgrade: API removals,
+# signature changes, config renames, behavior changes that break existing
+# usage. Flagged as `Breaking` in the rollup.
+breaking: false
+
+# Set `true` if this release contains any security fix. Pairs with the
+# `## Security` section below. Flagged as `Security` in the rollup so
+# users can triage upgrade urgency at a glance.
+security: false
+---
+
+# <version> — YYYY-MM-DD
+
+<!--
+  AUTHORING GUIDE — applies to the new per-version file you create from this
+  template.
+
+  Audience: someone scanning release notes to decide what affects them. Lead
+  each bullet with the symbol or concept name in **bold** so they can skip
+  what's irrelevant and zoom in on what's not.
+
+  Tone: terse, fact-dense, not verbose. Default to one sentence per bullet —
+  name the symbol, state what changed, stop. Use a second sentence only when
+  it carries weight. If a bullet feels long, it is.
+
+  Cut: mechanism walkthroughs (those belong in JSDoc, AGENTS.md, or the
+  relevant skill), ceremonial framings ("This release introduces…",
+  backwards-compat paragraphs), file-by-file test enumerations, internal
+  implementation notes. Prefer code/symbol names over English re-explanations.
+
+  Narrative intro: skip by default. Add one short sentence only when the
+  release theme genuinely needs framing the bullets can't carry.
+
+  Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
+  Fixed, Security. Include only sections with entries; delete the rest
+  (including the commented-out scaffolding below). Don't ship empty headers.
+
+  Include: every distinct fact a reader needs to adopt or audit the release —
+  new exports, signatures, lint rule IDs, env vars, breaking changes, version
+  bumps on shipped skills. Nothing more.
+
+  Links: link issues, PRs, docs, or skills where they help a reader jump to
+  context. Once per item per entry — don't re-link the same issue in summary,
+  narrative, and bullet. Skip links for inline symbol names; code spans speak
+  for themselves.
+
+  Issue/PR URLs: use full URLs. GitHub's bare `#NN` auto-link only resolves
+  inside its own UI, not in npm reads or local editors.
+
+      [#38](https://github.com/cyanheads/mcp-ts-core/issues/38)   ← issue
+      [#42](https://github.com/cyanheads/mcp-ts-core/pull/42)     ← PR
+
+  Verify numbers exist before linking (`gh issue view NN`, `gh pr view NN`).
+  Never speculate on a future number — `#42` for an upcoming PR silently
+  resolves to whatever real item already owns 42, and timeline previews pull
+  in that unrelated item's metadata.
+
+  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
+  via `gh release create --notes-from-tag`. The tag is a derivative of this
+  changelog entry — a condensed, scannable version, not a copy. Format:
+
+    <theme — omit version number, GitHub prepends it>
+                                                          ← blank line
+    <1-2 sentence context: what this release does>
+                                                          ← blank line
+    Dependency bumps:                                     ← section header
+                                                          ← blank line
+    - `@cyanheads/mcp-ts-core` ^0.9.1 → ^0.9.6          ← bullet
+                                                          ← blank line
+    Changed:                                              ← only sections with entries
+                                                          ← blank line
+    - `format()` output includes `query` in text mode
+                                                          ← blank line
+    Added:
+                                                          ← blank line
+    - `manifest.json` scaffolded for MCPB bundle support
+    - Install badges (Claude Desktop, Cursor, VS Code)
+                                                          ← blank line
+    <N> tests pass; `bun run devcheck` clean.             ← footer
+
+  Never a flat comma-separated string. Always structured markdown with
+  sections. The tag must scan well as a rendered GitHub Release page.
+-->
+
+## Added
+
+-
+
+## Changed
+
+-
+
+<!-- ## Deprecated
+
+- -->
+
+<!-- ## Removed
+
+- -->
+
+## Fixed
+
+-
+
+<!-- ## Security
+
+- -->

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

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

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

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

package/dist/config/server-config.js

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Server-specific configuration for openstates-mcp-server.
+ * @module config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { parseEnvConfig } from '@cyanheads/mcp-ts-core/config';
+const ServerConfigSchema = z.object({
+    apiKey: z.string().min(1).describe('Open States API key from open.pluralpolicy.com'),
+    apiBaseUrl: z.string().default('https://v3.openstates.org').describe('Open States API base URL'),
+});
+let _config;
+export function getServerConfig() {
+    _config ??= parseEnvConfig(ServerConfigSchema, {
+        apiKey: 'OPENSTATES_API_KEY',
+        apiBaseUrl: 'OPENSTATES_API_BASE_URL',
+    });
+    return _config;
+}
+//# sourceMappingURL=server-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server-config.js","sourceRoot":"","sources":["../../src/config/server-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,gDAAgD,CAAC;IACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CACjG,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,cAAc,CAAC,kBAAkB,EAAE;QAC7C,MAAM,EAAE,oBAAoB;QAC5B,UAAU,EAAE,yBAAyB;KACtC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

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

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview openstates-mcp-server MCP server entry point.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { getServerConfig } from './config/server-config.js';
+// Prompts
+import { billResearch } from './mcp-server/prompts/definitions/bill-research.prompt.js';
+import { legislatorProfile } from './mcp-server/prompts/definitions/legislator-profile.prompt.js';
+// Resources
+import { jurisdictionResource } from './mcp-server/resources/definitions/jurisdiction.resource.js';
+// Tools
+import { getBill } from './mcp-server/tools/definitions/get-bill.tool.js';
+import { getCommittee } from './mcp-server/tools/definitions/get-committee.tool.js';
+import { getEvent } from './mcp-server/tools/definitions/get-event.tool.js';
+import { getJurisdiction } from './mcp-server/tools/definitions/get-jurisdiction.tool.js';
+import { getLegislatorsByLocation } from './mcp-server/tools/definitions/get-legislators-by-location.tool.js';
+import { listJurisdictions } from './mcp-server/tools/definitions/list-jurisdictions.tool.js';
+import { searchBills } from './mcp-server/tools/definitions/search-bills.tool.js';
+import { searchCommittees } from './mcp-server/tools/definitions/search-committees.tool.js';
+import { searchEvents } from './mcp-server/tools/definitions/search-events.tool.js';
+import { searchPeople } from './mcp-server/tools/definitions/search-people.tool.js';
+import { initOpenStatesApiService } from './services/openstates/openstates-service.js';
+await createApp({
+    tools: [
+        searchBills,
+        getBill,
+        searchPeople,
+        getLegislatorsByLocation,
+        searchCommittees,
+        getCommittee,
+        searchEvents,
+        getEvent,
+        listJurisdictions,
+        getJurisdiction,
+    ],
+    resources: [jurisdictionResource],
+    prompts: [billResearch, legislatorProfile],
+    instructions: 'Open States MCP server — US state legislative data for all 50 states, DC, and Puerto Rico.\n' +
+        '- Use openstates_list_jurisdictions or openstates_get_jurisdiction (include=legislative_sessions) to discover valid session identifiers before filtering bill searches.\n' +
+        '- Either jurisdiction or q is required for openstates_search_bills.\n' +
+        '- Committee and event tools are experimental — not all states have coverage.\n' +
+        '- Use include parameter on search and get tools to request related data inline and avoid N+1 follow-up calls.',
+    setup(core) {
+        const serverConfig = getServerConfig();
+        initOpenStatesApiService(core.config, core.storage, serverConfig);
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,MAAM,0DAA0D,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,MAAM,+DAA+D,CAAC;AAClG,YAAY;AACZ,OAAO,EAAE,oBAAoB,EAAE,MAAM,6DAA6D,CAAC;AACnG,QAAQ;AACR,OAAO,EAAE,OAAO,EAAE,MAAM,iDAAiD,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,kDAAkD,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,yDAAyD,CAAC;AAC1F,OAAO,EAAE,wBAAwB,EAAE,MAAM,oEAAoE,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,MAAM,2DAA2D,CAAC;AAC9F,OAAO,EAAE,WAAW,EAAE,MAAM,qDAAqD,CAAC;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,0DAA0D,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,YAAY,EAAE,MAAM,sDAAsD,CAAC;AACpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AAEvF,MAAM,SAAS,CAAC;IACd,KAAK,EAAE;QACL,WAAW;QACX,OAAO;QACP,YAAY;QACZ,wBAAwB;QACxB,gBAAgB;QAChB,YAAY;QACZ,YAAY;QACZ,QAAQ;QACR,iBAAiB;QACjB,eAAe;KAChB;IACD,SAAS,EAAE,CAAC,oBAAoB,CAAC;IACjC,OAAO,EAAE,CAAC,YAAY,EAAE,iBAAiB,CAAC;IAC1C,YAAY,EACV,8FAA8F;QAC9F,2KAA2K;QAC3K,uEAAuE;QACvE,gFAAgF;QAChF,+GAA+G;IACjH,KAAK,CAAC,IAAI;QACR,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Structured framework for analyzing a state bill.
+ * @module mcp-server/prompts/definitions/bill-research
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const billResearch: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    jurisdiction: z.ZodString;
+    session: z.ZodString;
+    bill_id: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=bill-research.prompt.d.ts.map

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

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

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

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Structured framework for analyzing a state bill.
+ * @module mcp-server/prompts/definitions/bill-research
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const billResearch = prompt('openstates_bill_research', {
+    description: 'Structured framework for analyzing a state bill: summary, sponsors, committee referrals, action timeline, vote record, and related legislation. Produces a comprehensive research brief.',
+    args: z.object({
+        jurisdiction: z
+            .string()
+            .describe('State name, abbreviation, or OCD-ID (e.g., "Washington", "wa").'),
+        session: z
+            .string()
+            .describe('Session identifier (e.g., "2025", "2025rs"). Use openstates_get_jurisdiction to confirm.'),
+        bill_id: z
+            .string()
+            .describe('Bill identifier as used by the legislature (e.g., "HB 1000", "SB 42").'),
+    }),
+    generate: (args) => [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: [
+                    `Research the following state bill and produce a comprehensive analysis brief:`,
+                    ``,
+                    `**Jurisdiction:** ${args.jurisdiction}`,
+                    `**Session:** ${args.session}`,
+                    `**Bill ID:** ${args.bill_id}`,
+                    ``,
+                    `Use the openstates tools to gather the following information and structure your response:`,
+                    ``,
+                    `1. **Bill Overview** — Fetch full bill detail with include=sponsorships,actions,votes,abstracts,versions`,
+                    `   - Title and official identifier`,
+                    `   - Plain-language summary (from abstracts if available, otherwise synthesize from title and actions)`,
+                    `   - Bill classification and subject tags`,
+                    ``,
+                    `2. **Sponsors** — Primary and co-sponsors with party affiliation`,
+                    `   - Use openstates_search_people to look up sponsor profiles if needed`,
+                    ``,
+                    `3. **Legislative History** — Chronological action timeline`,
+                    `   - Introduction date and originating chamber`,
+                    `   - Committee referrals`,
+                    `   - Hearings and amendments`,
+                    `   - Chamber passage dates`,
+                    `   - Current status`,
+                    ``,
+                    `4. **Vote Record** — If votes are available:`,
+                    `   - Motion, result, and tally (yes/no/absent counts)`,
+                    `   - Notable yea/nay positions`,
+                    ``,
+                    `5. **Related Legislation** — Companion bills, identical bills, or related measures`,
+                    ``,
+                    `6. **Bill Text** — Links to the latest enrolled or introduced version`,
+                    ``,
+                    `7. **Assessment** — Based on action history and vote record:`,
+                    `   - Current probability of passage`,
+                    `   - Key obstacles or supporters`,
+                    `   - Expected next steps`,
+                ].join('\n'),
+            },
+        },
+    ],
+});
+//# sourceMappingURL=bill-research.prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bill-research.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/bill-research.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,0BAA0B,EAAE;IAC7D,WAAW,EACT,0LAA0L;IAC5L,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CAAC,iEAAiE,CAAC;QAC9E,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CACP,0FAA0F,CAC3F;QACH,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,QAAQ,CAAC,wEAAwE,CAAC;KACtF,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;oBACJ,+EAA+E;oBAC/E,EAAE;oBACF,qBAAqB,IAAI,CAAC,YAAY,EAAE;oBACxC,gBAAgB,IAAI,CAAC,OAAO,EAAE;oBAC9B,gBAAgB,IAAI,CAAC,OAAO,EAAE;oBAC9B,EAAE;oBACF,2FAA2F;oBAC3F,EAAE;oBACF,0GAA0G;oBAC1G,oCAAoC;oBACpC,wGAAwG;oBACxG,2CAA2C;oBAC3C,EAAE;oBACF,kEAAkE;oBAClE,yEAAyE;oBACzE,EAAE;oBACF,4DAA4D;oBAC5D,gDAAgD;oBAChD,0BAA0B;oBAC1B,8BAA8B;oBAC9B,4BAA4B;oBAC5B,qBAAqB;oBACrB,EAAE;oBACF,8CAA8C;oBAC9C,uDAAuD;oBACvD,gCAAgC;oBAChC,EAAE;oBACF,oFAAoF;oBACpF,EAAE;oBACF,uEAAuE;oBACvE,EAAE;oBACF,8DAA8D;oBAC9D,qCAAqC;oBACrC,kCAAkC;oBAClC,0BAA0B;iBAC3B,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF;KACF;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Research framework for profiling a state legislator.
+ * @module mcp-server/prompts/definitions/legislator-profile
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const legislatorProfile: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    name: z.ZodString;
+    jurisdiction: z.ZodString;
+}, z.core.$strip>>;
+//# sourceMappingURL=legislator-profile.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.d.ts.map

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

package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Research framework for profiling a state legislator.
+ * @module mcp-server/prompts/definitions/legislator-profile
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const legislatorProfile = prompt('openstates_legislator_profile', {
+    description: 'Research framework for profiling a legislator: sponsored bills, committee assignments, voting record, and contact details. Produces a structured profile for constituent research, advocacy, or journalistic purposes.',
+    args: z.object({
+        name: z.string().describe('Legislator name or partial name (e.g., "Smith", "Jane Smith").'),
+        jurisdiction: z
+            .string()
+            .describe('State name, abbreviation, or OCD-ID (e.g., "Washington", "wa").'),
+    }),
+    generate: (args) => [
+        {
+            role: 'user',
+            content: {
+                type: 'text',
+                text: [
+                    `Research and profile the following state legislator:`,
+                    ``,
+                    `**Name:** ${args.name}`,
+                    `**Jurisdiction:** ${args.jurisdiction}`,
+                    ``,
+                    `Use the openstates tools to gather the following and produce a structured profile:`,
+                    ``,
+                    `1. **Identity & Role** — Use openstates_search_people (name + jurisdiction, include=offices,links)`,
+                    `   - Full name, party, chamber, district`,
+                    `   - Contact information (phone, office address, email)`,
+                    `   - Website and social media links`,
+                    ``,
+                    `2. **Sponsored Legislation** — Use openstates_search_bills (jurisdiction + sponsor=name)`,
+                    `   - Bills sponsored in the current session`,
+                    `   - Primary vs. co-sponsorships`,
+                    `   - Key subject areas and recurring themes`,
+                    ``,
+                    `3. **Committee Assignments** — Use openstates_search_committees (jurisdiction, include=memberships)`,
+                    `   - Look for their name in membership rosters`,
+                    `   - Note chair/ranking member positions when applicable`,
+                    `   - Note: committee data is experimental and may not be available for all states`,
+                    ``,
+                    `4. **Voting Record** — Use openstates_search_bills to find notable bills in their jurisdiction, then openstates_get_bill with include=votes`,
+                    `   - Voting patterns on major legislation`,
+                    `   - Party-line vs. cross-aisle votes`,
+                    ``,
+                    `5. **Profile Summary** — Synthesize into a brief profile covering:`,
+                    `   - Legislative priorities based on sponsored bills`,
+                    `   - Policy positions inferred from voting record`,
+                    `   - Key constituent services information`,
+                ].join('\n'),
+            },
+        },
+    ],
+});
+//# sourceMappingURL=legislator-profile.prompt.js.map

package/dist/mcp-server/prompts/definitions/legislator-profile.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislator-profile.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/legislator-profile.prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,+BAA+B,EAAE;IACvE,WAAW,EACT,wNAAwN;IAC1N,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gEAAgE,CAAC;QAC3F,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,CAAC,iEAAiE,CAAC;KAC/E,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QAClB;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE;gBACP,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE;oBACJ,sDAAsD;oBACtD,EAAE;oBACF,aAAa,IAAI,CAAC,IAAI,EAAE;oBACxB,qBAAqB,IAAI,CAAC,YAAY,EAAE;oBACxC,EAAE;oBACF,oFAAoF;oBACpF,EAAE;oBACF,oGAAoG;oBACpG,0CAA0C;oBAC1C,yDAAyD;oBACzD,qCAAqC;oBACrC,EAAE;oBACF,0FAA0F;oBAC1F,6CAA6C;oBAC7C,kCAAkC;oBAClC,6CAA6C;oBAC7C,EAAE;oBACF,qGAAqG;oBACrG,gDAAgD;oBAChD,0DAA0D;oBAC1D,mFAAmF;oBACnF,EAAE;oBACF,6IAA6I;oBAC7I,2CAA2C;oBAC3C,uCAAuC;oBACvC,EAAE;oBACF,oEAAoE;oBACpE,sDAAsD;oBACtD,mDAAmD;oBACnD,2CAA2C;iBAC5C,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;SACF;KACF;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview Jurisdiction metadata resource — stable reference context for session identifiers and coverage dates.
+ * @module mcp-server/resources/definitions/jurisdiction
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const jurisdictionResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    jurisdiction_id: z.ZodString;
+}, z.core.$strip>, undefined, undefined>;
+//# sourceMappingURL=jurisdiction.resource.d.ts.map

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

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

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

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Jurisdiction metadata resource — stable reference context for session identifiers and coverage dates.
+ * @module mcp-server/resources/definitions/jurisdiction
+ */
+import { resource, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenStatesApiService } from '../../../services/openstates/openstates-service.js';
+export const jurisdictionResource = resource('openstates://jurisdiction/{jurisdiction_id}', {
+    title: 'Jurisdiction Metadata',
+    description: 'Jurisdiction metadata including current sessions, coverage dates, and bill/people update timestamps. Use as stable reference context before querying bills or people — inject this to prime session identifiers without a tool call.',
+    mimeType: 'application/json',
+    params: z.object({
+        jurisdiction_id: z
+            .string()
+            .describe('OCD jurisdiction ID, state name (e.g., "Washington"), or two-letter abbreviation (e.g., "wa").'),
+    }),
+    async handler(params, ctx) {
+        const svc = getOpenStatesApiService();
+        const jurisdiction = await svc.getJurisdiction(params.jurisdiction_id, ['legislative_sessions'], ctx);
+        if (!jurisdiction) {
+            throw notFound(`Jurisdiction not found: ${params.jurisdiction_id}`, {
+                jurisdiction_id: params.jurisdiction_id,
+            });
+        }
+        ctx.log.debug('Fetched jurisdiction resource', {
+            id: jurisdiction.id,
+            name: jurisdiction.name,
+        });
+        return jurisdiction;
+    },
+    list: async () => ({
+        resources: [
+            {
+                uri: 'openstates://jurisdiction/wa',
+                name: 'Washington',
+                description: 'Washington State jurisdiction metadata',
+                mimeType: 'application/json',
+            },
+            {
+                uri: 'openstates://jurisdiction/ca',
+                name: 'California',
+                description: 'California jurisdiction metadata',
+                mimeType: 'application/json',
+            },
+            {
+                uri: 'openstates://jurisdiction/ny',
+                name: 'New York',
+                description: 'New York jurisdiction metadata',
+                mimeType: 'application/json',
+            },
+            {
+                uri: 'openstates://jurisdiction/tx',
+                name: 'Texas',
+                description: 'Texas jurisdiction metadata',
+                mimeType: 'application/json',
+            },
+        ],
+    }),
+});
+//# sourceMappingURL=jurisdiction.resource.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jurisdiction.resource.js","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/jurisdiction.resource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAC;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,6CAA6C,EAAE;IAC1F,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,sOAAsO;IACxO,QAAQ,EAAE,kBAAkB;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,eAAe,EAAE,CAAC;aACf,MAAM,EAAE;aACR,QAAQ,CACP,gGAAgG,CACjG;KACJ,CAAC;IAEF,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG;QACvB,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,MAAM,GAAG,CAAC,eAAe,CAC5C,MAAM,CAAC,eAAe,EACtB,CAAC,sBAAsB,CAAC,EACxB,GAAG,CACJ,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,MAAM,QAAQ,CAAC,2BAA2B,MAAM,CAAC,eAAe,EAAE,EAAE;gBAClE,eAAe,EAAE,MAAM,CAAC,eAAe;aACxC,CAAC,CAAC;QACL,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE;YAC7C,EAAE,EAAE,YAAY,CAAC,EAAE;YACnB,IAAI,EAAE,YAAY,CAAC,IAAI;SACxB,CAAC,CAAC;QACH,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,SAAS,EAAE;YACT;gBACE,GAAG,EAAE,8BAA8B;gBACnC,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,wCAAwC;gBACrD,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,8BAA8B;gBACnC,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,kCAAkC;gBAC/C,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,8BAA8B;gBACnC,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,gCAAgC;gBAC7C,QAAQ,EAAE,kBAAkB;aAC7B;YACD;gBACE,GAAG,EAAE,8BAA8B;gBACnC,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,6BAA6B;gBAC1C,QAAQ,EAAE,kBAAkB;aAC7B;SACF;KACF,CAAC;CACH,CAAC,CAAC"}

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

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Fetch full detail for a specific state bill.
+ * @module mcp-server/tools/definitions/get-bill
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const getBill: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    openstates_id: z.ZodOptional<z.ZodString>;
+    jurisdiction: z.ZodOptional<z.ZodString>;
+    session: z.ZodOptional<z.ZodString>;
+    bill_id: 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";
+    }>>>;
+}, z.core.$strip>, 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>;
+    openstates_url: z.ZodOptional<z.ZodString>;
+    sponsorships: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        entity_type: z.ZodString;
+        primary: z.ZodBoolean;
+        classification: z.ZodString;
+        person: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.core.$strip>>;
+    }, 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>>>;
+    votes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        motion_text: z.ZodString;
+        start_date: z.ZodString;
+        result: z.ZodString;
+        identifier: z.ZodString;
+        counts: z.ZodArray<z.ZodObject<{
+            option: z.ZodString;
+            value: z.ZodNumber;
+        }, z.core.$strip>>;
+        votes: z.ZodArray<z.ZodObject<{
+            option: z.ZodString;
+            voter_name: z.ZodString;
+            voter: z.ZodOptional<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    abstracts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        abstract: z.ZodString;
+        note: z.ZodString;
+    }, z.core.$strip>>>;
+    versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        note: z.ZodString;
+        date: z.ZodString;
+        links: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            media_type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    documents: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        note: z.ZodString;
+        date: z.ZodString;
+        links: z.ZodArray<z.ZodObject<{
+            url: z.ZodString;
+            media_type: z.ZodString;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>>;
+    related_bills: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        identifier: z.ZodString;
+        legislative_session: z.ZodString;
+        relation_type: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "missing_lookup_params";
+    readonly code: JsonRpcErrorCode.InvalidParams;
+    readonly when: "Neither openstates_id nor the complete jurisdiction+session+bill_id triple was provided.";
+    readonly recovery: "Provide either openstates_id (from openstates_search_bills results) or all three of: jurisdiction, session, and bill_id.";
+}, {
+    readonly reason: "not_found";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "Bill does not exist at the given path or OCD ID.";
+    readonly 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\").";
+}]>;
+//# sourceMappingURL=get-bill.tool.d.ts.map

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

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