Potencialize seu agente
A URL do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
https://openfec.caseyjhand.com/mcpO botão do Claude acima abre o Claude com o nome e a URL preenchidos. Você ainda precisa confirmar lá.
claude mcp add --transport http io.github.cyanheads-openfec-mcp-server https://openfec.caseyjhand.com/mcpRun in a terminal.
{ "mcpServers": { "io.github.cyanheads-openfec-mcp-server": { "command": "npx", "args": [ "-y", "mcp-remote", "https://openfec.caseyjhand.com/mcp" ] } }}claude_desktop_config.json
URL remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirPublic Hosted Server: https://openfec.caseyjhand.com/mcp
US federal campaign finance data from the FEC's OpenFEC API. Search candidates, committees, and filings, trace contributions (Schedule A), disbursements (Schedule B), and independent and coordinated party expenditures (Schedules E/F), and look up election races, legal documents, and filing deadlines.
The same data is reachable through openfec_search_candidates, openfec_search_committees, and openfec_lookup_elections for tool-only clients.
openfec_search_candidates toolquery name search filtered by state, district, office, party, cycle, election_year, incumbent_challenge, candidate_status, and has_raised_funds, up to 100 per page; or a candidate_id lookup (H/S/P + eight letters or digits) returning one full recordinclude_totals (default on for an ID lookup) adds per-cycle totals rows and caps a search page at 35 candidates when cycle or election_year scopes the totals, 5 when they span every cycle; candidates the totals fetch didn't reach are listed in missing_totalscandidate_not_found, inputs_not_applicable_to_id_lookupopenfec_search_committees toolquery name search filtered by candidate_id, state, party, committee_type, designation, cycle, and treasurer_name, up to 100 per page; or a committee_id lookup (C + eight digits)committee_not_found, inputs_not_applicable_to_id_lookupopenfec_get_committee_totals toolmode: "single" (default) takes a committee_id and returns one row per two-year cycle; mode: "by_entity_type" ranks every committee of one entity_type (presidential, pac, party, pac-party, house-senate, ie-only), filterable by state, type, designation, organization type, and receipts/disbursements bounds; up to 100 per pagemode says whether rows are cycles or committeescommittee_id_required_for_single_mode, entity_type_required_for_group_mode, committee_totals_not_foundopenfec_search_contributions toolitemized (default) needs a committee_id and filters by contributor name, employer, occupation, city, state, ZIP, date and amount ranges, and is_individual, 30 rows per page; by_size / by_state take a committee_id or candidate_id, by_employer / by_occupation a committee_idmode becomes by_size_candidate or by_state_candidate when scoped by candidate, a different row shape; itemized responses carry next_cursor, count, and count_is_approximateitemized_requires_committee_id, aggregate_requires_committee_idopenfec_search_disbursements toolcommittee_id required in every mode: itemized (default; recipient name, state, city, and committee ID, description, purpose category, date and amount ranges, 30 rows per page), by_purpose, by_recipient, by_recipient_idnext_cursor, count, and count_is_approximate; aggregate modes page by numberopenfec_search_expenditures toolitemized (default) filters by committee, candidate, support_oppose, payee, targeted office/state/district, party, is_notice (24/48-hour notices), dates, and amounts; most_recent defaults to true; 60 rows per page when scoped by committee_id, 30 otherwiseby_candidate totals need a candidate_id or a full race scope (candidate_office=P alone, S plus candidate_office_state, H plus state and candidate_office_district), or fail as by_candidate_requires_scopeopenfec_search_coordinated_expenditures toolcommittee_id, benefiting candidate_id, cycle, payee, dates, and amounts; unscoped queries span all yearscommittee_id and 25 otherwise; rows carry subordinate_committee_id, the committee the spending is attributed toopenfec_search_filings toolmost_recent defaults to true, hiding superseded amendments; rows carry form and report type, financial totals, and pdf_urlopenfec_lookup_elections tooloffice and an even cycle are required; Senate also needs state and House state plus district, unless a zip scopes a searchmode: "search" (default) returns the race's candidates with totals and candidate_pcc_id / candidate_pcc_name, that cycle's principal campaign committee; mode: "summary" returns one aggregate race rowcycle_must_be_even, missing_state_for_office, missing_district_for_house, summary_does_not_support_zipopenfec_search_legal tooltype (advisory_opinions, murs, adrs, admin_fines, statutes), query, ao_number, case_number, respondent, citations, penalty bounds, or dates; at least one is required (missing_filter), and a date bound needs type plus a date_kind that type recordstype it doesn't filter fails as filter_not_valid_for_type, and with type omitted the search returns only the types they all apply to, with a total over those types. On MURs and ADRs a citation can't be combined with case_number, respondent, a penalty bound, or an open/close date bound, which upstream would ignore; the two citation fields together match either one52 U.S.C. 30104 or 11 CFR 110.1 (USC, C.F.R., §, and suffixes like 30104(g) are fine); a bare 30106 or 110.1 fails as invalid_citation instead of silently returning unfiltered results. One citation per field: upstream applies only the first citation in a value, so 52 U.S.C. 30104, 52 U.S.C. 30118 fails the same wayfrom_hit / hits_returned, up to 200 per type within a 10,000-result windowdocuments becomes document_count and document_categories, dispositions becomes disposition_count and disposition_categories, highlights stop at 3 with their <em> match markup removed and render one per line, and commission_votes shrink to a date and a 200-character action; openfec_get_legal_document returns the full recordtruncated, shown, and nextFromHit — the from_hit that continues each type, passed back with that typeopenfec_get_legal_document tooldoc_type is the plural of a search result's document_type (mur → murs); no is that result's no fielddocuments, commission_votes, and dispositions; fails as legal_document_not_foundwithheld — each held-back array with its entry count and size; re-call with array and offset for that array's entries while they fit, plus next_offset. An array the record lacks fails as array_not_in_recordopenfec_lookup_calendar toolevents (default; category, one of 18 codes, and description), filing_deadlines (report_type, report_year), or election_dates (state, office, district, election_year); min_date / max_date apply in every mode, up to 100 per pagedistrict filter never matches an at-large race; pair it with stateopenfec://candidate/{candidate_id} resourceprincipal_committees (current designation P, not scoped to a cycle)candidate_id comes from openfec_search_candidates; fails as candidate_not_foundopenfec://committee/{committee_id} resourcecommittee_id comes from openfec_search_committees; fails as committee_not_foundopenfec://election/{cycle}/{office} resourceoffice P), with totals for the full election periodtruncation_notice pointing to openfec_lookup_elections, and an empty one empty_result_noticeopenfec://election/{cycle}/{office}/{state} resourceoffice S or H)openfec://election/{cycle}/{office}/{state}/{district} resourceoffice H)openfec_money_trail promptcandidate_name or candidate_id (one required), optional cyclecandidate_pcc_id, then direct fundraising, independent expenditures, coordinated party spending, disbursements, and a synthesisopenfec_campaign_analysis promptcandidate_name or candidate_id (one required), optional cycleBuilt on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
OpenFEC-specific:
cycle is omitted, and election_full (default true) widens a race total to the full election period (4yr president, 6yr senate, 2yr house)committee_id, not a candidate_id. Committee designation and principal_committees reflect current designation only, so for a cycle's principal committee read candidate_pcc_id from openfec_lookup_electionsnext_cursor, valid only for an otherwise-identical call; other tools page by number, and legal search by offsetAgent-friendly output:
search_criteria with the post-default filters, and an empty result carries a notice on how to broaden ittruncated, shown, and cap when a page falls below the requested per_page (page-based tools also echo the applied size in pagination.per_page); legal search holds back whole results and reports nextFromHit, and a large legal document pages its arrays by offset; a single-committee query lifts that committee into one top-level committee field instead of repeating it per rowmode and reject a filter the mode can't apply (itemized_only_filters_in_aggregate_mode, inputs_not_applicable_to_mode) instead of dropping it; every failure carries a typed reason and recovery text, and estimated totals are flagged count_is_approximateA public instance is available at https://openfec.caseyjhand.com/mcp — no installation required. It serves Streamable HTTP; each client takes its own config shape.
For Claude Code:
claude mcp add --transport http openfec-mcp-server https://openfec.caseyjhand.com/mcp
For Cline (cline_mcp_settings.json):
{
"mcpServers": {
"openfec-mcp-server": {
"type": "streamableHttp",
"url": "https://openfec.caseyjhand.com/mcp"
}
}
}
For Cursor (mcp.json):
{
"mcpServers": {
"openfec-mcp-server": {
"url": "https://openfec.caseyjhand.com/mcp"
}
}
}
Claude Desktop adds remote servers under Settings → Connectors.
Add the following to your MCP client configuration file.
{
"mcpServers": {
"openfec-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/openfec-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"FEC_API_KEY": "your-api-key"
}
}
}
}
Or with npx (no Bun required):
{
"mcpServers": {
"openfec-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cyanheads/openfec-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"FEC_API_KEY": "your-api-key"
}
}
}
}
Or with Docker:
{
"mcpServers": {
"openfec-mcp-server": {
"type": "stdio",
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT_TYPE=stdio", "-e", "FEC_API_KEY=your-api-key", "ghcr.io/cyanheads/openfec-mcp-server:latest"]
}
}
}
For Streamable HTTP, set the transport and start the server:
MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 FEC_API_KEY=your-key bun run start:http
# Server listens at http://localhost:3010/mcp
DEMO_KEY.git clone https://github.com/cyanheads/openfec-mcp-server.git
cd openfec-mcp-server
bun install
cp .env.example .env
# edit .env and set FEC_API_KEY (optional)
See .env.example for the full list of optional overrides.
Build and run:
bun run rebuild
bun run start:stdio # or start:http
Run checks and tests:
bun run devcheck # Lint, format, typecheck, security audit
bun run test # Vitest test suite
bun run lint:mcp # Validate MCP definitions against spec
docker build -t openfec-mcp-server .
docker run --rm -e FEC_API_KEY=your-key -p 3010:3010 openfec-mcp-server
The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/openfec-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
See CLAUDE.md for development guidelines and architectural rules. The short version:
try/catch in tool logicctx.log for logging, ctx.state for storagesrc/mcp-server/*/definitions/index.tsIssues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run test
Apache-2.0 — see LICENSE for details.
Access FEC campaign finance data. Query data about candidates, money trails, and election filings.
{ "mcpServers": { "io.github.cyanheads-openfec-mcp-server": { "url": "https://openfec.caseyjhand.com/mcp", "headers": {} } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração http para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
O publicador lista estas variáveis de ambiente: FEC_API_KEY, MCP_LOG_LEVEL, MCP_TRANSPORT_TYPE, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE.
Openfec é acessado por HTTP.
Última verificação: 2026-11-19. Access FEC campaign finance data. Query data about candidates, money trails, and election filings.