sc-elections-mcp 0.5.0

package/dist/tools/campaign.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+import { getCampaignSummary, getCampaignReportDetails, cachedGetCampaignSummary, resolveCampaignContext, resolveCandidateName, getContributions, getExpenditures, getCampaignReports, buildContributionSummary, buildExpenditureSummary, } from '../api/ethics-client.js';
+function formatHeader(context, count, totalLabel, totalAmount) {
+    return `Campaign: ${context.candidateName} — ${context.officeName} (campaignId: ${context.campaignId}, candidateFilerId: ${context.candidateFilerId}, status: ${context.campaignStatus})\n${count} ${totalLabel} totaling $${totalAmount.toFixed(2)}\n---`;
+}
+export function registerCampaignTools(server) {
+    server.tool('get_campaign_summary', 'Get campaign report summary for a candidate showing open/closed offices, balances, and contribution totals. Use candidateFilerId from search_filers. Note: an open campaign does not necessarily mean the person currently holds that office.', {
+        candidate_filer_id: z.number().describe('candidateFilerId from search_filers results'),
+    }, async ({ candidate_filer_id }) => {
+        try {
+            const summary = await getCampaignSummary(candidate_filer_id);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(summary, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('get_campaign_reports', 'List filed campaign disclosure reports. campaign_id is optional — auto-resolved for single-campaign candidates, or use office hint to disambiguate (e.g. office="County Council").', {
+        candidate_filer_id: z.number().describe('candidateFilerId from search_filers results'),
+        campaign_id: z.number().optional().describe('campaignId — optional, auto-resolved if candidate has one campaign'),
+        office: z.string().optional().describe('Office hint to disambiguate when multiple campaigns exist (e.g. "County Council", "Governor")'),
+    }, async ({ candidate_filer_id, campaign_id, office }) => {
+        try {
+            const summary = await cachedGetCampaignSummary(candidate_filer_id);
+            const resolved = resolveCampaignContext(summary, candidate_filer_id, campaign_id, office);
+            if ('error' in resolved) {
+                return { content: [{ type: 'text', text: resolved.error }], isError: true };
+            }
+            const reports = await getCampaignReports(resolved.resolvedCampaignId, candidate_filer_id);
+            const header = `Campaign: ${resolved.context.candidateName} — ${resolved.context.officeName} (campaignId: ${resolved.context.campaignId}, status: ${resolved.context.campaignStatus})`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: reports.length === 0
+                            ? `${header}\nNo campaign reports found`
+                            : `${header}\n${reports.length} report(s)\n---\n${JSON.stringify(reports, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('get_campaign_report_details', 'Get detailed breakdown of a single campaign report including income categories, expenditure totals, balance, and filing metadata. Use report_id from get_campaign_reports results.', {
+        report_id: z.number().describe('Report ID from get_campaign_reports'),
+    }, async ({ report_id }) => {
+        try {
+            const details = await getCampaignReportDetails(report_id);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(details, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('get_contributions', 'Get contributions for a candidate\'s campaign. Returns donor names, amounts, dates, types. Every response includes a metadata header identifying the candidate/office for verification.\n\ncampaign_id is optional: omit it for single-campaign candidates (auto-resolved). Provide it when a candidate has multiple campaigns, or use the office hint to disambiguate (e.g. office="County Council").\n\nUse summary=true for high-volume candidates — returns top 20 donors, totals by type, date range. Use year/min_amount to filter. Default limit is 200 records; pass limit=0 for all.', {
+        candidate_filer_id: z.number().describe('candidateFilerId from search_filers results'),
+        campaign_id: z.number().optional().describe('campaignId — optional, auto-resolved if candidate has one campaign'),
+        office: z.string().optional().describe('Office hint to disambiguate when multiple campaigns exist (e.g. "County Council", "Governor")'),
+        summary: z.boolean().optional().describe('If true, return aggregated top-20 view instead of full records'),
+        year: z.number().optional().describe('Filter to contributions in this year only'),
+        min_amount: z.number().optional().describe('Filter to contributions >= this amount'),
+        limit: z.number().optional().describe('Max records to return (default 200, 0 for all)'),
+    }, async ({ candidate_filer_id, campaign_id, office, summary: wantSummary, year, min_amount, limit }) => {
+        try {
+            const campaignSummary = await cachedGetCampaignSummary(candidate_filer_id);
+            // Resolve candidate name when summary.name is null
+            let candidateNameOverride;
+            if (!campaignSummary.name) {
+                candidateNameOverride = await resolveCandidateName(candidate_filer_id);
+            }
+            const resolved = resolveCampaignContext(campaignSummary, candidate_filer_id, campaign_id, office, candidateNameOverride);
+            if ('error' in resolved) {
+                return { content: [{ type: 'text', text: resolved.error }], isError: true };
+            }
+            let contributions = await getContributions(resolved.resolvedCampaignId, candidate_filer_id);
+            // Client-side filters
+            if (year) {
+                contributions = contributions.filter(c => {
+                    if (!c.date)
+                        return false;
+                    return new Date(c.date).getFullYear() === year;
+                });
+            }
+            if (min_amount) {
+                contributions = contributions.filter(c => c.credit >= min_amount);
+            }
+            if (wantSummary) {
+                const result = buildContributionSummary(contributions, resolved.context);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // Full records with limit
+            const totalCount = contributions.length;
+            const totalAmount = contributions.reduce((sum, c) => sum + c.credit, 0);
+            const effectiveLimit = limit === undefined ? 200 : limit;
+            const limited = effectiveLimit > 0 ? contributions.slice(0, effectiveLimit) : contributions;
+            const header = formatHeader(resolved.context, totalCount, 'contributions', totalAmount);
+            const limitNote = effectiveLimit > 0 && totalCount > effectiveLimit
+                ? `\nShowing ${effectiveLimit} of ${totalCount}. Use limit=0 for all, or summary=true for aggregated view.`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: totalCount === 0
+                            ? `${header}\nNo contributions found`
+                            : `${header}${limitNote}\n${JSON.stringify(limited, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('get_expenditures', 'Get expenditures for a candidate\'s campaign. Returns vendor names, amounts, dates, types. Every response includes a metadata header identifying the candidate/office for verification.\n\ncampaign_id is optional: omit it for single-campaign candidates (auto-resolved). Provide it when a candidate has multiple campaigns, or use the office hint to disambiguate (e.g. office="County Council").\n\nUse summary=true for high-volume candidates — returns top 20 vendors, totals by type, date range. Use year/min_amount to filter. Default limit is 200 records; pass limit=0 for all.', {
+        candidate_filer_id: z.number().describe('candidateFilerId from search_filers results'),
+        campaign_id: z.number().optional().describe('campaignId — optional, auto-resolved if candidate has one campaign'),
+        office: z.string().optional().describe('Office hint to disambiguate when multiple campaigns exist (e.g. "County Council", "Governor")'),
+        summary: z.boolean().optional().describe('If true, return aggregated top-20 view instead of full records'),
+        year: z.number().optional().describe('Filter to expenditures in this year only'),
+        min_amount: z.number().optional().describe('Filter to expenditures >= this amount'),
+        limit: z.number().optional().describe('Max records to return (default 200, 0 for all)'),
+    }, async ({ candidate_filer_id, campaign_id, office, summary: wantSummary, year, min_amount, limit }) => {
+        try {
+            const campaignSummary = await cachedGetCampaignSummary(candidate_filer_id);
+            // Resolve candidate name when summary.name is null
+            let candidateNameOverride;
+            if (!campaignSummary.name) {
+                candidateNameOverride = await resolveCandidateName(candidate_filer_id);
+            }
+            const resolved = resolveCampaignContext(campaignSummary, candidate_filer_id, campaign_id, office, candidateNameOverride);
+            if ('error' in resolved) {
+                return { content: [{ type: 'text', text: resolved.error }], isError: true };
+            }
+            let expenditures = await getExpenditures(resolved.resolvedCampaignId, candidate_filer_id);
+            // Client-side filters
+            if (year) {
+                expenditures = expenditures.filter(e => {
+                    if (!e.date)
+                        return false;
+                    return new Date(e.date).getFullYear() === year;
+                });
+            }
+            if (min_amount) {
+                expenditures = expenditures.filter(e => e.debit >= min_amount);
+            }
+            if (wantSummary) {
+                const result = buildExpenditureSummary(expenditures, resolved.context);
+                return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+            }
+            // Full records with limit
+            const totalCount = expenditures.length;
+            const totalAmount = expenditures.reduce((sum, e) => sum + e.debit, 0);
+            const effectiveLimit = limit === undefined ? 200 : limit;
+            const limited = effectiveLimit > 0 ? expenditures.slice(0, effectiveLimit) : expenditures;
+            const header = formatHeader(resolved.context, totalCount, 'expenditures', totalAmount);
+            const limitNote = effectiveLimit > 0 && totalCount > effectiveLimit
+                ? `\nShowing ${effectiveLimit} of ${totalCount}. Use limit=0 for all, or summary=true for aggregated view.`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: totalCount === 0
+                            ? `${header}\nNo expenditures found`
+                            : `${header}${limitNote}\n${JSON.stringify(limited, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=campaign.js.map

package/dist/tools/campaign.js.map

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

package/dist/tools/cross-search.d.ts

@@ -0,0 +1,26 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CrossSearchContribution, CrossSearchExpenditure } from '../types.js';
+/** @internal — exported for testing */
+export declare function summarizeCrossSearchContributions(results: CrossSearchContribution[]): {
+    totalRecords: number;
+    grandTotal: number;
+    byCandidateTop20: {
+        candidateName: string;
+        officeName: string;
+        totalAmount: number;
+        count: number;
+    }[];
+};
+/** @internal — exported for testing */
+export declare function summarizeCrossSearchExpenditures(results: CrossSearchExpenditure[]): {
+    totalRecords: number;
+    grandTotal: number;
+    byVendorTop20: {
+        vendorName: string;
+        totalAmount: number;
+        count: number;
+        candidateCount: number;
+        candidates: string[];
+    }[];
+};
+export declare function registerCrossSearchTools(server: McpServer): void;

package/dist/tools/cross-search.js

@@ -0,0 +1,219 @@
+import { z } from 'zod';
+import { searchExpenditures, searchContributions, normalizeOfficeName } from '../api/ethics-client.js';
+const CHAR_BUDGET = 60_000;
+/** @internal — exported for testing */
+export function summarizeCrossSearchContributions(results) {
+    const byCandidate = new Map();
+    let grandTotal = 0;
+    for (const r of results) {
+        grandTotal += r.amount;
+        const key = `${r.candidateId}-${r.officeRunId}`;
+        const existing = byCandidate.get(key);
+        if (existing) {
+            existing.totalAmount += r.amount;
+            existing.count++;
+        }
+        else {
+            byCandidate.set(key, {
+                candidateName: r.candidateName,
+                officeName: r.officeName,
+                totalAmount: r.amount,
+                count: 1,
+            });
+        }
+    }
+    return {
+        totalRecords: results.length,
+        grandTotal,
+        byCandidateTop20: [...byCandidate.values()]
+            .sort((a, b) => b.totalAmount - a.totalAmount)
+            .slice(0, 20),
+    };
+}
+/** @internal — exported for testing */
+export function summarizeCrossSearchExpenditures(results) {
+    const byVendor = new Map();
+    let grandTotal = 0;
+    for (const r of results) {
+        grandTotal += r.amount;
+        const key = r.vendorName.trim().toLowerCase();
+        const existing = byVendor.get(key);
+        if (existing) {
+            existing.totalAmount += r.amount;
+            existing.count++;
+            existing.candidates.add(r.candidateName);
+        }
+        else {
+            byVendor.set(key, {
+                vendorName: r.vendorName,
+                totalAmount: r.amount,
+                count: 1,
+                candidates: new Set([r.candidateName]),
+            });
+        }
+    }
+    return {
+        totalRecords: results.length,
+        grandTotal,
+        byVendorTop20: [...byVendor.values()]
+            .sort((a, b) => b.totalAmount - a.totalAmount)
+            .slice(0, 20)
+            .map(v => ({ vendorName: v.vendorName, totalAmount: v.totalAmount, count: v.count, candidateCount: v.candidates.size, candidates: [...v.candidates].slice(0, 5) })),
+    };
+}
+function applyCharBudget(output) {
+    const rawText = JSON.stringify(output, null, 2);
+    if (rawText.length <= CHAR_BUDGET) {
+        return { finalText: rawText, budgetWarning: '' };
+    }
+    // Linear scan: find how many records fit in the budget
+    let kept = 0;
+    let runningLength = 2; // opening "[\n"
+    for (let i = 0; i < output.length; i++) {
+        const itemStr = JSON.stringify(output[i], null, 2);
+        const addedLength = itemStr.length + (i > 0 ? 2 : 0); // comma + newline
+        if (runningLength + addedLength + 2 > CHAR_BUDGET)
+            break; // +2 for closing "\n]"
+        runningLength += addedLength;
+        kept++;
+    }
+    if (kept === 0)
+        kept = 1; // Always include at least one record
+    const budgetWarning = `\nWARNING: Response truncated to ${kept} of ${output.length} records (60K char budget). Use slim=true to strip address fields, summary=true for aggregated view, or add more filters.`;
+    return { finalText: JSON.stringify(output.slice(0, kept), null, 2), budgetWarning };
+}
+export function registerCrossSearchTools(server) {
+    server.tool('search_expenditures', 'Search expenditures across ALL candidates statewide. At least one filter required. Default limit 200 (0 for all). Use slim=true to strip address fields, summary=true for aggregated view. Responses auto-truncate at 60K chars. IMPORTANT: Office names in results are inconsistent — use broad office filters or omit office and filter by candidate name instead.', {
+        candidate: z.string().optional().describe('Candidate name filter (partial match)'),
+        office: z.string().optional().describe('Office name filter (partial match)'),
+        vendor_name: z.string().optional().describe('Vendor/payee name filter (partial match)'),
+        year: z.number().optional().describe('Election year filter (e.g. 2024). Omit for all years.'),
+        amount: z.number().optional().describe('Minimum amount filter'),
+        description: z.string().optional().describe('Expenditure description filter'),
+        limit: z.number().optional().describe('Max results to return (default 200, 0 for all).'),
+        slim: z.boolean().optional().describe('If true, strip address fields to reduce response size.'),
+        summary: z.boolean().optional().describe('If true, group by vendor and return totals instead of individual records.'),
+    }, async ({ candidate, office, vendor_name, year, amount, description, limit, slim, summary }) => {
+        try {
+            // Guard: all-empty queries return the entire expenditure database
+            const hasAnyFilter = candidate || office || vendor_name || year || amount || description;
+            if (!hasAnyFilter) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'At least one filter is required for search_expenditures. Provide candidate, office, vendor_name, year, amount, or description.',
+                        }],
+                    isError: true,
+                };
+            }
+            const results = await searchExpenditures({
+                candidate,
+                office,
+                vendorName: vendor_name,
+                expenditureYear: year,
+                amount,
+                expDesc: description,
+            });
+            const enriched = results.map(r => ({
+                ...r,
+                normalizedOffice: normalizeOfficeName(r.office),
+            }));
+            if (summary) {
+                const summaryData = summarizeCrossSearchExpenditures(results);
+                return { content: [{ type: 'text', text: JSON.stringify(summaryData, null, 2) }] };
+            }
+            const effectiveLimit = limit === undefined ? 200 : limit;
+            const totalCount = enriched.length;
+            const limited = effectiveLimit > 0 ? enriched.slice(0, effectiveLimit) : enriched;
+            // Apply slim mode
+            const output = slim
+                ? limited.map(({ address, ...rest }) => rest)
+                : limited;
+            const limitNote = effectiveLimit > 0 && totalCount > effectiveLimit
+                ? `\nShowing ${effectiveLimit} of ${totalCount}. Use limit=0 for all.`
+                : '';
+            // Apply char budget
+            const { finalText, budgetWarning } = applyCharBudget(output);
+            return {
+                content: [{
+                        type: 'text',
+                        text: enriched.length === 0
+                            ? 'No expenditures found matching filters'
+                            : `${totalCount} expenditure(s) found:${limitNote}${budgetWarning}\n${finalText}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    server.tool('search_contributions', 'Search contributions across ALL candidates statewide. At least one filter besides office required (office filter is broken server-side). Default limit 200 (0 for all). Use slim=true to strip address/occupation fields, summary=true for aggregated view. Responses auto-truncate at 60K chars.', {
+        candidate: z.string().optional().describe('Candidate name filter (partial match)'),
+        office: z.string().optional().describe('Office name filter (partial match)'),
+        contributor_name: z.string().optional().describe('Contributor/donor name filter (partial match)'),
+        year: z.number().optional().describe('Election year filter (e.g. 2024). Omit for all years.'),
+        amount: z.number().optional().describe('Minimum amount filter'),
+        limit: z.number().optional().describe('Max results to return (default 200, 0 for all).'),
+        slim: z.boolean().optional().describe('If true, strip address/occupation/group fields to reduce response size.'),
+        summary: z.boolean().optional().describe('If true, group by candidate and return totals instead of individual records.'),
+    }, async ({ candidate, office, contributor_name, year, amount, limit, slim, summary }) => {
+        try {
+            // Guard: office-only queries return ~79K unfiltered results (server ignores the filter)
+            const hasOtherFilter = candidate || contributor_name || year || amount;
+            if (office && !hasOtherFilter) {
+                return {
+                    content: [{
+                            type: 'text',
+                            text: 'The office filter on search_contributions is broken server-side — the API ignores it and returns ~79K unfiltered results. Use list_filers_by_office to find candidates for that office, then get_contributions for each candidate individually.',
+                        }],
+                    isError: true,
+                };
+            }
+            const results = await searchContributions({
+                candidate,
+                office,
+                contributorName: contributor_name,
+                contributionYear: year,
+                amount,
+            });
+            const enriched = results.map(r => ({
+                ...r,
+                normalizedOffice: normalizeOfficeName(r.officeName),
+            }));
+            if (summary) {
+                const summaryData = summarizeCrossSearchContributions(results);
+                return { content: [{ type: 'text', text: JSON.stringify(summaryData, null, 2) }] };
+            }
+            const effectiveLimit = limit === undefined ? 200 : limit;
+            const totalCount = enriched.length;
+            const limited = effectiveLimit > 0 ? enriched.slice(0, effectiveLimit) : enriched;
+            // Apply slim mode
+            const output = slim
+                ? limited.map(({ contributorAddress, contributorOccupation, group, ...rest }) => rest)
+                : limited;
+            const limitNote = effectiveLimit > 0 && totalCount > effectiveLimit
+                ? `\nShowing ${effectiveLimit} of ${totalCount}. Use limit=0 for all.`
+                : '';
+            // Apply char budget
+            const { finalText, budgetWarning } = applyCharBudget(output);
+            return {
+                content: [{
+                        type: 'text',
+                        text: enriched.length === 0
+                            ? 'No contributions found matching filters'
+                            : `${totalCount} contribution(s) found:${limitNote}${budgetWarning}\n${finalText}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=cross-search.js.map

package/dist/tools/cross-search.js.map

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

package/dist/tools/overlap.d.ts

@@ -0,0 +1,25 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { CampaignContribution } from '../types.js';
+/** @internal — exported for testing */
+export interface CandidateContributions {
+    candidateFilerId: number;
+    candidateName: string;
+    officeName: string;
+    contributions: CampaignContribution[];
+    error?: string;
+}
+interface DonorOverlapEntry {
+    donorName: string;
+    totalGiven: number;
+    candidateBreakdown: {
+        candidateName: string;
+        officeName: string;
+        amount: number;
+        count: number;
+    }[];
+}
+export declare function normalizeDonorName(name: string): string;
+/** @internal — exported for testing */
+export declare function computeOverlap(primary: CandidateContributions, comparisons: CandidateContributions[], exactMatch?: boolean): DonorOverlapEntry[];
+export declare function registerOverlapTools(server: McpServer): void;
+export {};