{"report":{"v":1,"package":"@cyanheads/openfec-mcp-server","version":"0.11.0","ranAt":"2026-11-16T11:51:14.123Z","install":{"ok":true,"integrity":"sha512-2+z2r0KELt1sp/Timml9IX3D8jHDMXIySOSBlpwSl0tfGB4eHYO3V+3MdVC4QdZOZUcRzXmtdI0dbwPc9Ab+hQ==","deps":36,"scripts":[],"bins":["openfec-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/openfec-mcp-server.git","bin":"openfec-mcp-server"},"start":{"ok":true,"ms":490,"serverName":"openfec-mcp-server","serverVersion":"0.11.0","protocol":"2025-06-18","stderr":"tools/utils/toolHandlerFactory.js:79:26\",\"jsonRpcId\":6,\"toolName\":\"openfec_search_contributions\",\"msg\":\"Error in tool:openfec_search_contributions: Itemized mode invoked without committee_id, contributor_id, contributor_name, or contributor_employer\"}\n{\"level\":20,\"time\":1794829887607,\"env\":\"development\",\"version\":\"0.11.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"K351Y-V9XA9\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:27.605Z\",\"jsonRpcId\":7,\"toolName\":\"openfec_search_expenditures\",\"msg\":\"Attempting fetch GET https://api.open.fec.gov/…?… with 30000ms timeout.\"}\n{\"level\":20,\"time\":1794829892685,\"env\":\"development\",\"version\":\"0.11.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"K351Y-V9XA9\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:27.605Z\",\"jsonRpcId\":7,\"toolName\":\"openfec_search_expenditures\",\"msg\":\"Successfully fetched https://api.open.fec.gov/…?…. Status: 200\"}\n{\"level\":30,\"time\":1794829892688,\"env\":\"development\",\"version\":\"0.11.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"K351Y-V9XA9\",\"tenantId\":\"default\",\"timestamp\":\"2026-11-16T11:51:27.605Z\",\"jsonRpcId\":7,\"toolName\":\"openfec_search_expenditures\",\"cycle\":2026,\"count\":78590,\"returned\":20,\"msg\":\"Itemized expenditures fetched\"}\n{\"level\":30,\"time\":1794829892695,\"env\":\"development\",\"version\":\"0.11.0\",\"pid\":59,\"operation\":\"HandleToolRequest\",\"requestId\":\"K351Y-V9XA9\",\"timestamp\":\"2026-11-16T11:51:27.605Z\",\"jsonRpcId\":7,\"toolName\":\"openfec_search_expenditures\",\"metrics\":{\"durationMs\":5087.95,\"isSuccess\":true,\"inputBytes\":33,\"outputBytes\":37037},\"msg\":\"Tool execution finished.\"}\n"},"tools":[{"name":"openfec_search_candidates","description":"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 exactly eight letters or digits.","params":["query","candidate_id","state","district","office","party","cycle","election_year","incumbent_challenge","candidate_status","has_raised_funds","include_totals","page","per_page"]},{"name":"openfec_search_committees","description":"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 exactly eight digits (e.g., C00358796).","params":["query","committee_id","candidate_id","state","party","committee_type","designation","cycle","treasurer_name","page","per_page"]},{"name":"openfec_get_committee_totals","description":"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.","params":["mode","committee_id","entity_type","cycle","committee_state","committee_type","committee_designation","organization_type","min_receipts","max_receipts","min_disbursements","max_disbursements","sort","page","per_page"]},{"name":"openfec_search_contributions","description":"Search itemized contributions (Schedule A) or get aggregate breakdowns by size, state, employer, or occupation. Use to answer \"who is funding this committee?\" or \"where has this donor given?\" Itemized mode needs a recipient committee_id or a donor: contributor_id, contributor_name, or contributor_employer. Aggregate by_size/by_state can use candidate_id instead of committee_id.","params":["mode","committee_id","candidate_id","contributor_id","contributor_name","contributor_employer","contributor_occupation","contributor_city","contributor_state","contributor_zip","cycle","min_date","max_date","min_amount","max_amount","is_individual","sort","page","per_page","cursor"]},{"name":"openfec_search_disbursements","description":"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?\"","params":["mode","committee_id","recipient_name","recipient_state","recipient_city","recipient_committee_id","disbursement_description","disbursement_purpose_category","cycle","min_date","max_date","min_amount","max_amount","sort","page","per_page","cursor"]},{"name":"openfec_search_expenditures","description":"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).","params":["mode","committee_id","candidate_id","support_oppose","payee_name","candidate_office","candidate_office_state","candidate_office_district","candidate_party","cycle","min_date","max_date","min_amount","max_amount","is_notice","most_recent","election_full","sort","page","per_page","cursor"]},{"name":"openfec_search_coordinated_expenditures","description":"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.","params":["committee_id","candidate_id","cycle","payee_name","min_date","max_date","min_amount","max_amount","sort","page","per_page"]},{"name":"openfec_search_filings","description":"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.","params":["committee_id","candidate_id","filer_name","form_type","report_type","report_year","cycle","is_amended","most_recent","min_receipt_date","max_receipt_date","page","per_page"]},{"name":"openfec_lookup_elections","description":"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.","params":["mode","office","cycle","state","district","zip","election_full","page","per_page"]},{"name":"openfec_search_legal","description":"Search FEC legal documents: advisory opinions, enforcement cases (MURs), alternative dispute resolutions, administrative fines, and statutes. The citation, penalty, respondent, ao_number, and case_number filters each apply to only some document types; with type omitted, the search returns only the types every one of them applies to. A page carries every result upstream returns, up to hits_returned of each document type searched; the next page starts at from_hit + hits_returned.","params":["query","type","ao_number","case_number","respondent","regulatory_citation","statutory_citation","min_penalty_amount","max_penalty_amount","date_kind","min_date","max_date","from_hit","hits_returned"]},{"name":"openfec_get_legal_document","description":"Fetch one FEC legal document — advisory opinion, MUR, ADR, administrative fine, or statute — by its type and number. openfec_search_legal replaces each result's documents and dispositions arrays with a count and category summary and cuts every commission vote down to a date and a 200-character action; this returns the record as upstream sends it, with every link made absolute, whole when it fits the 100,000-byte response budget. A larger record returns its scalar fields and the arrays that fit, with the rest listed in withheld; page through one by re-calling with array and offset. 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.","params":["doc_type","no","array","offset"]},{"name":"openfec_lookup_calendar","description":"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.","params":["mode","state","office","district","report_type","report_year","category","election_year","description","min_date","max_date","page","per_page"]}],"toolsHash":"0689da91cff3888369377297258e7923b8751dca38847381e222964673ad4969","wrote":[],"callsAt":"2026-11-16T11:51:26.101Z","calls":[{"tool":"openfec_search_candidates","ok":true,"ms":354,"bytes":10746},{"tool":"openfec_search_committees","ok":true,"ms":136,"bytes":10555},{"tool":"openfec_get_committee_totals","ok":false,"ms":7,"bytes":0,"error":"tool reported an error: Error: Mode single invoked without a committee_id\n\nRecovery: Pass the committee_id whose totals you want (find one with openfec_search_committees), or switch to mode by_entity_type with an entity_type"},{"tool":"openfec_search_contributions","ok":false,"ms":5,"bytes":0,"error":"tool reported an error: Error: Itemized mode invoked without committee_id, contributor_id, contributor_name, or contributor_employer\n\nRecovery: Provide the recipient committee_id or a donor scope (contributor_id, contributor"},{"tool":"openfec_search_expenditures","ok":true,"ms":5093,"bytes":36689}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":["api.open.fec.gov"],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":12,"wrote":0,"callsTried":5,"callsAnswered":3,"callContacts":["api.open.fec.gov"]},"history":[{"package":"@cyanheads/openfec-mcp-server","version":"0.11.0","ranAt":"2026-11-16T11:51:14.123Z","outcome":"started","tools":12,"contacts":0,"flags":0,"serious":0,"toolsHash":"0689da91cff3888369377297258e7923b8751dca38847381e222964673ad4969"},{"package":"@cyanheads/openfec-mcp-server","version":"0.10.1","ranAt":"2026-11-12T18:01:41.295Z","outcome":"started","tools":12,"contacts":0,"flags":0,"serious":0,"toolsHash":"8121b5730bd86283b1cb69e370e02c6970aecb49a02634df5e425f5a4473e8ce"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/openfec-mcp-server"}