@cyanheads/openfec-mcp-server 0.2.2

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

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Tool for searching and retrieving FEC committee records.
+ * Supports full-text search, single-committee lookup by ID, and filtering
+ * by candidate affiliation, type, designation, state, and party.
+ * @module mcp-server/tools/definitions/search-committees.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { notFound } from '@cyanheads/mcp-ts-core/errors';
+import { getOpenFecService } from '../../../services/openfec/openfec-service.js';
+import { PaginationSchema, str } from './utils/format-helpers.js';
+import { validateCandidateId, validateCommitteeId } from './utils/id-validators.js';
+export const searchCommittees = tool('openfec_search_committees', {
+    description: 'Find political committees (campaign, PAC, Super PAC, party) by name, type, ' +
+        'candidate affiliation, or state. Retrieve a specific committee by FEC ID. ' +
+        'Committee IDs start with C followed by digits (e.g., C00358796).',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        query: z.string().optional().describe('Full-text committee name search.'),
+        committee_id: z
+            .string()
+            .optional()
+            .describe("FEC committee ID (e.g., C00358796). Starts with 'C' followed by digits. Returns a single committee with full detail."),
+        candidate_id: z
+            .string()
+            .optional()
+            .describe('Find committees linked to this candidate (authorized, leadership, joint fundraising).'),
+        state: z.string().optional().describe('Two-letter state code.'),
+        party: z.string().optional().describe('Three-letter party code (e.g., DEM, REP).'),
+        committee_type: z
+            .string()
+            .optional()
+            .describe('Committee type code. Common: H (House), S (Senate), P (Presidential), O (Super PAC), N (PAC nonqualified), Q (PAC qualified), X (Party nonqualified), Y (Party qualified).'),
+        designation: z
+            .string()
+            .optional()
+            .describe('Committee designation. A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized).'),
+        cycle: z.number().optional().describe('Two-year election cycle (even year).'),
+        treasurer_name: z.string().optional().describe('Full-text treasurer name search.'),
+        page: z.number().optional().describe('Page number (1-indexed). Default 1.'),
+        per_page: z.number().optional().describe('Results per page. Default 20, max 100.'),
+    }),
+    output: z.object({
+        committees: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe('Committee records with committee_id, name, type, designation, party, state, etc.'),
+        pagination: PaginationSchema.describe('Page-based pagination metadata.'),
+    }),
+    async handler(input, ctx) {
+        const fec = getOpenFecService();
+        if (input.committee_id)
+            validateCommitteeId(input.committee_id);
+        if (input.candidate_id)
+            validateCandidateId(input.candidate_id);
+        let result;
+        if (input.committee_id) {
+            ctx.log.info('Fetching committee by ID', { committee_id: input.committee_id });
+            result = await fec.getCommittee(input.committee_id, ctx);
+        }
+        else {
+            const params = {
+                q: input.query,
+                candidate_id: input.candidate_id,
+                state: input.state,
+                party: input.party,
+                committee_type: input.committee_type,
+                designation: input.designation,
+                cycle: input.cycle,
+                treasurer_name: input.treasurer_name,
+                page: input.page,
+                per_page: input.per_page,
+            };
+            ctx.log.info('Searching committees', { query: input.query, state: input.state });
+            result = await fec.searchCommittees(params, ctx);
+        }
+        if (input.committee_id && result.results.length === 0) {
+            throw notFound(`Committee ${input.committee_id} not found.`, {
+                committee_id: input.committee_id,
+            });
+        }
+        return {
+            committees: result.results,
+            pagination: result.pagination,
+        };
+    },
+    format(result) {
+        if (result.committees.length === 0) {
+            return [
+                {
+                    type: 'text',
+                    text: 'No committees found. Try a partial name, remove type/designation filters, or search by candidate_id to find linked committees.',
+                },
+            ];
+        }
+        const lines = result.committees.map((c) => {
+            const id = str(c, 'committee_id');
+            const name = str(c, 'name');
+            const type = str(c, 'committee_type_full') || str(c, 'committee_type');
+            const designation = str(c, 'designation_full') || str(c, 'designation');
+            const party = str(c, 'party_full') || str(c, 'party');
+            const state = str(c, 'state');
+            const treasurer = str(c, 'treasurer_name');
+            let line = `**${name}** (${id})\n  Type: ${type} | Designation: ${designation}`;
+            if (party)
+                line += ` | ${party}`;
+            if (state)
+                line += ` | ${state}`;
+            if (treasurer)
+                line += `\n  Treasurer: ${treasurer}`;
+            const candidateIds = c.candidate_ids;
+            if (Array.isArray(candidateIds) && candidateIds.length > 0) {
+                line += `\n  Candidates: ${candidateIds.join(', ')}`;
+            }
+            return line;
+        });
+        const { page, pages, count } = result.pagination;
+        lines.push(`\n---\nPage ${page} of ${pages} (${count} total)`);
+        return [{ type: 'text', text: lines.join('\n\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-contributions.tool.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Search itemized individual contributions (Schedule A) or get
+ * aggregate breakdowns by size, state, employer, or occupation. Central tool
+ * for answering "who's funding this candidate/committee?"
+ * @module mcp-server/tools/definitions/search-contributions.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchContributions: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        by_size: "by_size";
+        by_state: "by_state";
+        by_employer: "by_employer";
+        by_occupation: "by_occupation";
+        itemized: "itemized";
+    }>>;
+    committee_id: z.ZodOptional<z.ZodString>;
+    candidate_id: z.ZodOptional<z.ZodString>;
+    contributor_name: z.ZodOptional<z.ZodString>;
+    contributor_employer: z.ZodOptional<z.ZodString>;
+    contributor_occupation: z.ZodOptional<z.ZodString>;
+    contributor_city: z.ZodOptional<z.ZodString>;
+    contributor_state: z.ZodOptional<z.ZodString>;
+    contributor_zip: z.ZodOptional<z.ZodString>;
+    cycle: z.ZodOptional<z.ZodNumber>;
+    min_date: z.ZodOptional<z.ZodString>;
+    max_date: z.ZodOptional<z.ZodString>;
+    min_amount: z.ZodOptional<z.ZodNumber>;
+    max_amount: z.ZodOptional<z.ZodNumber>;
+    is_individual: z.ZodOptional<z.ZodBoolean>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        contribution_receipt_date: "contribution_receipt_date";
+        contribution_receipt_amount: "contribution_receipt_amount";
+    }>>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNumber>;
+    pagination: z.ZodOptional<z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        count: z.ZodNumber;
+        per_page: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-contributions.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-contributions.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-contributions.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAejD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA6P9B,CAAC"}

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

@@ -0,0 +1,252 @@
+/**
+ * @fileoverview Search itemized individual contributions (Schedule A) or get
+ * aggregate breakdowns by size, state, employer, or occupation. Central tool
+ * for answering "who's funding this candidate/committee?"
+ * @module mcp-server/tools/definitions/search-contributions.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { invalidParams } from '@cyanheads/mcp-ts-core/errors';
+import { decodeCursor, getOpenFecService } from '../../../services/openfec/openfec-service.js';
+import { fmt$ } from './utils/format-helpers.js';
+import { validateCandidateId, validateCommitteeId } from './utils/id-validators.js';
+/** Derive the current two-year election cycle (always even). */
+const currentCycle = () => {
+    const year = new Date().getFullYear();
+    return year % 2 === 0 ? year : year + 1;
+};
+const modes = ['itemized', 'by_size', 'by_state', 'by_employer', 'by_occupation'];
+export const searchContributions = tool('openfec_search_contributions', {
+    description: 'Search itemized individual contributions (Schedule A) or get aggregate breakdowns ' +
+        'by size, state, employer, or occupation. Use to answer "who is funding this committee?" ' +
+        'Itemized mode requires a committee_id. Aggregate by_size/by_state can use candidate_id instead.',
+    annotations: { readOnlyHint: true, idempotentHint: true },
+    input: z.object({
+        mode: z
+            .enum(modes)
+            .default('itemized')
+            .describe('Query mode. "itemized" returns individual contribution records (keyset pagination). ' +
+            '"by_size" aggregates by contribution size bucket. "by_state" aggregates by contributor state. ' +
+            '"by_employer" aggregates by employer. "by_occupation" aggregates by occupation.'),
+        committee_id: z.string().optional().describe('Receiving committee ID (e.g., C00703975).'),
+        candidate_id: z
+            .string()
+            .optional()
+            .describe('Candidate ID. Used with by_size/by_state aggregates to route to the /by_candidate variant.'),
+        contributor_name: z.string().optional().describe('Full-text donor name search. Itemized only.'),
+        contributor_employer: z
+            .string()
+            .optional()
+            .describe('Full-text employer search. Itemized only.'),
+        contributor_occupation: z
+            .string()
+            .optional()
+            .describe('Full-text occupation search. Itemized only.'),
+        contributor_city: z.string().optional().describe('Contributor city. Itemized only.'),
+        contributor_state: z
+            .string()
+            .optional()
+            .describe('Two-letter state code (e.g., CA). Itemized only.'),
+        contributor_zip: z
+            .string()
+            .optional()
+            .describe('ZIP code prefix (starts-with match). Itemized only.'),
+        cycle: z
+            .number()
+            .optional()
+            .describe('Two-year election cycle (e.g., 2024). Even years only. ' +
+            'Defaults to current cycle for itemized mode (API requires two_year_transaction_period).'),
+        min_date: z
+            .string()
+            .optional()
+            .describe('Earliest contribution date (YYYY-MM-DD). Itemized only.'),
+        max_date: z
+            .string()
+            .optional()
+            .describe('Latest contribution date (YYYY-MM-DD). Itemized only.'),
+        min_amount: z
+            .number()
+            .optional()
+            .describe('Minimum contribution amount in dollars. Itemized only.'),
+        max_amount: z
+            .number()
+            .optional()
+            .describe('Maximum contribution amount in dollars. Itemized only.'),
+        is_individual: z
+            .boolean()
+            .optional()
+            .describe('Only individual contributions (excludes committee-to-committee transfers). Itemized only.'),
+        sort: z
+            .enum(['contribution_receipt_date', 'contribution_receipt_amount'])
+            .optional()
+            .describe('Sort field. Itemized only.'),
+        per_page: z.number().default(20).describe('Results per page (max 100).'),
+        cursor: z
+            .string()
+            .optional()
+            .describe('Opaque pagination cursor from a previous response. Itemized mode only (keyset pagination).'),
+    }),
+    output: z.object({
+        results: z
+            .array(z.record(z.string(), z.unknown()))
+            .describe('Contribution records (itemized) or aggregate rows.'),
+        next_cursor: z
+            .string()
+            .nullable()
+            .optional()
+            .describe('Pagination cursor for the next page of itemized results. Null when no more pages.'),
+        count: z.number().optional().describe('Total result count (may be approximate for itemized).'),
+        pagination: z
+            .object({
+            page: z.number().describe('Current page number.'),
+            pages: z.number().describe('Total pages.'),
+            count: z.number().describe('Total results.'),
+            per_page: z.number().describe('Results per page.'),
+        })
+            .optional()
+            .describe('Page-based pagination info (aggregate modes only).'),
+    }),
+    async handler(input, ctx) {
+        const fec = getOpenFecService();
+        const mode = input.mode;
+        if (input.committee_id)
+            validateCommitteeId(input.committee_id);
+        if (input.candidate_id)
+            validateCandidateId(input.candidate_id);
+        /* ---------------------------------------------------------------- */
+        /*  Itemized contributions (keyset/SEEK)                            */
+        /* ---------------------------------------------------------------- */
+        if (mode === 'itemized') {
+            if (!input.committee_id) {
+                throw invalidParams('Itemized contribution search requires a committee_id. To search contributions ' +
+                    'by candidate, use a "by_size" or "by_state" aggregate mode with candidate_id, ' +
+                    "or first look up the candidate's committee with openfec_search_committees.");
+            }
+            const cycle = input.cycle ?? currentCycle();
+            const params = {
+                committee_id: input.committee_id,
+                two_year_transaction_period: cycle,
+                per_page: input.per_page,
+            };
+            if (input.contributor_name)
+                params.contributor_name = input.contributor_name;
+            if (input.contributor_employer)
+                params.contributor_employer = input.contributor_employer;
+            if (input.contributor_occupation)
+                params.contributor_occupation = input.contributor_occupation;
+            if (input.contributor_city)
+                params.contributor_city = input.contributor_city;
+            if (input.contributor_state)
+                params.contributor_state = input.contributor_state;
+            if (input.contributor_zip)
+                params.contributor_zip = input.contributor_zip;
+            if (input.min_date)
+                params.min_date = input.min_date;
+            if (input.max_date)
+                params.max_date = input.max_date;
+            if (input.min_amount !== undefined)
+                params.min_amount = input.min_amount;
+            if (input.max_amount !== undefined)
+                params.max_amount = input.max_amount;
+            if (input.is_individual !== undefined)
+                params.is_individual = input.is_individual;
+            if (input.sort)
+                params.sort = input.sort;
+            if (input.cursor) {
+                const lastIndexes = decodeCursor(input.cursor);
+                Object.assign(params, lastIndexes);
+            }
+            const result = await fec.searchContributions(params, ctx);
+            ctx.log.info('Itemized contributions fetched', {
+                committee_id: input.committee_id,
+                cycle,
+                count: result.pagination.count,
+                returned: result.results.length,
+            });
+            return {
+                results: result.results,
+                next_cursor: result.nextCursor,
+                count: result.pagination.count,
+            };
+        }
+        /* ---------------------------------------------------------------- */
+        /*  Aggregate modes                                                 */
+        /* ---------------------------------------------------------------- */
+        if (mode === 'by_employer' || mode === 'by_occupation') {
+            if (!input.committee_id) {
+                throw invalidParams(`Aggregate by ${mode.replace('by_', '')} requires a committee_id.`);
+            }
+        }
+        const params = { per_page: input.per_page };
+        if (input.committee_id)
+            params.committee_id = input.committee_id;
+        if (input.candidate_id)
+            params.candidate_id = input.candidate_id;
+        if (input.cycle)
+            params.cycle = input.cycle;
+        // For by_size and by_state, route to /by_candidate variant when candidate_id is provided
+        let aggregateMode = mode;
+        if ((mode === 'by_size' || mode === 'by_state') && input.candidate_id) {
+            aggregateMode = `${mode}_candidate`;
+        }
+        const result = await fec.getContributionAggregates(aggregateMode, params, ctx);
+        ctx.log.info('Contribution aggregates fetched', {
+            mode: aggregateMode,
+            count: result.pagination.count,
+            returned: result.results.length,
+        });
+        return {
+            results: result.results,
+            pagination: result.pagination,
+        };
+    },
+    format: (result) => {
+        if (result.results.length === 0) {
+            return [
+                {
+                    type: 'text',
+                    text: 'No contributions found. For itemized mode, try a different cycle or broaden name/employer filters. For aggregates, verify the committee_id or candidate_id is correct.',
+                },
+            ];
+        }
+        // Detect itemized vs aggregate by presence of next_cursor key
+        const isItemized = 'next_cursor' in result && result.next_cursor !== undefined;
+        if (isItemized) {
+            const lines = [
+                `**${result.count?.toLocaleString() ?? '?'} total contributions**\n`,
+            ];
+            for (const r of result.results) {
+                const name = r.contributor_name ?? 'Unknown';
+                const employer = r.contributor_employer ?? '';
+                const amount = fmt$(r.contribution_receipt_amount);
+                const date = r.contribution_receipt_date ?? '';
+                const committee = r.committee_name ?? r.committee_id ?? '';
+                const city = r.contributor_city ?? '';
+                const state = r.contributor_state ?? '';
+                const location = [city, state].filter(Boolean).join(', ');
+                lines.push(`- **${name}** ${location ? `(${location})` : ''}`);
+                lines.push(`  ${amount} on ${date} → ${committee}`);
+                if (employer)
+                    lines.push(`  Employer: ${employer}`);
+            }
+            if (result.next_cursor) {
+                lines.push(`\n_More results available — pass cursor to continue._`);
+            }
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        // Aggregate
+        const lines = [
+            `**${result.pagination?.count?.toLocaleString() ?? '?'} aggregate rows**\n`,
+        ];
+        for (const r of result.results) {
+            const dimension = r.size ?? r.state ?? r.employer ?? r.occupation ?? r.state_full ?? 'Unknown';
+            const total = fmt$(r.total);
+            const count = typeof r.count === 'number' ? ` (${r.count.toLocaleString()} contributions)` : '';
+            lines.push(`- **${dimension}**: ${total}${count}`);
+        }
+        if (result.pagination && result.pagination.page < result.pagination.pages) {
+            lines.push(`\n_Page ${result.pagination.page} of ${result.pagination.pages}_`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-contributions.tool.js.map

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

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

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

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Search itemized committee spending (Schedule B) or get aggregate
+ * breakdowns by purpose or recipient. Answers "what is this committee spending money on?"
+ * @module mcp-server/tools/definitions/search-disbursements.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const searchDisbursements: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        by_purpose: "by_purpose";
+        by_recipient: "by_recipient";
+        by_recipient_id: "by_recipient_id";
+        itemized: "itemized";
+    }>>;
+    committee_id: z.ZodString;
+    recipient_name: z.ZodOptional<z.ZodString>;
+    recipient_state: z.ZodOptional<z.ZodString>;
+    recipient_city: z.ZodOptional<z.ZodString>;
+    recipient_committee_id: z.ZodOptional<z.ZodString>;
+    disbursement_description: z.ZodOptional<z.ZodString>;
+    disbursement_purpose_category: z.ZodOptional<z.ZodString>;
+    cycle: z.ZodOptional<z.ZodNumber>;
+    min_date: z.ZodOptional<z.ZodString>;
+    max_date: z.ZodOptional<z.ZodString>;
+    min_amount: z.ZodOptional<z.ZodNumber>;
+    max_amount: z.ZodOptional<z.ZodNumber>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        disbursement_date: "disbursement_date";
+        disbursement_amount: "disbursement_amount";
+    }>>;
+    per_page: z.ZodDefault<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    next_cursor: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    count: z.ZodOptional<z.ZodNumber>;
+    pagination: z.ZodOptional<z.ZodObject<{
+        page: z.ZodNumber;
+        pages: z.ZodNumber;
+        count: z.ZodNumber;
+        per_page: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>>;
+//# sourceMappingURL=search-disbursements.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search-disbursements.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-disbursements.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAQjD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAuN9B,CAAC"}