@cyanheads/openfec-mcp-server 0.2.2

package/dist/services/openfec/openfec-service.js

@@ -0,0 +1,384 @@
+/**
+ * @fileoverview OpenFEC API service. Wraps all FEC REST API interactions
+ * with timeout, retry, and pagination handling. Single service used by
+ * all tools and resources.
+ * @module src/services/openfec/openfec-service
+ */
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+import { getServerConfig } from '../../config/server-config.js';
+/* ------------------------------------------------------------------ */
+/*  Cursor encoding for keyset pagination                             */
+/* ------------------------------------------------------------------ */
+/** Encode `last_indexes` from SEEK pagination into an opaque cursor. */
+export function encodeCursor(lastIndexes) {
+    return btoa(JSON.stringify(lastIndexes));
+}
+/** Decode an opaque cursor back to `last_indexes` query params. */
+export function decodeCursor(cursor) {
+    return JSON.parse(atob(cursor));
+}
+/* ------------------------------------------------------------------ */
+/*  Context adapter                                                   */
+/* ------------------------------------------------------------------ */
+/**
+ * Extract a RequestContext from a handler Context.
+ * Needed because `exactOptionalPropertyTypes` makes Context's optional
+ * `T | undefined` fields incompatible with RequestContext's optional `T` fields.
+ */
+function toRequestContext(ctx) {
+    const rc = { requestId: ctx.requestId, timestamp: ctx.timestamp };
+    if (ctx.tenantId)
+        rc.tenantId = ctx.tenantId;
+    if (ctx.traceId)
+        rc.traceId = ctx.traceId;
+    if (ctx.spanId)
+        rc.spanId = ctx.spanId;
+    if (ctx.auth)
+        rc.auth = ctx.auth;
+    return rc;
+}
+/* ------------------------------------------------------------------ */
+/*  Service class                                                     */
+/* ------------------------------------------------------------------ */
+export class OpenFecService {
+    config;
+    constructor() {
+        this.config = getServerConfig();
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Internal fetch helpers                                          */
+    /* ---------------------------------------------------------------- */
+    /** Build a full URL with query params, injecting the API key. */
+    buildUrl(path, params = {}) {
+        const base = this.config.fecBaseUrl.replace(/\/$/, '');
+        const url = new URL(`${base}${path}`);
+        url.searchParams.set('api_key', this.config.fecApiKey);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === '')
+                continue;
+            if (Array.isArray(value)) {
+                for (const v of value)
+                    url.searchParams.append(key, v);
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    /**
+     * Fetch JSON from a page-based endpoint with retry.
+     * Wraps the full pipeline (fetch + JSON parse) in the retry boundary.
+     */
+    async fetchPage(path, params, ctx) {
+        const url = this.buildUrl(path, params);
+        const reqCtx = toRequestContext(ctx);
+        try {
+            return await withRetry(async () => {
+                const response = await fetchWithTimeout(url, this.config.fecRequestTimeout, reqCtx, {
+                    signal: ctx.signal,
+                });
+                const body = (await response.json());
+                this.validateEnvelope(body);
+                return {
+                    pagination: {
+                        page: body.pagination?.page ?? 1,
+                        pages: body.pagination?.pages ?? 1,
+                        count: body.pagination?.count ?? body.results?.length ?? 0,
+                        per_page: body.pagination?.per_page ?? 20,
+                    },
+                    results: body.results,
+                };
+            }, {
+                maxRetries: this.config.fecMaxRetries,
+                baseDelayMs: 1_000,
+                operation: `FEC ${path}`,
+                context: reqCtx,
+                signal: ctx.signal,
+                isTransient: isTransientFecError,
+            });
+        }
+        catch (err) {
+            rethrowSanitized(err);
+        }
+    }
+    /**
+     * Fetch JSON from a keyset (SEEK) endpoint with retry.
+     * Returns a `nextCursor` from `last_indexes` when more results exist.
+     */
+    async fetchSeek(path, params, ctx) {
+        const url = this.buildUrl(path, params);
+        const reqCtx = toRequestContext(ctx);
+        try {
+            return await withRetry(async () => {
+                const response = await fetchWithTimeout(url, this.config.fecRequestTimeout, reqCtx, {
+                    signal: ctx.signal,
+                });
+                const body = (await response.json());
+                this.validateEnvelope(body);
+                const lastIndexes = body.pagination.last_indexes;
+                const hasMore = lastIndexes && Object.keys(lastIndexes).length > 0 && body.results.length > 0;
+                return {
+                    pagination: {
+                        count: body.pagination.count,
+                        per_page: body.pagination.per_page,
+                    },
+                    results: body.results,
+                    nextCursor: hasMore ? encodeCursor(lastIndexes) : null,
+                };
+            }, {
+                maxRetries: this.config.fecMaxRetries,
+                baseDelayMs: 1_000,
+                operation: `FEC ${path}`,
+                context: reqCtx,
+                signal: ctx.signal,
+                isTransient: isTransientFecError,
+            });
+        }
+        catch (err) {
+            rethrowSanitized(err);
+        }
+    }
+    /** Fetch legal search results with retry. Normalizes type-keyed arrays. */
+    async fetchLegalSearch(params, ctx) {
+        const url = this.buildUrl('/legal/search/', params);
+        const reqCtx = toRequestContext(ctx);
+        try {
+            return await withRetry(async () => {
+                const response = await fetchWithTimeout(url, this.config.fecRequestTimeout, reqCtx, {
+                    signal: ctx.signal,
+                });
+                const body = (await response.json());
+                const results = [];
+                for (const ao of body.advisory_opinions ?? []) {
+                    results.push({ ...ao, document_type: 'advisory_opinion' });
+                }
+                for (const mur of body.murs ?? []) {
+                    results.push({ ...mur, document_type: 'mur' });
+                }
+                for (const adr of body.adrs ?? []) {
+                    results.push({ ...adr, document_type: 'adr' });
+                }
+                for (const fine of body.admin_fines ?? []) {
+                    results.push({ ...fine, document_type: 'admin_fine' });
+                }
+                for (const statute of body.statutes ?? []) {
+                    results.push({ ...statute, document_type: 'statute' });
+                }
+                return { results, totalCount: body.total_all ?? results.length };
+            }, {
+                maxRetries: this.config.fecMaxRetries,
+                baseDelayMs: 1_000,
+                operation: 'FEC /legal/search/',
+                context: reqCtx,
+                signal: ctx.signal,
+                isTransient: isTransientFecError,
+            });
+        }
+        catch (err) {
+            rethrowSanitized(err);
+        }
+    }
+    /** Validate that the API returned a recognizable envelope, not an HTML error page. */
+    validateEnvelope(body) {
+        if (!body || typeof body !== 'object' || !('results' in body)) {
+            throw new Error('FEC API returned an unexpected response (possible HTML error page)');
+        }
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Candidates                                                      */
+    /* ---------------------------------------------------------------- */
+    searchCandidates(params, ctx) {
+        return this.fetchPage('/candidates/', params, ctx);
+    }
+    getCandidate(candidateId, ctx) {
+        return this.fetchPage(`/candidate/${candidateId}/`, {}, ctx);
+    }
+    getCandidateTotals(params, ctx) {
+        return this.fetchPage('/candidates/totals/', params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Committees                                                      */
+    /* ---------------------------------------------------------------- */
+    searchCommittees(params, ctx) {
+        return this.fetchPage('/committees/', params, ctx);
+    }
+    getCommittee(committeeId, ctx) {
+        return this.fetchPage(`/committee/${committeeId}/`, {}, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Contributions (Schedule A)                                      */
+    /* ---------------------------------------------------------------- */
+    searchContributions(params, ctx) {
+        return this.fetchSeek('/schedules/schedule_a/', params, ctx);
+    }
+    getContributionAggregates(mode, params, ctx) {
+        const paths = {
+            by_size: '/schedules/schedule_a/by_size/',
+            by_size_candidate: '/schedules/schedule_a/by_size/by_candidate/',
+            by_state: '/schedules/schedule_a/by_state/',
+            by_state_candidate: '/schedules/schedule_a/by_state/by_candidate/',
+            by_employer: '/schedules/schedule_a/by_employer/',
+            by_occupation: '/schedules/schedule_a/by_occupation/',
+        };
+        const path = paths[mode];
+        if (!path)
+            throw new Error(`Unknown contribution aggregate mode: ${mode}`);
+        return this.fetchPage(path, params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Disbursements (Schedule B)                                      */
+    /* ---------------------------------------------------------------- */
+    searchDisbursements(params, ctx) {
+        return this.fetchSeek('/schedules/schedule_b/', params, ctx);
+    }
+    getDisbursementAggregates(mode, params, ctx) {
+        const paths = {
+            by_purpose: '/schedules/schedule_b/by_purpose/',
+            by_recipient: '/schedules/schedule_b/by_recipient/',
+            by_recipient_id: '/schedules/schedule_b/by_recipient_id/',
+        };
+        const path = paths[mode];
+        if (!path)
+            throw new Error(`Unknown disbursement aggregate mode: ${mode}`);
+        return this.fetchPage(path, params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Independent Expenditures (Schedule E)                           */
+    /* ---------------------------------------------------------------- */
+    searchExpenditures(params, ctx) {
+        return this.fetchSeek('/schedules/schedule_e/', params, ctx);
+    }
+    getExpendituresByCandidate(params, ctx) {
+        return this.fetchPage('/schedules/schedule_e/by_candidate/', params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Filings                                                         */
+    /* ---------------------------------------------------------------- */
+    searchFilings(params, ctx) {
+        return this.fetchPage('/filings/', params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Elections                                                       */
+    /* ---------------------------------------------------------------- */
+    searchElections(params, ctx) {
+        return this.fetchPage('/elections/', params, ctx);
+    }
+    /** Fetch election summary — flat response (no pagination wrapper). */
+    async getElectionSummary(params, ctx) {
+        const url = this.buildUrl('/elections/summary/', params);
+        const reqCtx = toRequestContext(ctx);
+        try {
+            return await withRetry(async () => {
+                const response = await fetchWithTimeout(url, this.config.fecRequestTimeout, reqCtx, {
+                    signal: ctx.signal,
+                });
+                const body = (await response.json());
+                if (typeof body?.count !== 'number') {
+                    throw new Error('FEC API returned an unexpected response (possible HTML error page)');
+                }
+                return body;
+            }, {
+                maxRetries: this.config.fecMaxRetries,
+                baseDelayMs: 1_000,
+                operation: 'FEC /elections/summary/',
+                context: reqCtx,
+                signal: ctx.signal,
+                isTransient: isTransientFecError,
+            });
+        }
+        catch (err) {
+            rethrowSanitized(err);
+        }
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Legal                                                           */
+    /* ---------------------------------------------------------------- */
+    searchLegal(params, ctx) {
+        return this.fetchLegalSearch(params, ctx);
+    }
+    /* ---------------------------------------------------------------- */
+    /*  Calendar                                                        */
+    /* ---------------------------------------------------------------- */
+    getCalendarDates(params, ctx) {
+        return this.fetchPage('/calendar-dates/', params, ctx);
+    }
+    getReportingDates(params, ctx) {
+        return this.fetchPage('/reporting-dates/', params, ctx);
+    }
+    getElectionDates(params, ctx) {
+        return this.fetchPage('/election-dates/', params, ctx);
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Error sanitization                                                */
+/* ------------------------------------------------------------------ */
+/** Strip API key values from error messages to prevent leaking secrets in tool output. */
+function sanitizeErrorMessage(msg) {
+    return msg.replace(/api_key=[^&\s"')]+/g, 'api_key=REDACTED');
+}
+/** Map HTTP status codes from upstream FEC API to actionable messages. */
+function enrichStatusError(msg) {
+    const statusMatch = msg.match(/Status:\s*(\d{3})/);
+    if (!statusMatch)
+        return msg;
+    const status = Number(statusMatch[1]);
+    const hints = {
+        400: 'Bad request — check parameter names and types.',
+        403: 'Forbidden — the API key may be invalid or expired.',
+        404: 'Endpoint not found — verify the API path.',
+        422: 'The FEC API rejected the request parameters. Check required fields and value formats for this endpoint.',
+        429: 'FEC API rate limit exceeded. Wait a moment and retry.',
+        500: 'FEC API internal error. Retry shortly.',
+        502: 'FEC API is temporarily unreachable. Retry shortly.',
+        503: 'FEC API is temporarily unavailable. Retry shortly.',
+    };
+    const hint = hints[status];
+    return hint ? `${sanitizeErrorMessage(msg)} — ${hint}` : sanitizeErrorMessage(msg);
+}
+/**
+ * Re-throw an error with its message sanitized (API key stripped)
+ * and enriched with actionable context for HTTP status errors.
+ * Preserves the original error as `cause` for internal debugging.
+ */
+function rethrowSanitized(err) {
+    if (err instanceof Error) {
+        const clean = new Error(enrichStatusError(err.message), { cause: err });
+        clean.name = err.name;
+        throw clean;
+    }
+    throw err;
+}
+/* ------------------------------------------------------------------ */
+/*  Transient error classification                                    */
+/* ------------------------------------------------------------------ */
+/** Classify errors as transient for retry purposes. */
+function isTransientFecError(error) {
+    if (!error || typeof error !== 'object')
+        return false;
+    const msg = 'message' in error ? String(error.message) : '';
+    if (msg.includes('ServiceUnavailable') || msg.includes('503') || msg.includes('502'))
+        return true;
+    if (msg.includes('429') || msg.includes('OVER_RATE_LIMIT') || msg.includes('rate limit')) {
+        return true;
+    }
+    if (msg.includes('unexpected response') || msg.includes('HTML error page'))
+        return true;
+    if (msg.includes('ECONNRESET') || msg.includes('ETIMEDOUT') || msg.includes('fetch failed')) {
+        return true;
+    }
+    return false;
+}
+/* ------------------------------------------------------------------ */
+/*  Singleton accessor                                                */
+/* ------------------------------------------------------------------ */
+let _service;
+export function initOpenFecService() {
+    _service = new OpenFecService();
+}
+export function getOpenFecService() {
+    if (!_service)
+        throw new Error('OpenFecService not initialized — call initOpenFecService() in setup()');
+    return _service;
+}
+//# sourceMappingURL=openfec-service.js.map

package/dist/services/openfec/openfec-service.js.map

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

package/dist/services/openfec/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Types for OpenFEC API responses and service return values.
+ * Covers the three pagination models (page-based, keyset/SEEK, legal search)
+ * and normalized result shapes returned by the service layer.
+ * @module src/services/openfec/types
+ */
+/** Page-based pagination metadata (candidates, committees, filings, elections, calendar). */
+export interface FecPagePagination {
+    count: number;
+    is_count_exact?: boolean;
+    page: number;
+    pages: number;
+    per_page: number;
+}
+/** Keyset (SEEK) pagination metadata (Schedule A/B/E). */
+export interface FecSeekPagination {
+    count: number;
+    is_count_exact?: boolean;
+    last_indexes?: Record<string, string>;
+    per_page: number;
+}
+/** Standard FEC API response envelope with page-based pagination. */
+export interface FecPageEnvelope<T = Record<string, unknown>> {
+    api_version: string;
+    pagination: FecPagePagination;
+    results: T[];
+}
+/** FEC API response envelope with keyset pagination. */
+export interface FecSeekEnvelope<T = Record<string, unknown>> {
+    api_version: string;
+    pagination: FecSeekPagination;
+    results: T[];
+}
+/**
+ * Legal search response — type-keyed result arrays instead of a
+ * uniform `results` array. Each type has its own array and total count.
+ */
+export interface FecLegalEnvelope {
+    admin_fines: Record<string, unknown>[];
+    adrs: Record<string, unknown>[];
+    advisory_opinions: Record<string, unknown>[];
+    murs: Record<string, unknown>[];
+    statutes: Record<string, unknown>[];
+    total_admin_fines: number;
+    total_adrs: number;
+    total_advisory_opinions: number;
+    total_all: number;
+    total_murs: number;
+    total_statutes: number;
+}
+/** Normalized result from page-based endpoints. */
+export interface PageResult<T = Record<string, unknown>> {
+    pagination: {
+        page: number;
+        pages: number;
+        count: number;
+        per_page: number;
+    };
+    results: T[];
+}
+/** Normalized result from keyset (SEEK) endpoints. */
+export interface SeekResult<T = Record<string, unknown>> {
+    nextCursor: string | null;
+    pagination: {
+        count: number;
+        per_page: number;
+    };
+    results: T[];
+}
+/** Normalized legal search result with a flat results array. */
+export interface LegalResult {
+    results: Array<Record<string, unknown> & {
+        document_type: string;
+    }>;
+    totalCount: number;
+}
+/** Flat response from the /elections/summary/ endpoint (no pagination wrapper). */
+export interface ElectionSummary {
+    count: number;
+    disbursements: number;
+    independent_expenditures: number;
+    receipts: number;
+}
+/** Query params passed to FEC API methods. Undefined values are stripped. Arrays serialize as repeated query params. */
+export type FecParams = Record<string, string | number | boolean | string[] | undefined>;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/openfec/types.d.ts.map

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

package/dist/services/openfec/types.js

@@ -0,0 +1,8 @@
+/**
+ * @fileoverview Types for OpenFEC API responses and service return values.
+ * Covers the three pagination models (page-based, keyset/SEEK, legal search)
+ * and normalized result shapes returned by the service layer.
+ * @module src/services/openfec/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/openfec/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/openfec/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@cyanheads/openfec-mcp-server",
+  "version": "0.2.2",
+  "mcpName": "io.github.cyanheads/openfec-mcp-server",
+  "description": "Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openfec-mcp-server": "dist/index.js"
+  },
+  "files": ["dist/", "README.md", "LICENSE", "CLAUDE.md", "Dockerfile", "server.json"],
+  "scripts": {
+    "build": "bun run scripts/build.ts",
+    "rebuild": "bun run scripts/clean.ts && bun run build",
+    "clean": "bun run scripts/clean.ts",
+    "devcheck": "bun run scripts/devcheck.ts",
+    "tree": "bun run scripts/tree.ts",
+    "format": "biome check --write --unsafe",
+    "lint:mcp": "bun run scripts/lint-mcp.ts",
+    "test": "bunx vitest run",
+    "dev:stdio": "MCP_TRANSPORT_TYPE=stdio bun --watch src/index.ts",
+    "dev:http": "MCP_TRANSPORT_TYPE=http bun --watch src/index.ts",
+    "start:stdio": "MCP_TRANSPORT_TYPE=stdio bun ./dist/index.js",
+    "start:http": "MCP_TRANSPORT_TYPE=http bun ./dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "openfec",
+    "fec",
+    "campaign-finance",
+    "elections",
+    "federal-elections",
+    "political-contributions",
+    "typescript",
+    "ai-agent"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cyanheads/openfec-mcp-server.git"
+  },
+  "bugs": {
+    "url": "https://github.com/cyanheads/openfec-mcp-server/issues"
+  },
+  "homepage": "https://github.com/cyanheads/openfec-mcp-server#readme",
+  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/openfec-mcp-server#readme)",
+  "funding": [
+    {
+      "type": "github",
+      "url": "https://github.com/sponsors/cyanheads"
+    },
+    {
+      "type": "buy_me_a_coffee",
+      "url": "https://www.buymeacoffee.com/cyanheads"
+    }
+  ],
+  "license": "Apache-2.0",
+  "packageManager": "bun@1.3.11",
+  "engines": {
+    "bun": ">=1.2.0",
+    "node": ">=22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "overrides": {
+    "brace-expansion": ">=2.0.3",
+    "express-rate-limit": ">=8.2.2",
+    "hono": ">=4.12.7",
+    "path-to-regexp": ">=8.4.0",
+    "picomatch": ">=4.0.4",
+    "yaml": ">=2.8.3",
+    "lodash": ">=4.17.24"
+  },
+  "dependencies": {
+    "@cyanheads/mcp-ts-core": "^0.2.12",
+    "@opentelemetry/api": "^1.9.1",
+    "pino-pretty": "^13.1.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
+    "@types/node": "^25.5.2",
+    "depcheck": "^1.4.7",
+    "ignore": "^7.0.5",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}