Tools

Twelve tools for querying federal election campaign finance data:

openfec_search_candidates

Find federal candidates with optional financial totals.

• Full-text name search plus filters for state, district, office, party, cycle, incumbent status
• Fetch a specific candidate by FEC ID (H/S/P prefix) with full detail
• Optional financial totals: receipts, disbursements, cash on hand
• Pagination up to 100 results per page

openfec_search_committees

Find political committees (campaign, PAC, Super PAC, party).

• Full-text name search plus filters for type, designation, party, state, candidate affiliation
• Fetch a specific committee by FEC ID (C prefix)
• Committee types: House, Senate, Presidential, Super PAC, PAC, Party
• Treasurer name search

openfec_get_committee_totals

Pre-aggregated committee finances, without paginating Schedule A.

• single: One committee's totals, one row per two-year cycle it filed
• by_entity_type: Every committee of one type — presidential, pac, party, pac-party, house-senate, ie-only
• Receipts, disbursements, cash on hand, debts, and the itemized/unitemized contribution split
• Grouped mode filters by state, committee type, designation, organization type, and receipts/disbursements thresholds

openfec_search_contributions

Search Schedule A contribution data with five query modes.

• itemized: Individual contribution records with keyset cursor pagination
• by_size: Aggregate breakdowns by contribution size range
• by_state: Geographic breakdown of contributions
• by_employer: Top employer aggregates
• by_occupation: Top occupation aggregates
• Filters: donor name, employer, occupation, city, state, ZIP, date range, amount range

openfec_search_disbursements

Search Schedule B spending data with four query modes.

• itemized: Individual disbursement records with keyset cursor pagination
• by_purpose: Aggregate by spending purpose category
• by_recipient: Aggregate by payee name
• by_recipient_id: Aggregate by recipient committee ID
• Filters: recipient name, description, date range, amount range

openfec_search_expenditures

Search Schedule E independent expenditure data.

• itemized: Individual expenditure records with support/oppose indicator; scoped to the current cycle unless another is given
• by_candidate: Aggregated totals per targeted candidate, scoped by candidate ID or by a whole race (office alone for President, plus state for Senate, plus district as well for House)
• Filters: committee, candidate, office, party, 24/48-hour notices, date and amount range

openfec_search_coordinated_expenditures

Search Schedule F coordinated party expenditures.

• Party committee spending made on behalf of a candidate, in coordination with that campaign — a separate legal category from independent expenditures and from direct contributions
• Filters: spending committee, benefiting candidate, cycle, payee name, date range, amount range
• Page-based pagination; the shared spending committee is hoisted out of the rows when the query names one

openfec_search_filings

Search FEC filings and reports.

• Form types: F3 (House/Senate quarterly), F3P (Presidential), F3X (PAC/party), F24 (24-hour IE notice), F1/F2 (organizational/candidacy), F5 (IE by persons)
• Report type codes: Q1/Q2/Q3, YE, monthly, pre/post election
• Amendment filtering with most-recent-only option
• Date range filtering by FEC receipt date

openfec_search_legal

Search across FEC legal document types.

• Advisory opinions, MURs (enforcement cases), ADRs, administrative fines, statutes
• Look up specific cases by AO number or case number
• Filter by respondent, regulatory/statutory citation, penalty amount range
• Date filtering is type-scoped: pick a date_kind the document type records (advisory opinions issue/request/document, cases open/close/document, admin fines RTB/final determination)
• Offset-based pagination (up to 200 results per page)

openfec_get_legal_document

Fetch one legal document in full by type and number.

• Returns the full documents array that openfec_search_legal replaces with a count and category summary, and the complete commission_votes it cuts down to a date and a truncated action
• doc_type is the plural of a search result's document_type (mur → murs); no is that result's no field, which every document type carries
• Reports how many related filings the record carries, so it can be checked against the search result's document_count

openfec_lookup_elections

Look up federal election races.

• search: Candidates in a race with financial totals
• summary: Aggregate race financial summary
• Office types: H (House), S (Senate), P (President)
• ZIP code lookup to find races covering a location
• Full election period expansion (4yr president, 6yr senate, 2yr house)

openfec_lookup_calendar

Look up FEC dates and deadlines.

• events: FEC calendar events
• filing_deadlines: Report due dates by type and year
• election_dates: Upcoming and past election dates by state and office
• Date range filtering

Resources

Prompts