tn-elections-mcp 0.5.0

package/dist/tools/sos.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { getFiledCandidates } from '../api/sos-client.js';
+export function registerSosTools(server) {
+    // ============================================================
+    // search_filed_candidates
+    // ============================================================
+    server.tool('search_filed_candidates', 'Search candidates who have officially filed with the Tennessee Secretary of State. This is the OFFICIAL candidate filing list (who is on the ballot), distinct from tncamp campaign finance data (who has a campaign account). Covers state and federal races only: Governor, US Senate, US House, TN Senate, TN House, and party executive committees. County-level races are NOT covered — use search_county_filers for those. Only the current election cycle is available.', {
+        office: z.string().optional().describe('Filter by office name (case-insensitive partial match, e.g., "senate", "house district 5", "governor")'),
+        name: z.string().optional().describe('Filter by candidate name (case-insensitive partial match)'),
+        party: z.string().optional().describe('Filter by party (e.g., "Republican", "Democratic", "Independent")'),
+        city: z.string().optional().describe('Filter by city (case-insensitive partial match)'),
+        year: z.number().optional().describe('Election year (default 2026). Only current cycle available.'),
+        limit: z.number().optional().describe('Max results (default 50, 0 for all)'),
+    }, async ({ office, name, party, city, year, limit }) => {
+        try {
+            const index = await getFiledCandidates(year || 2026);
+            let results = index.candidates;
+            if (office) {
+                const q = office.toLowerCase();
+                results = results.filter(c => c.office.toLowerCase().includes(q) || c.officeCategory.toLowerCase().includes(q));
+            }
+            if (name) {
+                const q = name.toLowerCase();
+                results = results.filter(c => c.candidateName.toLowerCase().includes(q));
+            }
+            if (party) {
+                const q = party.toLowerCase();
+                results = results.filter(c => c.party.toLowerCase().includes(q));
+            }
+            if (city) {
+                const q = city.toLowerCase();
+                results = results.filter(c => c.city.toLowerCase().includes(q));
+            }
+            if (results.length === 0) {
+                return { content: [{ type: 'text', text: 'No filed candidates found matching your search.' }] };
+            }
+            const effectiveLimit = limit === undefined ? 50 : limit;
+            const totalCount = results.length;
+            const limited = effectiveLimit > 0 ? results.slice(0, effectiveLimit) : results;
+            const limitNote = effectiveLimit > 0 && totalCount > effectiveLimit
+                ? `Showing ${limited.length} of ${totalCount} results. Use limit=0 for all.\n\n`
+                : '';
+            return {
+                content: [{
+                        type: 'text',
+                        text: `${limitNote}${totalCount} officially filed candidate(s):\n\n${JSON.stringify(limited, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================
+    // list_filed_offices
+    // ============================================================
+    server.tool('list_filed_offices', 'List office categories in the TN Secretary of State candidate filing list. Returns each office category with candidate count and links to the official PDF/Excel files. Only the current election cycle is available.', {
+        year: z.number().optional().describe('Election year (default 2026)'),
+    }, async ({ year }) => {
+        try {
+            const index = await getFiledCandidates(year || 2026);
+            return {
+                content: [{
+                        type: 'text',
+                        text: `${index.offices.length} office category(s) for ${index.year} (${index.candidates.length} total candidates):\n\n${JSON.stringify(index.offices, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================
+    // get_filing_summary
+    // ============================================================
+    server.tool('get_filing_summary', 'Get an aggregated summary of TN Secretary of State candidate filings by office and party. Returns total counts and breakdowns without listing individual candidates. Only the current election cycle is available.', {
+        year: z.number().optional().describe('Election year (default 2026)'),
+        office: z.string().optional().describe('Narrow to one office category (partial match)'),
+    }, async ({ year, office }) => {
+        try {
+            const index = await getFiledCandidates(year || 2026);
+            let candidates = index.candidates;
+            if (office) {
+                const q = office.toLowerCase();
+                candidates = candidates.filter(c => c.office.toLowerCase().includes(q) || c.officeCategory.toLowerCase().includes(q));
+            }
+            // Build by-office breakdown
+            const byOffice = {};
+            const byParty = {};
+            for (const c of candidates) {
+                const cat = c.officeCategory;
+                if (!byOffice[cat])
+                    byOffice[cat] = {};
+                byOffice[cat][c.party] = (byOffice[cat][c.party] || 0) + 1;
+                byParty[c.party] = (byParty[c.party] || 0) + 1;
+            }
+            // Add totals per office
+            const byOfficeWithTotals = {};
+            for (const [cat, parties] of Object.entries(byOffice)) {
+                const total = Object.values(parties).reduce((sum, n) => sum + n, 0);
+                byOfficeWithTotals[cat] = { total, ...parties };
+            }
+            const summary = {
+                year: index.year,
+                totalCandidates: candidates.length,
+                byOffice: byOfficeWithTotals,
+                byParty,
+            };
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Filing summary for ${index.year}:\n\n${JSON.stringify(summary, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sos.js.map

package/dist/tools/sos.js.map

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

package/dist/tools/sumner.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSumnerTools(server: McpServer): void;

package/dist/tools/sumner.js

@@ -0,0 +1,134 @@
+import { z } from 'zod';
+import { listCycles, getCycleCandidates, getReport } from '../api/sumner-client.js';
+import { isImageFallback } from '../api/gemini-pdf.js';
+export function registerSumnerTools(server) {
+    // ============================================================
+    // list_sumner_election_cycles
+    // ============================================================
+    server.tool('list_sumner_election_cycles', 'List available Sumner County TN campaign finance disclosure cycles (2016-2028). Sumner County publishes PDF campaign finance reports on votesumnertn.org. Use search_sumner_candidates to see candidates and their report PDFs for a specific cycle. Use get_sumner_report to extract financial data from a specific PDF via Gemini Vision AI.', {}, async () => {
+        const cycles = listCycles();
+        return {
+            content: [{
+                    type: 'text',
+                    text: `${cycles.length} Sumner County election cycles:\n\n${JSON.stringify(cycles, null, 2)}`,
+                }],
+        };
+    });
+    // ============================================================
+    // search_sumner_candidates
+    // ============================================================
+    server.tool('search_sumner_candidates', 'Search candidates in a Sumner County TN election cycle. Scrapes votesumnertn.org and returns candidates, offices, districts, and links to their PDF campaign finance reports. Results cached 15 minutes. This returns metadata and PDF links only — use get_sumner_report with a PDF URL to extract actual financial data (contributions, expenditures, balances).', {
+        cycle: z.string().describe('Election cycle year (e.g., "2026", "2024", "2016" matches "2016-2018")'),
+        name: z.string().optional().describe('Filter by candidate name (case-insensitive partial match)'),
+        office: z.string().optional().describe('Filter by office name (case-insensitive partial match, e.g., "mayor", "commissioner", "school")'),
+    }, async ({ cycle, name, office }) => {
+        try {
+            const page = await getCycleCandidates(cycle);
+            let candidates = page.candidates;
+            if (name) {
+                const lower = name.toLowerCase();
+                candidates = candidates.filter(c => c.name.toLowerCase().includes(lower));
+            }
+            if (office) {
+                const lower = office.toLowerCase();
+                candidates = candidates.filter(c => c.office.name.toLowerCase().includes(lower) ||
+                    (c.office.district || '').toLowerCase().includes(lower) ||
+                    (c.office.municipality || '').toLowerCase().includes(lower));
+            }
+            const output = {
+                cycle: page.cycle,
+                candidateCount: candidates.length,
+                candidates: candidates.map(c => ({
+                    name: c.name,
+                    office: c.office.name,
+                    district: c.office.district || null,
+                    municipality: c.office.municipality || null,
+                    reportCount: c.reports.length,
+                    reports: c.reports,
+                })),
+                nonDisclosureCount: page.nonDisclosures.length,
+                nonDisclosures: name
+                    ? page.nonDisclosures.filter(nd => nd.name.toLowerCase().includes(name.toLowerCase()))
+                    : page.nonDisclosures,
+                scrapedAt: page.scrapedAt,
+            };
+            if (candidates.length === 0 && output.nonDisclosures.length === 0) {
+                const hint = name || office
+                    ? `No candidates matched your filters in the ${cycle} cycle. Try broader terms.`
+                    : `No candidates found for the ${cycle} cycle. The page may have changed format.`;
+                return { content: [{ type: 'text', text: hint }] };
+            }
+            return {
+                content: [{
+                        type: 'text',
+                        text: `Sumner County ${page.cycle.label} — ${candidates.length} candidate(s):\n\n${JSON.stringify(output, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+    // ============================================================
+    // get_sumner_report
+    // ============================================================
+    server.tool('get_sumner_report', 'Extract financial data from a Sumner County campaign finance PDF using Gemini Flash AI. Downloads the PDF from votesumnertn.org, sends it to Gemini for structured extraction, and returns contributions, expenditures, beginning/ending balance (cash on hand), and totals. If Gemini is unavailable, falls back to returning PDF page images for Claude to read directly. IMPORTANT: Gemini path takes 10-30 seconds and uses API credits. Results cached 30 minutes. Get the PDF URL from search_sumner_candidates results. Set include_line_items=false for summary totals only.', {
+        pdf_url: z.string().describe('Full PDF URL from search_sumner_candidates report links'),
+        report_name: z.string().optional().describe('Report name for context (e.g., "YE 2025 Report")'),
+        include_line_items: z.boolean().optional().describe('Include itemized contributions/expenditures (default true). False for summary only.'),
+    }, async ({ pdf_url, report_name, include_line_items }) => {
+        try {
+            // Validate URL strictly
+            const url = new URL(pdf_url);
+            if ((url.hostname !== 'www.votesumnertn.org' && url.hostname !== 'votesumnertn.org') ||
+                url.protocol !== 'https:' || !url.pathname.endsWith('.pdf')) {
+                return {
+                    content: [{ type: 'text', text: 'Error: URL must be an HTTPS PDF from votesumnertn.org' }],
+                    isError: true,
+                };
+            }
+            const result = await getReport(pdf_url, report_name || 'Unknown Report');
+            // Image fallback: return page images for Claude to read directly
+            if (isImageFallback(result)) {
+                const content = [
+                    { type: 'text', text: result.message },
+                ];
+                for (const img of result.images) {
+                    content.push({
+                        type: 'image',
+                        data: img.base64,
+                        mimeType: img.mimeType,
+                    });
+                }
+                return { content };
+            }
+            // Structured Gemini result
+            const report = result;
+            const output = include_line_items === false
+                ? {
+                    ...report,
+                    contributions: `${report.contributions.length} item(s) (omitted — set include_line_items=true)`,
+                    expenditures: `${report.expenditures.length} item(s) (omitted)`,
+                }
+                : report;
+            const confidence = report.extractionConfidence === 'high' ? ''
+                : `\nExtraction confidence: ${report.extractionConfidence}. Review warnings for details.\n`;
+            return {
+                content: [{
+                        type: 'text',
+                        text: `${report.candidateName} — ${report.reportPeriod}:${confidence}\n${JSON.stringify(output, null, 2)}`,
+                    }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=sumner.js.map

package/dist/tools/sumner.js.map

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

package/dist/tools/tncamp.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTncampTools(server: McpServer): void;