io.github.cyanheads/openfec-mcp-server

REMOTE · OPENFEC.CASEYJHAND.COM · 2 COMPONENTS · SCANNED AUG 3

Access FEC campaign finance data. Query data about candidates, money trails, and election filings.

Available components

remote · openfec.caseyjhand.com 70 npm · @cyanheads/openfec-mcp-server 35

+4 this week 70 70 Trust /100

Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →

Endpoint Security66

The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
Authorisation not fully verified: no authorisation is required to call this server, and 12 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass

Transport & Reachability100

Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass

Schema Quality & AI Usability74

100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 5701 tokens (~475/item across 12 items; 12 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass
Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

remote · openfec.caseyjhand.com

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add --transport http cyanheads-openfec-mcp-server https://openfec.caseyjhand.com/mcp

# ~/.codex/config.toml

[mcp_servers.cyanheads-openfec-mcp-server]
url = "https://openfec.caseyjhand.com/mcp"

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-openfec-mcp-server": {
      "type": "remote",
      "url": "https://openfec.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add cyanheads-openfec-mcp-server --url https://openfec.caseyjhand.com/mcp --transport streamable-http

# ~/.hermes/config.yaml

mcp_servers:
  cyanheads-openfec-mcp-server:
    url: "https://openfec.caseyjhand.com/mcp"

// mcp.json

{
  "mcpServers": {
    "cyanheads-openfec-mcp-server": {
      "type": "http",
      "url": "https://openfec.caseyjhand.com/mcp"
    }
  }
}

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

2 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.
31 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 +1
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
29 Jul 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.
27 Jul 26 +1
- Stability: unverified → 0.03 ▲ functional
26 Jul 26 65

First indexed and scored.

Show 5 earlier entries Hide earlier entries

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Probed https://openfec.caseyjhand.com/mcp

TLS valid

Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .

Subject	Issuer	Valid from	Valid until	Key	Signature	Serial
CN=caseyjhand.com	CN=WE1,O=Google Trust Services,C=US	7 Jul 2026	5 Oct 2026	ECDSA 256	ECDSA-SHA256	5aad900eb2055a0b0ea55912ec19680c
SANs: caseyjhand.com, *.caseyjhand.com
CN=WE1,O=Google Trust Services,C=US (CA)	CN=GTS Root R4,O=Google Trust Services LLC,C=US	13 Dec 2023	20 Feb 2029	ECDSA 256	ECDSA-SHA384	7ff31977972c224a76155d13b6d685e3
CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA)	CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE	15 Nov 2023	28 Jan 2028	ECDSA 384	SHA256-RSA	7fe530bf331343bedd821610493d8a1b

DNSSEC secure

Validation of openfec.caseyjhand.com. — Secure

Zone	DS	Keys	Algorithms	Outcome
.	trust_anchor	20326, 38696	8, 8	Verified
com.	present	19718	13	Verified
caseyjhand.com.	present	2371	13	Verified
openfec.caseyjhand.com.				Verified address RRset verified with the apex keys

Authentication No authorisation required

The endpoint answered without asking for a token. Anyone who knows the URL can reach it.

Result	No authorisation required
HTTP status	200

Header	Value
strict-transport-security	max-age=63072000; includeSubDomains; preload
x-content-type-options	nosniff

Transports 2 probes

Transport	URL	Outcome	Status	Location
streamable-http	https://openfec.caseyjhand.com/mcp	Verified	200
http (plaintext)	http://openfec.caseyjhand.com/mcp	HTTPS enforced	301	https://openfec.caseyjhand.com/mcp

MCP tools — 12 exposed · ~5,589 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens

openfec_get_committee_totals Openfec Get Committee Totals ~652

Get pre-aggregated committee financial totals — receipts, disbursements, cash on hand, debts, and the itemized/unitemized breakdown — without paginating Schedule A. Use mode "single" (the default) with a committee_id for one committee's totals, one row per two-year cycle it has filed. Use mode "by_entity_type" to rank or screen every committee of one type (presidential, pac, party, pac-party, house-senate, ie-only) by state, designation, or a receipts/disbursements threshold.

Input Output Examples

Name	Type	Req	Description
committee_designation	string	—	Committee designation — A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). by_entity_type mode only.
committee_id	string	—	Committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required in single mode; in by_entity_type mode it narrows the grouped search to that one committee.
committee_state	string	—	Two-letter state code of the committee. by_entity_type mode only.
committee_type	string	—	Committee type code — H (House), S (Senate), P (Presidential), O (Super PAC), N/Q (PAC), X/Y (party). by_entity_type mode only.
cycle	number	—	Two-year election cycle (e.g., 2024). Even years only. Omit in single mode to get every cycle the committee has filed.
entity_type	string	—	Committee entity type for the grouped search. Required in by_entity_type mode. house-senate covers both chambers as one group; ie-only is committees that report only independent expenditures.
max_disbursements	number	—	Maximum total disbursements in dollars. by_entity_type mode only.
max_receipts	number	—	Maximum total receipts in dollars. by_entity_type mode only.
min_disbursements	number	—	Minimum total disbursements in dollars. by_entity_type mode only.
min_receipts	number	—	Minimum total receipts in dollars. by_entity_type mode only.
mode	string	—	Query mode. "single" returns one committee's totals, one row per cycle. "by_entity_type" returns a page of committees of one entity type, filterable and sortable across committees.
organization_type	string	—	Sponsoring organization type — C (corporation), L (labor), M (membership), T (trade), V (cooperative), W (corporation without capital stock). by_entity_type mode only.
page	integer	—	Page number (1-indexed). Read pagination.pages in the response to see how many pages exist — a long-running committee can have more cycles than one page holds.
per_page	integer	—	Results per page.
sort	string	—	Sort field. A "-" prefix sorts descending: "-receipts" ranks the biggest fundraisers first in by_entity_type mode, "-cycle" puts a committee's most recent cycle first in single mode.

Name	Type	Req	Description
mode	string	yes	Query mode as the server resolved it. Rows mean different things by mode — single rows are cycles of one committee, by_entity_type rows are different committees — so read this rather than inferring f…
notice	string	—	Guidance when no totals matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
results	array	yes	Committee totals result set; one row per cycle in single mode, one row per committee in by_entity_type mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching totals rows before pagination.

No examples provided.

openfec_get_legal_document Openfec Get Legal Document ~291

Fetch one FEC legal document in full — advisory opinion, MUR, ADR, administrative fine, or statute — by its type and number. openfec_search_legal replaces each result's documents array with a count and category summary and cuts every commission vote down to a date and a 200-character action; this returns the record untouched. doc_type is the plural form of the document_type discriminator on a search result (advisory_opinion becomes advisory_opinions, mur becomes murs, adr becomes adrs, admin_fine becomes admin_fines, statute becomes statutes), and no is that result's no field — every document type carries it, and advisory opinions repeat it as ao_no.

Input Output Examples

Name	Type	Req	Description
doc_type	string	yes	Legal document type, always plural. openfec_search_legal reports the singular form in each result document_type — advisory_opinion, mur, adr, admin_fine, statute — so add an "s" to get the value this…
no	string	yes	Document number, copied from the no field of the matching openfec_search_legal result. Advisory opinions are year-serial (e.g. "2024-01", also repeated as ao_no); murs, adrs, and admin_fines are digi…

Name	Type	Req	Description
attachedDocumentCount	number	yes	Number of related filings in the record documents array. Compare against the document_count openfec_search_legal reported for the same record.
document	object	yes	The complete legal document record. Carries the full documents array that openfec_search_legal replaces with a count and category summary, and the complete commission_votes entries it reduces to a vo…
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.

No examples provided.

openfec_lookup_calendar Openfec Lookup Calendar ~399

Look up FEC calendar events, filing deadlines, and election dates. Use to find upcoming filing windows for a committee, locate when a federal election occurred, or scope FEC events by date range and category.

Input Output Examples

Name	Type	Req	Description
category	string	—	Calendar category ID. 20=Commission Meetings, 21=Reporting Deadlines, 22=Conferences and Outreach, 23=AOs and Rules, 24=Other, 25=Quarterly, 26=Monthly, 27=Pre and Post-Elections, 28=EC Periods, 29=I…
description	string	—	Full-text event description search. Events mode.
election_year	integer	—	Election year. Election dates mode.
max_date	string	—	Latest date (YYYY-MM-DD).
min_date	string	—	Earliest date (YYYY-MM-DD).
mode	string	—	events = FEC calendar events. filing_deadlines = report due dates. election_dates = upcoming/past elections.
office	string	—	Office sought (H=House, S=Senate, P=President). Election dates mode.
page	integer	—	Page number (1-indexed). Default 1.
per_page	integer	—	Results per page. Default 20, max 100.
report_type	string	—	Report type code (e.g. "Q1", "Q2"). Filing deadlines mode only.
report_year	integer	—	Report year. Filing deadlines mode.
state	string	—	Two-letter state code (e.g., AZ, CA). Primarily for election_dates mode.

Name	Type	Req	Description
mode	string	yes	Query mode as the server resolved it. Each mode reads a different FEC dataset with its own row shape — calendar events, report due dates, or election dates — so read this rather than inferring the da…
notice	string	—	Guidance when no calendar entries matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
results	array	yes	Calendar result set; events, filing deadlines, or election dates depending on mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching calendar entries before pagination.

No examples provided.

openfec_lookup_elections Openfec Lookup Elections ~296

Look up federal election races and candidate financial summaries. Find who's running in a race with fundraising totals, or get an aggregate race summary.

Input Output Examples

Name	Type	Req	Description
cycle	integer	yes	Election cycle year (even years only, e.g. 2024).
district	string	—	Two-digit district number (e.g. "07"). Required for house unless zip is provided.
election_full	boolean	—	Expand to full election period (4yr president, 6yr senate, 2yr house). Defaults to true when omitted; a ZIP-scoped search rejects it, since that endpoint has no such parameter. Carries no schema defa…
mode	string	—	search = candidates in a race with financial totals. summary = aggregate race financial summary.
office	string	yes	Office sought: H=House, S=Senate, P=President.
page	integer	—	Page number (1-indexed). Search mode only — summary mode returns a single aggregate row. Read pagination.pages in the response to see how many pages exist.
per_page	integer	—	Results per page. Search mode only.
state	string	—	Two-letter US state code (e.g., AZ, CA). Required for senate/house unless zip is provided.
zip	string	—	ZIP code — finds races covering this ZIP. Search mode only.

Name	Type	Req	Description
mode	string	yes	Query mode as the server resolved it. Row shapes differ by mode — search rows are per-candidate financial records, summary is one aggregate race row — so read this rather than inferring the shape fro…
notice	string	—	Guidance when no election results matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
results	array	yes	Election race result set; candidate financial rows in search mode, a single aggregate summary row in summary mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching candidates or race summaries.

No examples provided.

openfec_search_candidates Openfec Search Candidates ~359

Find federal candidates by name, state, office, party, or cycle. Retrieve a specific candidate by FEC ID with financial totals. Candidate IDs start with H (House), S (Senate), or P (President) followed by digits.

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	FEC candidate ID (e.g., P00003392, H2CO07170). Get IDs from openfec_search_candidates results. When provided, returns a single candidate with full detail.
candidate_status	string	—	Candidate status: C=present, F=future, N=not yet, P=prior.
cycle	number	—	Two-year election cycle (even year, e.g., 2024).
district	string	—	Two-digit district number for House candidates.
election_year	number	—	Specific election year the candidate ran in.
has_raised_funds	boolean	—	Only candidates whose committee has received receipts.
include_totals	boolean	—	Include financial totals (receipts, disbursements, cash on hand). Defaults to true when fetching by candidate_id.
incumbent_challenge	string	—	Incumbent status: I=incumbent, C=challenger, O=open seat.
office	string	—	Filter by office: H=House, S=Senate, P=President.
page	integer	—	Page number (1-indexed).
party	string	—	Three-letter party code (e.g., DEM, REP, LIB).
per_page	integer	—	Results per page.
query	string	—	Full-text candidate name search.
state	string	—	Two-letter US state code (e.g., AZ, CA).

Name	Type	Req	Description
candidates	array	yes	Candidate result set; one record per match.
missing_totals	array	—	Candidates whose financial totals were not retrieved because the totals fetch hit its page cap. Re-query each one on its own with candidate_id to get its totals.
notice	string	—	Guidance when no candidates matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching candidates before pagination.
totals	array	—	Financial totals (receipts, disbursements, cash_on_hand) when include_totals is true. One row per candidate per cycle.

No examples provided.

openfec_search_committees Openfec Search Committees ~329

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).

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	Find committees linked to this candidate (authorized, leadership, joint fundraising). Get IDs from openfec_search_candidates results.
committee_id	string	—	FEC committee ID (e.g., C00358796). Get IDs from openfec_search_committees results. Starts with 'C' followed by digits. Returns a single committee with full detail.
committee_type	string	—	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).
cycle	number	—	Two-year election cycle (even year).
designation	string	—	Committee designation. A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized).
page	integer	—	Page number (1-indexed).
party	string	—	Three-letter party code (e.g., DEM, REP).
per_page	integer	—	Results per page.
query	string	—	Full-text committee name search.
state	string	—	Two-letter state code.
treasurer_name	string	—	Full-text treasurer name search.

Name	Type	Req	Description
committees	array	yes	Committee result set; one record per match.
notice	string	—	Guidance when no committees matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching committees before pagination.

No examples provided.

openfec_search_contributions Openfec Search Contributions ~604

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.

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	Candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results. Enables by_size and by_state aggregates without a committee_id.
committee_id	string	—	Receiving committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.
contributor_city	string	—	Contributor city. Itemized only.
contributor_employer	string	—	Full-text employer search. Itemized only.
contributor_name	string	—	Full-text donor name search. Itemized only.
contributor_occupation	string	—	Full-text occupation search. Itemized only.
contributor_state	string	—	Two-letter state code (e.g., CA). Itemized only.
contributor_zip	string	—	ZIP code prefix (starts-with match). Itemized only.
cursor	string	—	Opaque pagination cursor from a previous response of this tool. Itemized mode only (keyset pagination). Valid only for an otherwise-identical call — changing any other argument, including sort, rejec…
cycle	number	—	Two-year election cycle (e.g., 2024). Even years only. Defaults to current cycle for itemized mode.
is_individual	boolean	—	Only individual contributions (excludes committee-to-committee transfers). Itemized only.
max_amount	number	—	Maximum contribution amount in dollars. Itemized only.
max_date	string	—	Latest contribution date (YYYY-MM-DD). Itemized only.
min_amount	number	—	Minimum contribution amount in dollars. Itemized only.
min_date	string	—	Earliest contribution date (YYYY-MM-DD). Itemized only.
mode	string	—	Query mode. "itemized" returns individual contribution records (keyset pagination). "by_size" aggregates by contribution size bucket. "by_state" aggregates by contributor state. "by_employer" aggrega…
page	integer	—	Page number (1-indexed) for the aggregate modes. Ignored in itemized mode, which paginates with cursor. Read pagination.pages in the response to see how many pages exist.
per_page	integer	—	Results per page.
sort	string	—	Sort field. A "-" prefix sorts descending: use "-contribution_receipt_amount" for the largest receipts first, since the ascending form leads with the most negative rows (refunds, reattributions, rede…

Name	Type	Req	Description
committee	object	—	The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own co…
count	number	—	Total result count (may be approximate for itemized).
mode	string	yes	Query mode as the server resolved it. "by_size" and "by_state" resolve to "by_size_candidate" / "by_state_candidate" when scoped by candidate_id — a different endpoint with different row shapes — so…
next_cursor	—	—	Pagination cursor for the next page of itemized results. Null when no more pages.
notice	string	—	Guidance when no contributions matched — echoes filters and suggests how to broaden.
pagination	object	—	Page-based pagination info (aggregate modes only).
results	array	yes	Contribution result set; itemized records or aggregate buckets depending on mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching contributions or aggregate rows.

No examples provided.

openfec_search_coordinated_expenditures Openfec Search Coordinated Expenditures ~389

Search coordinated party expenditures (Schedule F) — spending a party committee makes on behalf of a candidate it supports, in coordination with that campaign. Distinct from independent expenditures (openfec_search_expenditures), which cannot be coordinated with the candidate, and from direct contributions: coordinated expenditures carry their own statutory limits and can run into tens of millions per party in a presidential cycle. Scope with a spending committee_id, a benefiting candidate_id, or a cycle; unscoped queries span all years.

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	Benefiting candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
committee_id	string	—	Spending party committee ID (e.g., C00003418). Get IDs from openfec_search_committees results — party committees carry committee_type X or Y.
cycle	number	—	Two-year election cycle (e.g., 2024). Even years only. Omitting it searches every cycle on record.
max_amount	number	—	Maximum expenditure amount in dollars.
max_date	string	—	Latest expenditure date (YYYY-MM-DD).
min_amount	number	—	Minimum expenditure amount in dollars.
min_date	string	—	Earliest expenditure date (YYYY-MM-DD).
page	integer	—	Page number (1-indexed). Read pagination.pages in the response to see how many pages exist.
payee_name	string	—	Full-text payee name search (the vendor the party paid).
per_page	integer	—	Results per page.
sort	string	—	Sort field. A "-" prefix sorts descending: use "-expenditure_amount" for the largest coordinated spending first, since the ascending form leads with the most negative rows (corrections and voided ent…

Name	Type	Req	Description
committee	object	—	The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own co…
notice	string	—	Guidance when no coordinated expenditures matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
results	array	yes	Coordinated expenditure result set; one record per itemized transaction.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching coordinated expenditures before pagination.

No examples provided.

openfec_search_disbursements Openfec Search Disbursements ~587

Search itemized committee spending (Schedule B) or get aggregate breakdowns by purpose or recipient. All modes require a committee_id. Use to answer "what is this committee spending money on?" or "who is receiving payments from this committee?"

Input Output Examples

Name	Type	Req	Description
committee_id	string	yes	Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required for all modes.
cursor	string	—	Opaque pagination cursor from a previous response of this tool. Itemized mode only (keyset pagination). Valid only for an otherwise-identical call — changing any other argument, including sort, rejec…
cycle	number	—	Two-year election cycle (e.g., 2024). Even years only. Itemized mode defaults to the current cycle when omitted — Schedule B spans all history, and an all-history scan of an active committee times ou…
disbursement_description	string	—	Full-text description search (e.g., "media buy", "consulting"). Itemized only.
disbursement_purpose_category	string	—	Purpose category code. Itemized only.
max_amount	number	—	Maximum amount in dollars. Itemized only.
max_date	string	—	Latest disbursement date (YYYY-MM-DD). Itemized only.
min_amount	number	—	Minimum amount in dollars. Itemized only.
min_date	string	—	Earliest disbursement date (YYYY-MM-DD). Itemized only.
mode	string	—	Query mode. "itemized" returns individual disbursement records (keyset pagination). "by_purpose" aggregates by purpose category. "by_recipient" aggregates by recipient name. "by_recipient_id" aggrega…
page	integer	—	Page number (1-indexed) for the aggregate modes. Ignored in itemized mode, which paginates with cursor. Read pagination.pages in the response to see how many pages exist.
per_page	integer	—	Results per page.
recipient_city	string	—	Recipient city. Itemized only.
recipient_committee_id	string	—	Recipient committee ID (for committee-to-committee transfers). Itemized only.
recipient_name	string	—	Full-text payee name search. Itemized only.
recipient_state	string	—	Recipient state. Itemized only.
sort	string	—	Sort field. A "-" prefix sorts descending: use "-disbursement_amount" for the biggest payments first, since the ascending form leads with the most negative rows (refunds and voided payments). Itemize…

Name	Type	Req	Description
committee	object	—	The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own co…
count	number	—	Total result count (may be approximate for itemized).
mode	string	yes	Query mode as the server resolved it. Row shapes differ by mode — itemized rows are individual payments, aggregate rows are buckets with a total — so read this rather than inferring the shape from th…
next_cursor	—	—	Pagination cursor for the next page of itemized results. Null when no more pages.
notice	string	—	Guidance when no disbursements matched — echoes filters and suggests how to broaden.
pagination	object	—	Page-based pagination info (aggregate modes only).
results	array	yes	Disbursement result set; itemized records or aggregate buckets depending on mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching disbursements or aggregate rows.

No examples provided.

openfec_search_expenditures Openfec Search Expenditures ~835

Search independent expenditures (Schedule E) — outside spending supporting or opposing federal candidates. Covers Super PACs, party committees, and other groups. Use itemized mode for individual expenditure records, or by_candidate for aggregated totals per candidate; by_candidate needs either a candidate_id or a full race scope (candidate_office alone for President, plus candidate_office_state for Senate, plus candidate_office_district as well for House).

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	Targeted candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
candidate_office	string	—	Office of the targeted candidate: H=House, S=Senate, P=President. In by_candidate mode this scopes a whole race: P stands alone, S also needs candidate_office_state, H also needs candidate_office_sta…
candidate_office_district	string	—	Two-digit House district of the targeted race (e.g., "09"). Required alongside candidate_office=H and candidate_office_state in by_candidate mode; Senate and presidential rows carry no district and m…
candidate_office_state	string	—	Two-letter state code of the targeted race. Required alongside candidate_office=H or candidate_office=S in by_candidate mode; leave it off for candidate_office=P, whose aggregate rows carry no state…
candidate_party	string	—	Three-letter party code of the targeted candidate (e.g., DEM, REP). Itemized only — by_candidate rejects it, since the aggregate endpoint has no party filter.
committee_id	string	—	Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.
cursor	string	—	Opaque pagination cursor from a previous response of this tool. Itemized mode only (keyset pagination). Valid only for an otherwise-identical call — changing any other argument, including sort, rejec…
cycle	number	—	Two-year election cycle (e.g., 2024). Even years only. Itemized mode defaults to the current cycle when omitted — Schedule E spans all history and an unscoped scan times out upstream. Pass an explici…
is_notice	boolean	—	Only 24/48-hour notice filings (near-election spending). Itemized only.
max_amount	number	—	Maximum expenditure amount in dollars. Itemized only.
max_date	string	—	Latest expenditure date (YYYY-MM-DD). Itemized only.
min_amount	number	—	Minimum expenditure amount in dollars. Itemized only.
min_date	string	—	Earliest expenditure date (YYYY-MM-DD). Itemized only.
mode	string	—	Query mode. "itemized" returns individual expenditure records (keyset pagination). "by_candidate" returns aggregated totals per candidate by committee (page-based).
most_recent	boolean	—	Only the most recent version of amended filings. Itemized only — by_candidate rejects it. Defaults to true in itemized mode when omitted; pass false to see superseded versions of amended filings.
page	integer	—	Page number (1-indexed) for by_candidate mode. Ignored in itemized mode, which paginates with cursor. Read pagination.pages in the response to see how many pages exist.
payee_name	string	—	Full-text payee name search. Itemized only.
per_page	integer	—	Results per page.
sort	string	—	Sort field. A "-" prefix sorts descending: use "-expenditure_amount" for the largest outside spending first, since the ascending form leads with the most negative rows (corrections and voided entries…
support_oppose	string	—	S = support, O = oppose. Filter by whether the expenditure supports or opposes the candidate.

Name	Type	Req	Description
committee	object	—	The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own co…
count	number	—	Total result count (may be approximate for itemized).
mode	string	yes	Query mode as the server resolved it. Row shapes differ by mode — itemized rows are individual expenditures, by_candidate rows are per-candidate totals — so read this rather than inferring the shape…
next_cursor	—	—	Pagination cursor for the next page of itemized results. Null when no more pages.
notice	string	—	Guidance when no expenditures matched — echoes filters and suggests how to broaden.
pagination	object	—	Page-based pagination info (by_candidate mode only).
results	array	yes	Expenditure result set; itemized records or per-candidate aggregates depending on mode.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching expenditures or per-candidate aggregates.

No examples provided.

openfec_search_filings Openfec Search Filings ~380

Search FEC filings and reports by committee, candidate, form type, or date range. Covers financial reports (F3/F3P/F3X), statements of candidacy (F2), organizational filings (F1), 24-hour IE notices (F24), and amendments.

Input Output Examples

Name	Type	Req	Description
candidate_id	string	—	Associated candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
committee_id	string	—	Filing committee ID (e.g., C00358796). Get IDs from openfec_search_committees results.
cycle	number	—	Two-year election cycle (even year).
filer_name	string	—	Full-text filer name search.
form_type	string	—	FEC form type. Common: F3 (House/Senate quarterly), F3P (Presidential), F3X (PAC/party), F24 (24-hour IE notice), F1 (statement of organization), F2 (statement of candidacy), F5 (IE by persons).
is_amended	boolean	—	Filter to original or amended filings only.
max_receipt_date	string	—	Latest FEC receipt date (YYYY-MM-DD).
min_receipt_date	string	—	Earliest date FEC received the filing (YYYY-MM-DD).
most_recent	boolean	—	Only the most recent version (filters out superseded amendments).
page	integer	—	Page number (1-indexed).
per_page	integer	—	Results per page.
report_type	string	—	Report type code. Common: Q1/Q2/Q3 (quarterly), YE (year-end), M3-M12 (monthly), 12G/12P/30G (pre/post election).
report_year	number	—	Filing year.

Name	Type	Req	Description
notice	string	—	Guidance when no filings matched — echoes filters and suggests how to broaden.
pagination	object	yes	Page-based pagination metadata.
results	array	yes	Filing result set; one record per match.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching filings before pagination.

No examples provided.

openfec_search_legal Openfec Search Legal ~468

Search FEC legal documents: advisory opinions, enforcement cases (MURs), alternative dispute resolutions, and administrative fines.

Input Output Examples

Name	Type	Req	Description
ao_number	string	—	Specific advisory opinion number (e.g. "2024-01").
case_number	string	—	Specific MUR or ADR case number.
date_kind	string	—	Which date min_date/max_date bound. Each document type records its own dates, so this must be one the chosen type has: type=advisory_opinions → issue_date (opinion issued), request_date (request rece…
from_hit	integer	—	Offset for pagination (0-indexed). Default 0.
hits_returned	integer	—	Results per page. Default 20, max 200.
max_date	string	—	Latest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.
max_penalty_amount	number	—	Maximum penalty amount in dollars. Filters enforcement cases (murs, adrs) only — other document types are returned unfiltered by it.
min_date	string	—	Earliest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.
min_penalty_amount	number	—	Minimum penalty amount in dollars. Filters enforcement cases (murs, adrs) only — other document types are returned unfiltered by it.
query	string	—	Full-text search across legal documents.
regulatory_citation	string	—	CFR citation (e.g. "11 CFR 112.4").
respondent	string	—	Respondent name (enforcement cases).
statutory_citation	string	—	U.S.C. citation (e.g. "52 U.S.C. 30106").
type	string	—	Document type filter. Omit to search all types. admin_fines is slow without a query or respondent filter.

Name	Type	Req	Description
notice	string	—	Guidance when no legal documents matched — echoes filters and suggests how to broaden.
results	array	yes	Legal document result set spanning advisory opinions, MURs, ADRs, admin fines, and statutes.
retrievalHint	string	—	How to recover the material trimmed out of these results. Present whenever any result was returned, because every result is trimmed.
search_criteria	object	yes	Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.
totalCount	number	yes	Total matching legal documents across all types.
total_count	number	yes	Total matching documents across all types.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

26 Jul 3 Aug

Day	Score
26 Jul	65
27 Jul	66
28 Jul	66
29 Jul	67
30 Jul	68
31 Jul	69
1 Aug	69
2 Aug	70
3 Aug	70