@cyanheads/openfec-mcp-server 0.2.2

package/README.md

@@ -0,0 +1,297 @@
+<div align="center">
+  <h1>@cyanheads/openfec-mcp-server</h1>
+  <p><b>Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.</b></p>
+  <p><b>9 Tools · 5 Resources · 2 Prompts</b></p>
+</div>
+
+<div align="center">
+
+[![Version](https://img.shields.io/badge/Version-0.2.2-blue.svg?style=flat-square)](./CHANGELOG.md) [![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-259?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) 
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-^1.2.0-f9f1e1.svg?style=flat-square)](https://bun.sh/)
+
+</div>
+
+---
+
+## Tools
+
+Nine tools for querying federal election campaign finance data:
+
+| Tool Name | Description |
+|:----------|:------------|
+| `openfec_search_candidates` | Find federal candidates by name, state, office, party, or cycle. |
+| `openfec_search_committees` | Find political committees by name, type, candidate affiliation, or state. |
+| `openfec_search_contributions` | Search itemized individual contributions or aggregate breakdowns by size, state, employer, or occupation. |
+| `openfec_search_disbursements` | Search itemized committee spending or aggregate breakdowns by purpose or recipient. |
+| `openfec_search_expenditures` | Search independent expenditures supporting or opposing federal candidates. |
+| `openfec_search_filings` | Search FEC filings and reports by committee, candidate, form type, or date range. |
+| `openfec_lookup_elections` | Look up election races and candidate financial summaries. |
+| `openfec_search_legal` | Search FEC legal documents: advisory opinions, enforcement cases, and administrative fines. |
+| `openfec_lookup_calendar` | Look up FEC calendar events, filing deadlines, and election dates. |
+
+### `openfec_search_candidates`
+
+Find federal candidates with optional financial totals.
+
+- Full-text name search plus filters for state, district, office, party, cycle, incumbent status
+- Fetch a specific candidate by FEC ID (H/S/P prefix) with full detail
+- Optional financial totals: receipts, disbursements, cash on hand
+- Pagination up to 100 results per page
+
+---
+
+### `openfec_search_committees`
+
+Find political committees (campaign, PAC, Super PAC, party).
+
+- Full-text name search plus filters for type, designation, party, state, candidate affiliation
+- Fetch a specific committee by FEC ID (C prefix)
+- Committee types: House, Senate, Presidential, Super PAC, PAC, Party
+- Treasurer name search
+
+---
+
+### `openfec_search_contributions`
+
+Search Schedule A contribution data with five query modes.
+
+- **itemized**: Individual contribution records with keyset cursor pagination
+- **by_size**: Aggregate breakdowns by contribution size range
+- **by_state**: Geographic breakdown of contributions
+- **by_employer**: Top employer aggregates
+- **by_occupation**: Top occupation aggregates
+- Filters: donor name, employer, occupation, city, state, ZIP, date range, amount range
+
+---
+
+### `openfec_search_disbursements`
+
+Search Schedule B spending data with four query modes.
+
+- **itemized**: Individual disbursement records with keyset cursor pagination
+- **by_purpose**: Aggregate by spending purpose category
+- **by_recipient**: Aggregate by payee name
+- **by_recipient_id**: Aggregate by recipient committee ID
+- Filters: recipient name, description, date range, amount range
+
+---
+
+### `openfec_search_expenditures`
+
+Search Schedule E independent expenditure data.
+
+- **itemized**: Individual expenditure records with support/oppose indicator
+- **by_candidate**: Aggregated totals per targeted candidate
+- Filters: committee, candidate, office, party, 24/48-hour notices, date and amount range
+
+---
+
+### `openfec_search_filings`
+
+Search FEC filings and reports.
+
+- Form types: F3 (House/Senate quarterly), F3P (Presidential), F3X (PAC/party), F24 (24-hour IE notice), F1/F2 (organizational/candidacy), F5 (IE by persons)
+- Report type codes: Q1/Q2/Q3, YE, monthly, pre/post election
+- Amendment filtering with most-recent-only option
+- Date range filtering by FEC receipt date
+
+---
+
+### `openfec_search_legal`
+
+Search across FEC legal document types.
+
+- Advisory opinions, MURs (enforcement cases), ADRs, administrative fines, statutes
+- Look up specific cases by AO number or case number
+- Filter by respondent, regulatory/statutory citation, penalty amount range
+- Offset-based pagination (up to 200 results per page)
+
+---
+
+### `openfec_lookup_elections`
+
+Look up federal election races.
+
+- **search**: Candidates in a race with financial totals
+- **summary**: Aggregate race financial summary
+- Office types: president, senate, house
+- ZIP code lookup to find races covering a location
+- Full election period expansion (4yr president, 6yr senate, 2yr house)
+
+---
+
+### `openfec_lookup_calendar`
+
+Look up FEC dates and deadlines.
+
+- **events**: FEC calendar events
+- **filing_deadlines**: Report due dates by type and year
+- **election_dates**: Upcoming and past election dates by state and office
+- Date range filtering
+
+## Resources
+
+| URI Pattern | Description |
+|:------------|:------------|
+| `openfec://candidate/{candidate_id}` | Federal candidate profile with current financial totals. |
+| `openfec://committee/{committee_id}` | Political committee profile with type, designation, and financial summary. |
+| `openfec://election/{cycle}/{office}` | Presidential or at-large election race with candidate financial totals. |
+| `openfec://election/{cycle}/{office}/{state}` | Senate or state-level election race with candidate financial totals. |
+| `openfec://election/{cycle}/{office}/{state}/{district}` | House district election race with candidate financial totals. |
+
+## Prompts
+
+| Prompt | Description |
+|:-------|:------------|
+| `openfec_campaign_analysis` | Structured analysis of a candidate's financial position — fundraising trajectory, burn rate, cash reserves, donor composition, and opponent comparison. |
+| `openfec_money_trail` | Framework for tracing the flow of money around a candidate or race — direct fundraising, PAC support, independent expenditures, and party spending. |
+
+## Features
+
+Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core):
+
+- Declarative tool definitions — single file per tool, framework handles registration and validation
+- Unified error handling across all tools
+- Pluggable auth (`none`, `jwt`, `oauth`)
+- Swappable storage backends: `in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`
+- Structured logging with optional OpenTelemetry tracing
+- Runs locally (stdio/HTTP) or via Docker from the same codebase
+
+OpenFEC-specific:
+
+- Type-safe client wrapping the [OpenFEC REST API](https://api.open.fec.gov/developers/)
+- Multi-mode tools supporting both itemized records and aggregate breakdowns
+- Keyset cursor pagination for high-volume Schedule A/B/E data
+- Automatic retry with configurable timeout and max retries
+- Error sanitization strips API keys from error messages; HTTP status errors enriched with actionable hints
+- Two guided investigation prompts for campaign finance analysis workflows
+
+## Getting Started
+
+### Prerequisites
+
+- [Bun v1.2.0](https://bun.sh/) or higher
+- A free [OpenFEC API key](https://api.data.gov/signup/)
+
+### Installation
+
+1. **Clone the repository:**
+```sh
+git clone https://github.com/cyanheads/openfec-mcp-server.git
+```
+
+2. **Navigate into the directory:**
+```sh
+cd openfec-mcp-server
+```
+
+3. **Install dependencies:**
+```sh
+bun install
+```
+
+4. **Set up environment:**
+```sh
+cp .env.example .env
+# Edit .env and add your FEC_API_KEY
+```
+
+### MCP Client Configuration
+
+Add to your MCP client config (e.g., `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "openfec": {
+      "type": "stdio",
+      "command": "bun",
+      "args": ["run", "start:stdio"],
+      "cwd": "/path/to/openfec-mcp-server",
+      "env": {
+        "FEC_API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Configuration
+
+| Variable | Description | Default |
+|:---------|:------------|:--------|
+| `FEC_API_KEY` | **Required.** OpenFEC API key. Get one free at [api.data.gov/signup](https://api.data.gov/signup/). | — |
+| `FEC_BASE_URL` | OpenFEC API base URL. | `https://api.open.fec.gov/v1` |
+| `FEC_MAX_RETRIES` | Max retry attempts for failed API requests. | `3` |
+| `FEC_REQUEST_TIMEOUT` | Request timeout in milliseconds. | `30000` |
+| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |
+| `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |
+| `MCP_HTTP_HOST` | Hostname for HTTP server. | `localhost` |
+| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |
+| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |
+| `LOGS_DIR` | Directory for log files (Node.js only). | `<project-root>/logs` |
+| `STORAGE_PROVIDER_TYPE` | Storage backend. | `in-memory` |
+| `OTEL_ENABLED` | Enable OpenTelemetry tracing. | `false` |
+
+## Running the Server
+
+### Local Development
+
+- **Build and run the production version:**
+  ```sh
+  bun run build
+  bun run start:http   # or start:stdio
+  ```
+
+- **Run in dev mode (with watch):**
+  ```sh
+  bun run dev:stdio    # or dev:http
+  ```
+
+- **Run checks and tests:**
+  ```sh
+  bun run devcheck     # Lints, formats, type-checks
+  bun run test         # Runs test suite
+  ```
+
+### Docker
+
+```sh
+docker build -t openfec-mcp-server .
+docker run -e FEC_API_KEY=your-key -p 3010:3010 openfec-mcp-server
+```
+
+## Project Structure
+
+| Directory | Purpose |
+|:----------|:--------|
+| `src/mcp-server/tools/definitions/` | Tool definitions (`*.tool.ts`). |
+| `src/mcp-server/resources/definitions/` | Resource definitions (`*.resource.ts`). |
+| `src/mcp-server/prompts/definitions/` | Prompt definitions (`*.prompt.ts`). |
+| `src/services/openfec/` | OpenFEC API client and domain types. |
+| `src/config/` | Environment variable parsing and validation with Zod. |
+| `tests/` | Unit and integration tests. |
+| `scripts/` | Build, clean, devcheck, tree, and lint scripts. |
+| `docs/` | Design docs and OpenAPI spec. |
+
+## Development Guide
+
+See [`CLAUDE.md`](./CLAUDE.md) for development guidelines and architectural rules. The short version:
+
+- Handlers throw, framework catches — no `try/catch` in tool logic
+- Use `ctx.log` for domain-specific logging, `ctx.state` for storage
+- Register new tools and resources in the `index.ts` barrel files
+
+## Contributing
+
+Issues and pull requests are welcome. Run checks before submitting:
+
+```sh
+bun run devcheck
+bun run test
+```
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE) for details.

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

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Server-specific configuration for OpenFEC API access.
+ * Lazy-parsed from environment variables — safe for Workers runtime.
+ * @module src/config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+declare const ServerConfigSchema: z.ZodObject<{
+    fecApiKey: z.ZodString;
+    fecBaseUrl: z.ZodDefault<z.ZodString>;
+    fecMaxRetries: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    fecRequestTimeout: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type ServerConfig = z.infer<typeof ServerConfigSchema>;
+/** Returns validated server config, lazily parsed from env vars. */
+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;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,QAAA,MAAM,kBAAkB;;;;;iBAYtB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAI9D,oEAAoE;AACpE,wBAAgB,eAAe,IAAI,YAAY,CAQ9C"}

package/dist/config/server-config.js

@@ -0,0 +1,31 @@
+/**
+ * @fileoverview Server-specific configuration for OpenFEC API access.
+ * Lazy-parsed from environment variables — safe for Workers runtime.
+ * @module src/config/server-config
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+const ServerConfigSchema = z.object({
+    fecApiKey: z
+        .string()
+        .min(1, 'FEC_API_KEY is required. Get a free key at https://api.data.gov/signup/'),
+    fecBaseUrl: z.string().default('https://api.open.fec.gov/v1').describe('OpenFEC API base URL'),
+    fecMaxRetries: z.coerce.number().int().min(0).default(3).describe('Max retry attempts'),
+    fecRequestTimeout: z.coerce
+        .number()
+        .int()
+        .min(1000)
+        .default(30_000)
+        .describe('Request timeout in ms'),
+});
+let _config;
+/** Returns validated server config, lazily parsed from env vars. */
+export function getServerConfig() {
+    _config ??= ServerConfigSchema.parse({
+        fecApiKey: process.env.FEC_API_KEY,
+        fecBaseUrl: process.env.FEC_BASE_URL,
+        fecMaxRetries: process.env.FEC_MAX_RETRIES,
+        fecRequestTimeout: process.env.FEC_REQUEST_TIMEOUT,
+    });
+    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;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAE3C,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,yEAAyE,CAAC;IACpF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;IAC9F,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,oBAAoB,CAAC;IACvF,iBAAiB,EAAE,CAAC,CAAC,MAAM;SACxB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,IAAI,CAAC;SACT,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,uBAAuB,CAAC;CACrC,CAAC,CAAC;AAIH,IAAI,OAAiC,CAAC;AAEtC,oEAAoE;AACpE,MAAM,UAAU,eAAe;IAC7B,OAAO,KAAK,kBAAkB,CAAC,KAAK,CAAC;QACnC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW;QAClC,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;QACpC,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;QAC1C,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB;KACnD,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview openfec-mcp-server entry point.
+ * Registers all tools, resources, and prompts, then starts the server.
+ * @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;;;;GAIG"}

package/dist/index.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * @fileoverview openfec-mcp-server entry point.
+ * Registers all tools, resources, and prompts, then starts the server.
+ * @module index
+ */
+import { createApp } from '@cyanheads/mcp-ts-core';
+import { allPromptDefinitions } from './mcp-server/prompts/definitions/index.js';
+import { allResourceDefinitions } from './mcp-server/resources/definitions/index.js';
+import { allToolDefinitions } from './mcp-server/tools/definitions/index.js';
+import { initOpenFecService } from './services/openfec/openfec-service.js';
+await createApp({
+    tools: allToolDefinitions,
+    resources: allResourceDefinitions,
+    prompts: allPromptDefinitions,
+    setup() {
+        initOpenFecService();
+    },
+});
+//# 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;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,oBAAoB;IAC7B,KAAK;QACH,kBAAkB,EAAE,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Prompt template for structured analysis of a candidate's financial position.
+ * Covers fundraising trajectory, burn rate, cash reserves, donor composition,
+ * and opponent comparison.
+ * @module src/mcp-server/prompts/definitions/campaign-analysis.prompt
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const campaignAnalysisPrompt: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    candidate_name: z.ZodOptional<z.ZodString>;
+    candidate_id: z.ZodOptional<z.ZodString>;
+    cycle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=campaign-analysis.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.d.ts.map

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

package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.js

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview Prompt template for structured analysis of a candidate's financial position.
+ * Covers fundraising trajectory, burn rate, cash reserves, donor composition,
+ * and opponent comparison.
+ * @module src/mcp-server/prompts/definitions/campaign-analysis.prompt
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const campaignAnalysisPrompt = prompt('openfec_campaign_analysis', {
+    description: "Structured analysis of a candidate's financial position — fundraising trajectory, " +
+        'burn rate, cash reserves, donor composition, and opponent comparison.',
+    args: z.object({
+        candidate_name: z
+            .string()
+            .optional()
+            .describe('Candidate name to analyze. Provide this or candidate_id.'),
+        candidate_id: z
+            .string()
+            .optional()
+            .describe('FEC candidate ID (e.g., P00003392). Provide this or candidate_name.'),
+        cycle: z
+            .string()
+            .optional()
+            .describe('Election cycle year (e.g., 2024). Defaults to current cycle.'),
+    }),
+    generate: (args) => {
+        const target = args.candidate_id
+            ? `candidate ID ${args.candidate_id}`
+            : args.candidate_name
+                ? `"${args.candidate_name}"`
+                : 'the specified candidate';
+        const cycleNote = args.cycle ? ` for the ${args.cycle} cycle` : '';
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Perform a structured campaign finance analysis of ${target}${cycleNote}. Use OpenFEC tools to build a complete financial picture.
+
+## 1. Candidate Overview
+Use openfec_search_candidates with include_totals=true to get:
+- Total receipts, disbursements, cash on hand, debt
+- Coverage period dates
+
+## 2. Fundraising Analysis
+Use openfec_search_contributions with the candidate's principal committee:
+- **Size breakdown** (mode: by_size): What share comes from small vs. large donors?
+- **Geographic reach** (mode: by_state): Where is financial support concentrated?
+- **Industry patterns** (mode: by_employer): Which employers/industries are top sources?
+
+## 3. Burn Rate & Spending
+Use openfec_search_disbursements with the principal committee:
+- **Purpose breakdown** (mode: by_purpose): Media buys, consulting, payroll, fundraising, travel
+- **Top recipients** (mode: by_recipient): Where is the money going?
+- Calculate burn rate: disbursements / receipts
+
+## 4. Competitive Position
+Use openfec_lookup_elections to find all candidates in the race:
+- Compare total raised, cash on hand, and burn rates
+- Identify financial advantages and gaps
+
+## 5. Outside Money Context
+Use openfec_search_expenditures with candidate_id:
+- Total independent expenditure support vs. opposition
+- Key outside groups involved
+
+## 6. Assessment
+Synthesize into a financial health assessment:
+- **Fundraising trajectory**: Growing, flat, or declining?
+- **Donor base health**: Broad grassroots vs. maxed-out large donors?
+- **Cash position**: Sufficient for the remaining campaign period?
+- **Spending efficiency**: Appropriate allocation across categories?
+- **Competitive standing**: Financial position relative to opponents?
+- **Key risks**: Debt levels, donor concentration, spending sustainability`,
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=campaign-analysis.prompt.js.map

package/dist/mcp-server/prompts/definitions/campaign-analysis.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"campaign-analysis.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/campaign-analysis.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC,2BAA2B,EAAE;IACxE,WAAW,EACT,oFAAoF;QACpF,uEAAuE;IACzE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,0DAA0D,CAAC;QACvE,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY;YAC9B,CAAC,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE;YACrC,CAAC,CAAC,IAAI,CAAC,cAAc;gBACnB,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,GAAG;gBAC5B,CAAC,CAAC,yBAAyB,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnE,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,qDAAqD,MAAM,GAAG,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2EAoCZ;iBAClE;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview Barrel export for all prompt definitions.
+ * @module src/mcp-server/prompts/definitions/index
+ */
+export { campaignAnalysisPrompt } from './campaign-analysis.prompt.js';
+export { moneyTrailPrompt } from './money-trail.prompt.js';
+export declare const allPromptDefinitions: import("@cyanheads/mcp-ts-core").PromptDefinition<import("zod").ZodObject<{
+    candidate_name: import("zod").ZodOptional<import("zod").ZodString>;
+    candidate_id: import("zod").ZodOptional<import("zod").ZodString>;
+    cycle: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-server/prompts/definitions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAK3D,eAAO,MAAM,oBAAoB;;;;mCAA6C,CAAC"}

package/dist/mcp-server/prompts/definitions/index.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Barrel export for all prompt definitions.
+ * @module src/mcp-server/prompts/definitions/index
+ */
+export { campaignAnalysisPrompt } from './campaign-analysis.prompt.js';
+export { moneyTrailPrompt } from './money-trail.prompt.js';
+import { campaignAnalysisPrompt } from './campaign-analysis.prompt.js';
+import { moneyTrailPrompt } from './money-trail.prompt.js';
+export const allPromptDefinitions = [moneyTrailPrompt, campaignAnalysisPrompt];
+//# sourceMappingURL=index.js.map

package/dist/mcp-server/prompts/definitions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,CAAC"}

package/dist/mcp-server/prompts/definitions/money-trail.prompt.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @fileoverview Prompt template for tracing the flow of money around a candidate or race.
+ * Guides the agent through a multi-tool investigation of direct fundraising,
+ * PAC support, independent expenditures, and party spending.
+ * @module src/mcp-server/prompts/definitions/money-trail.prompt
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const moneyTrailPrompt: import("@cyanheads/mcp-ts-core").PromptDefinition<z.ZodObject<{
+    candidate_name: z.ZodOptional<z.ZodString>;
+    candidate_id: z.ZodOptional<z.ZodString>;
+    cycle: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>>;
+//# sourceMappingURL=money-trail.prompt.d.ts.map

package/dist/mcp-server/prompts/definitions/money-trail.prompt.d.ts.map

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

package/dist/mcp-server/prompts/definitions/money-trail.prompt.js

@@ -0,0 +1,78 @@
+/**
+ * @fileoverview Prompt template for tracing the flow of money around a candidate or race.
+ * Guides the agent through a multi-tool investigation of direct fundraising,
+ * PAC support, independent expenditures, and party spending.
+ * @module src/mcp-server/prompts/definitions/money-trail.prompt
+ */
+import { prompt, z } from '@cyanheads/mcp-ts-core';
+export const moneyTrailPrompt = prompt('openfec_money_trail', {
+    description: 'Framework for tracing the flow of money around a candidate or race — ' +
+        'direct fundraising, PAC support, independent expenditures, and party spending. ' +
+        'Guides the agent through a multi-tool investigation.',
+    args: z.object({
+        candidate_name: z
+            .string()
+            .optional()
+            .describe('Candidate name to investigate. Provide this or candidate_id.'),
+        candidate_id: z
+            .string()
+            .optional()
+            .describe('FEC candidate ID (e.g., P00003392). Provide this or candidate_name.'),
+        cycle: z
+            .string()
+            .optional()
+            .describe('Election cycle year (e.g., 2024). Defaults to current cycle.'),
+    }),
+    generate: (args) => {
+        const target = args.candidate_id
+            ? `candidate ID ${args.candidate_id}`
+            : args.candidate_name
+                ? `"${args.candidate_name}"`
+                : 'the specified candidate';
+        const cycleNote = args.cycle ? ` for the ${args.cycle} cycle` : '';
+        return [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: `Trace the full money trail for ${target}${cycleNote}. Use the OpenFEC tools to investigate each layer:
+
+## Step 1: Identify the candidate
+${args.candidate_id ? `Look up candidate ${args.candidate_id} using openfec_search_candidates with include_totals=true.` : `Search for "${args.candidate_name}" using openfec_search_candidates. Once found, note the candidate_id and look up their financial totals.`}
+
+## Step 2: Map their committees
+Use openfec_search_committees with the candidate_id to find:
+- Principal campaign committee
+- Leadership PACs
+- Joint fundraising committees
+
+## Step 3: Follow direct fundraising
+For the principal campaign committee, use openfec_search_contributions to examine:
+- Overall totals (include_totals from step 1)
+- Contribution breakdown by size (mode: by_size)
+- Top donor states (mode: by_state)
+- Top employer/occupation patterns (mode: by_employer, by_occupation)
+
+## Step 4: Track outside money
+Use openfec_search_expenditures with the candidate_id to find:
+- Independent expenditures supporting this candidate (support_oppose: S)
+- Independent expenditures opposing this candidate (support_oppose: O)
+- Which Super PACs and groups are involved (mode: by_candidate for summary)
+
+## Step 5: Examine spending
+For the principal campaign committee, use openfec_search_disbursements to see:
+- Spending by purpose category (mode: by_purpose)
+- Top recipients (mode: by_recipient)
+
+## Step 6: Synthesize
+Summarize the complete money picture:
+- Total raised vs. spent vs. cash on hand
+- Donor composition (small vs. large donors, top industries)
+- Outside money landscape (supporting vs. opposing)
+- Key financial strengths and vulnerabilities`,
+                },
+            },
+        ];
+    },
+});
+//# sourceMappingURL=money-trail.prompt.js.map

package/dist/mcp-server/prompts/definitions/money-trail.prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"money-trail.prompt.js","sourceRoot":"","sources":["../../../../src/mcp-server/prompts/definitions/money-trail.prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,qBAAqB,EAAE;IAC5D,WAAW,EACT,uEAAuE;QACvE,iFAAiF;QACjF,sDAAsD;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;QAC3E,YAAY,EAAE,CAAC;aACZ,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,qEAAqE,CAAC;QAClF,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CAAC,8DAA8D,CAAC;KAC5E,CAAC;IACF,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY;YAC9B,CAAC,CAAC,gBAAgB,IAAI,CAAC,YAAY,EAAE;YACrC,CAAC,CAAC,IAAI,CAAC,cAAc;gBACnB,CAAC,CAAC,IAAI,IAAI,CAAC,cAAc,GAAG;gBAC5B,CAAC,CAAC,yBAAyB,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAEnE,OAAO;YACL;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,kCAAkC,MAAM,GAAG,SAAS;;;EAGlE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAqB,IAAI,CAAC,YAAY,4DAA4D,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,cAAc,0GAA0G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8CA+BzN;iBACrC;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

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

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Resource for fetching a candidate profile by FEC candidate ID.
+ * URI: openfec://candidate/{candidate_id}
+ * @module src/mcp-server/resources/definitions/candidate.resource
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const candidateResource: import("@cyanheads/mcp-ts-core").ResourceDefinition<z.ZodObject<{
+    candidate_id: z.ZodString;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=candidate.resource.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.resource.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/resources/definitions/candidate.resource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGrD,eAAO,MAAM,iBAAiB;;6BAsB5B,CAAC"}