io.github.cyanheads/openfec-mcp-server

Official12 toolsLive

by cyanheads · TypeScript

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

io.github.cyanheads/openfec-mcp-server — MCP Server for FEC Data

This Model Context Protocol (MCP) server provides access to U.S. Federal Election Commission (FEC) campaign finance information. It supports queries for candidates, money trails, and election filings, using STDIO and Streamable HTTP for tool communication. It is delivered as the @cyanheads/openfec-mcp-server package.

🛠️ Key Features

Access FEC campaign finance data
Query candidates, money trails, and election filings
MCP transport via STDIO and Streamable HTTP
12 tools available

🚀 Use Cases

Retrieve candidate-related campaign finance data
Follow and query contribution “money trails”
Look up election filing information from FEC sources

⚡ Developer Benefits

Integrates with MCP workflows
Supports multiple interfaces (STDIO and Streamable HTTP)
Includes tool coverage for the specified FEC domains (12 tools)

⚠️ Limitations

Scope is limited to FEC campaign finance data (candidates, money trails, election filings)
Operates via STDIO and Streamable HTTP only

Topics

campaign-financeelectionsfecmcpmcp-servermodel-context-protocolopenfecfederal-electionspolitical-contributionsai-agenttypescriptcyanheads

Captured live from the server via tools/list.

openfec_search_candidates

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.

Parameters14

query	string	optional	Full-text candidate name search.
candidate_id	string	optional	FEC candidate ID: H, S, or P followed by exactly eight letters or digits (e.g., P00003392, H2CO07170). Get IDs from openfec_search_candidates results. When provided, returns a single candidate with full detail.
state	string	optional	Two-letter US state code (e.g., AZ, CA).
district	string	optional	Two-digit district number for House candidates.
office	string	optional	Filter by office: H=House, S=Senate, P=President.
party	string	optional	Three-letter party code (e.g., DEM, REP, LIB).
cycle	number	optional	Two-year election cycle (even year, e.g., 2024).
election_year	number	optional	Specific election year the candidate ran in.
incumbent_challenge	string	optional	Incumbent status: I=incumbent, C=challenger, O=open seat.
candidate_status	string	optional	Candidate status: C=present, F=future, N=not yet, P=prior.
has_raised_funds	boolean	optional	Only candidates whose committee has received receipts.
include_totals	boolean	optional	Include financial totals (receipts, disbursements, cash on hand). Defaults to true when fetching by candidate_id.
page	integer	optional	Search-results page number (1-indexed). Defaults to 1 on the search path.
per_page	integer	optional	Search results per page. Defaults to 20 on the search path. With include_totals, at most 35 candidates are requested when cycle or election_year scopes the totals and 5 when the totals span every cycle, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text candidate name search.",
      "type": "string"
    },
    "candidate_id": {
      "description": "FEC candidate ID: H, S, or P followed by exactly eight letters or digits (e.g., P00003392, H2CO07170). Get IDs from openfec_search_candidates results. When provided, returns a single candidate with full detail.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter US state code (e.g., AZ, CA).",
      "type": "string"
    },
    "district": {
      "description": "Two-digit district number for House candidates.",
      "type": "string"
    },
    "office": {
      "description": "Filter by office: H=House, S=Senate, P=President.",
      "type": "string",
      "enum": [
        "H",
        "S",
        "P"
      ]
    },
    "party": {
      "description": "Three-letter party code (e.g., DEM, REP, LIB).",
      "type": "string"
    },
    "cycle": {
      "description": "Two-year election cycle (even year, e.g., 2024).",
      "type": "number"
    },
    "election_year": {
      "description": "Specific election year the candidate ran in.",
      "type": "number"
    },
    "incumbent_challenge": {
      "description": "Incumbent status: I=incumbent, C=challenger, O=open seat.",
      "type": "string",
      "enum": [
        "I",
        "C",
        "O"
      ]
    },
    "candidate_status": {
      "description": "Candidate status: C=present, F=future, N=not yet, P=prior.",
      "type": "string",
      "enum": [
        "C",
        "F",
        "N",
        "P"
      ]
    },
    "has_raised_funds": {
      "description": "Only candidates whose committee has received receipts.",
      "type": "boolean"
    },
    "include_totals": {
      "description": "Include financial totals (receipts, disbursements, cash on hand). Defaults to true when fetching by candidate_id.",
      "type": "boolean"
    },
    "page": {
      "description": "Search-results page number (1-indexed). Defaults to 1 on the search path.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Search results per page. Defaults to 20 on the search path. With include_totals, at most 35 candidates are requested when cycle or election_year scopes the totals and 5 when the totals span every cycle, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_committees

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

Parameters11

query	string	optional	Full-text committee name search.
committee_id	string	optional	FEC committee ID: 'C' followed by exactly eight digits (e.g., C00358796). Get IDs from openfec_search_committees results. Returns a single committee with full detail.
candidate_id	string	optional	Find committees linked to this candidate (authorized, leadership, joint fundraising). Get IDs from openfec_search_candidates results.
state	string	optional	Two-letter state code.
party	string	optional	Three-letter party code (e.g., DEM, REP).
committee_type	string	optional	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).
designation	string	optional	Committee designation. A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). Matches each committee's current designation only, even with cycle set — a past principal committee since redesignated drops out of P. For a candidate's principal committee in a given cycle, use openfec_lookup_elections (mode: search) and read candidate_pcc_id.
cycle	number	optional	Two-year election cycle (even year).
treasurer_name	string	optional	Full-text treasurer name search.
page	integer	optional	Search-results page number (1-indexed). Defaults to 1 on the search path.
per_page	integer	optional	Search results per page. Defaults to 20 on the search path.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text committee name search.",
      "type": "string"
    },
    "committee_id": {
      "description": "FEC committee ID: 'C' followed by exactly eight digits (e.g., C00358796). Get IDs from openfec_search_committees results. Returns a single committee with full detail.",
      "type": "string"
    },
    "candidate_id": {
      "description": "Find committees linked to this candidate (authorized, leadership, joint fundraising). Get IDs from openfec_search_candidates results.",
      "type": "string"
    },
    "state": {
      "description": "Two-letter state code.",
      "type": "string"
    },
    "party": {
      "description": "Three-letter party code (e.g., DEM, REP).",
      "type": "string"
    },
    "committee_type": {
      "description": "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).",
      "type": "string"
    },
    "designation": {
      "description": "Committee designation. A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). Matches each committee's current designation only, even with cycle set — a past principal committee since redesignated drops out of P. For a candidate's principal committee in a given cycle, use openfec_lookup_elections (mode: search) and read candidate_pcc_id.",
      "type": "string"
    },
    "cycle": {
      "description": "Two-year election cycle (even year).",
      "type": "number"
    },
    "treasurer_name": {
      "description": "Full-text treasurer name search.",
      "type": "string"
    },
    "page": {
      "description": "Search-results page number (1-indexed). Defaults to 1 on the search path.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Search results per page. Defaults to 20 on the search path.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_get_committee_totals

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.

Parameters15

mode	string	optional	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.
committee_id	string	optional	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.
entity_type	string	optional	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.
cycle	number	optional	Two-year election cycle (e.g., 2024). Even years only. Omit in single mode to get every cycle the committee has filed.
committee_state	string	optional	Two-letter state code of the committee. by_entity_type mode only.
committee_type	string	optional	Committee type code — H (House), S (Senate), P (Presidential), O (Super PAC), N/Q (PAC), X/Y (party). by_entity_type mode only.
committee_designation	string	optional	Committee designation — A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). by_entity_type mode only.
organization_type	string	optional	Sponsoring organization type — C (corporation), L (labor), M (membership), T (trade), V (cooperative), W (corporation without capital stock). by_entity_type mode only.
min_receipts	number	optional	Minimum total receipts in dollars. by_entity_type mode only.
max_receipts	number	optional	Maximum total receipts in dollars. by_entity_type mode only.
min_disbursements	number	optional	Minimum total disbursements in dollars. by_entity_type mode only.
max_disbursements	number	optional	Maximum total disbursements in dollars. by_entity_type mode only.
sort	string	optional	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.
page	integer	optional	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	optional	Results per page.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "single",
      "description": "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.",
      "type": "string",
      "enum": [
        "single",
        "by_entity_type"
      ]
    },
    "committee_id": {
      "description": "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.",
      "type": "string"
    },
    "entity_type": {
      "description": "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.",
      "type": "string",
      "enum": [
        "presidential",
        "pac",
        "party",
        "pac-party",
        "house-senate",
        "ie-only"
      ]
    },
    "cycle": {
      "description": "Two-year election cycle (e.g., 2024). Even years only. Omit in single mode to get every cycle the committee has filed.",
      "type": "number"
    },
    "committee_state": {
      "description": "Two-letter state code of the committee. by_entity_type mode only.",
      "type": "string"
    },
    "committee_type": {
      "description": "Committee type code — H (House), S (Senate), P (Presidential), O (Super PAC), N/Q (PAC), X/Y (party). by_entity_type mode only.",
      "type": "string"
    },
    "committee_designation": {
      "description": "Committee designation — A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). by_entity_type mode only.",
      "type": "string"
    },
    "organization_type": {
      "description": "Sponsoring organization type — C (corporation), L (labor), M (membership), T (trade), V (cooperative), W (corporation without capital stock). by_entity_type mode only.",
      "type": "string"
    },
    "min_receipts": {
      "description": "Minimum total receipts in dollars. by_entity_type mode only.",
      "type": "number"
    },
    "max_receipts": {
      "description": "Maximum total receipts in dollars. by_entity_type mode only.",
      "type": "number"
    },
    "min_disbursements": {
      "description": "Minimum total disbursements in dollars. by_entity_type mode only.",
      "type": "number"
    },
    "max_disbursements": {
      "description": "Maximum total disbursements in dollars. by_entity_type mode only.",
      "type": "number"
    },
    "sort": {
      "description": "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.",
      "type": "string",
      "enum": [
        "cycle",
        "-cycle",
        "receipts",
        "-receipts",
        "disbursements",
        "-disbursements",
        "last_cash_on_hand_end_period",
        "-last_cash_on_hand_end_period"
      ]
    },
    "page": {
      "default": 1,
      "description": "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.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_contributions

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.

Parameters19

mode	string	optional	Query mode. "itemized" returns individual contribution records (keyset pagination). "by_size" aggregates by contribution size bucket. "by_state" aggregates by contributor state. "by_employer" aggregates by employer. "by_occupation" aggregates by occupation.
committee_id	string	optional	Receiving committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.
candidate_id	string	optional	Candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results. Enables by_size and by_state aggregates without a committee_id.
contributor_name	string	optional	Full-text donor name search. Itemized only.
contributor_employer	string	optional	Full-text employer search. Itemized only.
contributor_occupation	string	optional	Full-text occupation search. Itemized only.
contributor_city	string	optional	Contributor city. Itemized only.
contributor_state	string	optional	Two-letter state code (e.g., CA). Itemized only.
contributor_zip	string	optional	ZIP code prefix (starts-with match). Itemized only.
cycle	number	optional	Two-year election cycle (e.g., 2024). Even years only. Defaults to current cycle for itemized mode.
min_date	string	optional	Earliest contribution date (YYYY-MM-DD). Itemized only.
max_date	string	optional	Latest contribution date (YYYY-MM-DD). Itemized only.
min_amount	number	optional	Minimum contribution amount in dollars. Itemized only.
max_amount	number	optional	Maximum contribution amount in dollars. Itemized only.
is_individual	boolean	optional	Only individual contributions (excludes committee-to-committee transfers). Itemized only.
sort	string	optional	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, redesignations). Itemized only; OpenFEC sorts by "-contribution_receipt_date" when omitted.
page	integer	optional	Page number (1-indexed) for aggregate modes. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for aggregates.
per_page	integer	optional	Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.
cursor	string	optional	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, rejects the cursor; omit it to start over.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "itemized",
      "description": "Query mode. \"itemized\" returns individual contribution records (keyset pagination). \"by_size\" aggregates by contribution size bucket. \"by_state\" aggregates by contributor state. \"by_employer\" aggregates by employer. \"by_occupation\" aggregates by occupation.",
      "type": "string",
      "enum": [
        "itemized",
        "by_size",
        "by_state",
        "by_employer",
        "by_occupation"
      ]
    },
    "committee_id": {
      "description": "Receiving committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.",
      "type": "string"
    },
    "candidate_id": {
      "description": "Candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results. Enables by_size and by_state aggregates without a committee_id.",
      "type": "string"
    },
    "contributor_name": {
      "description": "Full-text donor name search. Itemized only.",
      "type": "string"
    },
    "contributor_employer": {
      "description": "Full-text employer search. Itemized only.",
      "type": "string"
    },
    "contributor_occupation": {
      "description": "Full-text occupation search. Itemized only.",
      "type": "string"
    },
    "contributor_city": {
      "description": "Contributor city. Itemized only.",
      "type": "string"
    },
    "contributor_state": {
      "description": "Two-letter state code (e.g., CA). Itemized only.",
      "type": "string"
    },
    "contributor_zip": {
      "description": "ZIP code prefix (starts-with match). Itemized only.",
      "type": "string"
    },
    "cycle": {
      "description": "Two-year election cycle (e.g., 2024). Even years only. Defaults to current cycle for itemized mode.",
      "type": "number"
    },
    "min_date": {
      "description": "Earliest contribution date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "max_date": {
      "description": "Latest contribution date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "min_amount": {
      "description": "Minimum contribution amount in dollars. Itemized only.",
      "type": "number"
    },
    "max_amount": {
      "description": "Maximum contribution amount in dollars. Itemized only.",
      "type": "number"
    },
    "is_individual": {
      "description": "Only individual contributions (excludes committee-to-committee transfers). Itemized only.",
      "type": "boolean"
    },
    "sort": {
      "description": "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, redesignations). Itemized only; OpenFEC sorts by \"-contribution_receipt_date\" when omitted.",
      "type": "string",
      "enum": [
        "contribution_receipt_date",
        "-contribution_receipt_date",
        "contribution_receipt_amount",
        "-contribution_receipt_amount"
      ]
    },
    "page": {
      "description": "Page number (1-indexed) for aggregate modes. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for aggregates.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "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, rejects the cursor; omit it to start over.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_disbursements

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?"

Parameters17

mode	string	optional	Query mode. "itemized" returns individual disbursement records (keyset pagination). "by_purpose" aggregates by purpose category. "by_recipient" aggregates by recipient name. "by_recipient_id" aggregates by recipient committee ID (committee-to-committee transfers).
committee_id	string	required	Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required for all modes.
recipient_name	string	optional	Full-text payee name search. Itemized only.
recipient_state	string	optional	Recipient state. Itemized only.
recipient_city	string	optional	Recipient city. Itemized only.
recipient_committee_id	string	optional	Recipient committee ID (for committee-to-committee transfers). Itemized only.
disbursement_description	string	optional	Full-text description search (e.g., "media buy", "consulting"). Itemized only.
disbursement_purpose_category	string	optional	Purpose category code. Itemized only.
cycle	number	optional	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 out upstream. Pass an explicit cycle to search an earlier period.
min_date	string	optional	Earliest disbursement date (YYYY-MM-DD). Itemized only.
max_date	string	optional	Latest disbursement date (YYYY-MM-DD). Itemized only.
min_amount	number	optional	Minimum amount in dollars. Itemized only.
max_amount	number	optional	Maximum amount in dollars. Itemized only.
sort	string	optional	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). Itemized only; OpenFEC sorts by "-disbursement_date" when omitted.
page	integer	optional	Page number (1-indexed) for aggregate modes. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for aggregates.
per_page	integer	optional	Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.
cursor	string	optional	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, rejects the cursor; omit it to start over.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "itemized",
      "description": "Query mode. \"itemized\" returns individual disbursement records (keyset pagination). \"by_purpose\" aggregates by purpose category. \"by_recipient\" aggregates by recipient name. \"by_recipient_id\" aggregates by recipient committee ID (committee-to-committee transfers).",
      "type": "string",
      "enum": [
        "itemized",
        "by_purpose",
        "by_recipient",
        "by_recipient_id"
      ]
    },
    "committee_id": {
      "type": "string",
      "minLength": 1,
      "description": "Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required for all modes."
    },
    "recipient_name": {
      "description": "Full-text payee name search. Itemized only.",
      "type": "string"
    },
    "recipient_state": {
      "description": "Recipient state. Itemized only.",
      "type": "string"
    },
    "recipient_city": {
      "description": "Recipient city. Itemized only.",
      "type": "string"
    },
    "recipient_committee_id": {
      "description": "Recipient committee ID (for committee-to-committee transfers). Itemized only.",
      "type": "string"
    },
    "disbursement_description": {
      "description": "Full-text description search (e.g., \"media buy\", \"consulting\"). Itemized only.",
      "type": "string"
    },
    "disbursement_purpose_category": {
      "description": "Purpose category code. Itemized only.",
      "type": "string"
    },
    "cycle": {
      "description": "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 out upstream. Pass an explicit cycle to search an earlier period.",
      "type": "number"
    },
    "min_date": {
      "description": "Earliest disbursement date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "max_date": {
      "description": "Latest disbursement date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "min_amount": {
      "description": "Minimum amount in dollars. Itemized only.",
      "type": "number"
    },
    "max_amount": {
      "description": "Maximum amount in dollars. Itemized only.",
      "type": "number"
    },
    "sort": {
      "description": "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). Itemized only; OpenFEC sorts by \"-disbursement_date\" when omitted.",
      "type": "string",
      "enum": [
        "disbursement_date",
        "-disbursement_date",
        "disbursement_amount",
        "-disbursement_amount"
      ]
    },
    "page": {
      "description": "Page number (1-indexed) for aggregate modes. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for aggregates.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "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, rejects the cursor; omit it to start over.",
      "type": "string"
    }
  },
  "required": [
    "committee_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_expenditures

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

Parameters21

mode	string	optional	Query mode. "itemized" returns individual expenditure records (keyset pagination). "by_candidate" returns aggregated totals per candidate by committee (page-based).
committee_id	string	optional	Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.
candidate_id	string	optional	Targeted candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
support_oppose	string	optional	S = support, O = oppose. Filter by whether the expenditure supports or opposes the candidate.
payee_name	string	optional	Full-text payee name search. Itemized only.
candidate_office	string	optional	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_state and candidate_office_district.
candidate_office_state	string	optional	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 and match nothing when one is supplied.
candidate_office_district	string	optional	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 match nothing when one is supplied.
candidate_party	string	optional	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.
cycle	number	optional	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 explicit cycle to search an earlier period. In by_candidate mode the cycle names the election, and election_full decides whether the totals cover the full election period ending in it (4yr president, 6yr senate, 2yr house) or only this two-year cycle.
min_date	string	optional	Earliest expenditure date (YYYY-MM-DD). Itemized only.
max_date	string	optional	Latest expenditure date (YYYY-MM-DD). Itemized only.
min_amount	number	optional	Minimum expenditure amount in dollars. Itemized only.
max_amount	number	optional	Maximum expenditure amount in dollars. Itemized only.
is_notice	boolean	optional	Only 24/48-hour notice filings (near-election spending). Itemized only.
most_recent	boolean	optional	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.
election_full	boolean	optional	by_candidate only: expand cycle to the full election period (4yr president, 6yr senate, 2yr house) instead of the two-year cycle alone. Defaults to true when omitted; itemized mode rejects it, since that endpoint has no such parameter. Carries no schema default, so an explicit value is distinguishable from an omission.
sort	string	optional	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). Itemized only; OpenFEC sorts by "-expenditure_date" when omitted.
page	integer	optional	Page number (1-indexed) for by_candidate mode. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for by_candidate.
per_page	integer	optional	Results per page. Itemized mode sends at most 60 upstream when scoped by committee_id and 30 otherwise, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.
cursor	string	optional	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, rejects the cursor; omit it to start over.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "itemized",
      "description": "Query mode. \"itemized\" returns individual expenditure records (keyset pagination). \"by_candidate\" returns aggregated totals per candidate by committee (page-based).",
      "type": "string",
      "enum": [
        "itemized",
        "by_candidate"
      ]
    },
    "committee_id": {
      "description": "Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.",
      "type": "string"
    },
    "candidate_id": {
      "description": "Targeted candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
      "type": "string"
    },
    "support_oppose": {
      "description": "S = support, O = oppose. Filter by whether the expenditure supports or opposes the candidate.",
      "type": "string",
      "enum": [
        "S",
        "O"
      ]
    },
    "payee_name": {
      "description": "Full-text payee name search. Itemized only.",
      "type": "string"
    },
    "candidate_office": {
      "description": "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_state and candidate_office_district.",
      "type": "string",
      "enum": [
        "H",
        "S",
        "P"
      ]
    },
    "candidate_office_state": {
      "description": "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 and match nothing when one is supplied.",
      "type": "string"
    },
    "candidate_office_district": {
      "description": "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 match nothing when one is supplied.",
      "type": "string"
    },
    "candidate_party": {
      "description": "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.",
      "type": "string"
    },
    "cycle": {
      "description": "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 explicit cycle to search an earlier period. In by_candidate mode the cycle names the election, and election_full decides whether the totals cover the full election period ending in it (4yr president, 6yr senate, 2yr house) or only this two-year cycle.",
      "type": "number"
    },
    "min_date": {
      "description": "Earliest expenditure date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "max_date": {
      "description": "Latest expenditure date (YYYY-MM-DD). Itemized only.",
      "type": "string"
    },
    "min_amount": {
      "description": "Minimum expenditure amount in dollars. Itemized only.",
      "type": "number"
    },
    "max_amount": {
      "description": "Maximum expenditure amount in dollars. Itemized only.",
      "type": "number"
    },
    "is_notice": {
      "description": "Only 24/48-hour notice filings (near-election spending). Itemized only.",
      "type": "boolean"
    },
    "most_recent": {
      "description": "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.",
      "type": "boolean"
    },
    "election_full": {
      "description": "by_candidate only: expand cycle to the full election period (4yr president, 6yr senate, 2yr house) instead of the two-year cycle alone. Defaults to true when omitted; itemized mode rejects it, since that endpoint has no such parameter. Carries no schema default, so an explicit value is distinguishable from an omission.",
      "type": "boolean"
    },
    "sort": {
      "description": "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). Itemized only; OpenFEC sorts by \"-expenditure_date\" when omitted.",
      "type": "string",
      "enum": [
        "expenditure_date",
        "-expenditure_date",
        "expenditure_amount",
        "-expenditure_amount",
        "office_total_ytd",
        "-office_total_ytd"
      ]
    },
    "page": {
      "description": "Page number (1-indexed) for by_candidate mode. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for by_candidate.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. Itemized mode sends at most 60 upstream when scoped by committee_id and 30 otherwise, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "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, rejects the cursor; omit it to start over.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_coordinated_expenditures

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.

Parameters11

committee_id	string	optional	Spending party committee ID (e.g., C00003418). Get IDs from openfec_search_committees results — party committees carry committee_type X or Y.
candidate_id	string	optional	Benefiting candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
cycle	number	optional	Two-year election cycle (e.g., 2024). Even years only. Omitting it searches every cycle on record.
payee_name	string	optional	Full-text payee name search (the vendor the party paid).
min_date	string	optional	Earliest expenditure date (YYYY-MM-DD).
max_date	string	optional	Latest expenditure date (YYYY-MM-DD).
min_amount	number	optional	Minimum expenditure amount in dollars.
max_amount	number	optional	Maximum expenditure amount in dollars.
sort	string	optional	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 entries). OpenFEC sorts by "-expenditure_date" when omitted.
page	integer	optional	Page number (1-indexed). Read pagination.pages in the response to see how many pages exist.
per_page	integer	optional	Results per page. At most 80 are requested upstream when scoped by committee_id and 25 otherwise, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.

Raw schema

{
  "type": "object",
  "properties": {
    "committee_id": {
      "description": "Spending party committee ID (e.g., C00003418). Get IDs from openfec_search_committees results — party committees carry committee_type X or Y.",
      "type": "string"
    },
    "candidate_id": {
      "description": "Benefiting candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
      "type": "string"
    },
    "cycle": {
      "description": "Two-year election cycle (e.g., 2024). Even years only. Omitting it searches every cycle on record.",
      "type": "number"
    },
    "payee_name": {
      "description": "Full-text payee name search (the vendor the party paid).",
      "type": "string"
    },
    "min_date": {
      "description": "Earliest expenditure date (YYYY-MM-DD).",
      "type": "string"
    },
    "max_date": {
      "description": "Latest expenditure date (YYYY-MM-DD).",
      "type": "string"
    },
    "min_amount": {
      "description": "Minimum expenditure amount in dollars.",
      "type": "number"
    },
    "max_amount": {
      "description": "Maximum expenditure amount in dollars.",
      "type": "number"
    },
    "sort": {
      "description": "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 entries). OpenFEC sorts by \"-expenditure_date\" when omitted.",
      "type": "string",
      "enum": [
        "expenditure_date",
        "-expenditure_date",
        "expenditure_amount",
        "-expenditure_amount"
      ]
    },
    "page": {
      "default": 1,
      "description": "Page number (1-indexed). Read pagination.pages in the response to see how many pages exist.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. At most 80 are requested upstream when scoped by committee_id and 25 otherwise, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_filings

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.

Parameters13

committee_id	string	optional	Filing committee ID (e.g., C00358796). Get IDs from openfec_search_committees results.
candidate_id	string	optional	Associated candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.
filer_name	string	optional	Full-text filer name search.
form_type	string	optional	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).
report_type	string	optional	Report type code. Common: Q1/Q2/Q3 (quarterly), YE (year-end), M3-M12 (monthly), 12G/12P/30G (pre/post election).
report_year	number	optional	Filing year.
cycle	number	optional	Two-year election cycle (even year).
is_amended	boolean	optional	Filter to original or amended filings only.
most_recent	boolean	optional	Only the most recent version (filters out superseded amendments).
min_receipt_date	string	optional	Earliest date FEC received the filing (YYYY-MM-DD).
max_receipt_date	string	optional	Latest FEC receipt date (YYYY-MM-DD).
page	integer	optional	Page number (1-indexed).
per_page	integer	optional	Results per page. At most 65 are requested upstream, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.

Raw schema

{
  "type": "object",
  "properties": {
    "committee_id": {
      "description": "Filing committee ID (e.g., C00358796). Get IDs from openfec_search_committees results.",
      "type": "string"
    },
    "candidate_id": {
      "description": "Associated candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
      "type": "string"
    },
    "filer_name": {
      "description": "Full-text filer name search.",
      "type": "string"
    },
    "form_type": {
      "description": "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).",
      "type": "string"
    },
    "report_type": {
      "description": "Report type code. Common: Q1/Q2/Q3 (quarterly), YE (year-end), M3-M12 (monthly), 12G/12P/30G (pre/post election).",
      "type": "string"
    },
    "report_year": {
      "description": "Filing year.",
      "type": "number"
    },
    "cycle": {
      "description": "Two-year election cycle (even year).",
      "type": "number"
    },
    "is_amended": {
      "description": "Filter to original or amended filings only.",
      "type": "boolean"
    },
    "most_recent": {
      "default": true,
      "description": "Only the most recent version (filters out superseded amendments).",
      "type": "boolean"
    },
    "min_receipt_date": {
      "description": "Earliest date FEC received the filing (YYYY-MM-DD).",
      "type": "string"
    },
    "max_receipt_date": {
      "description": "Latest FEC receipt date (YYYY-MM-DD).",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number (1-indexed).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. At most 65 are requested upstream, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_lookup_elections

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.

Parameters9

mode	string	optional	search = candidates in a race with financial totals. summary = aggregate race financial summary.
office	string	required	Office sought: H=House, S=Senate, P=President.
cycle	integer	required	Election cycle year (even years only, e.g. 2024).
state	string	optional	Two-letter US state code (e.g., AZ, CA). Required for senate/house unless zip is provided.
district	string	optional	Two-digit district number (e.g. "07"). Required for house unless zip is provided.
zip	string	optional	ZIP code — finds races covering this ZIP. Search mode only.
election_full	boolean	optional	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 default, so an explicit value is distinguishable from an omission.
page	integer	optional	Page number (1-indexed). Search mode only; explicit page is rejected in summary mode. Defaults to 1 for search.
per_page	integer	optional	Results per page. Search mode only; defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "search",
      "description": "search = candidates in a race with financial totals. summary = aggregate race financial summary.",
      "type": "string",
      "enum": [
        "search",
        "summary"
      ]
    },
    "office": {
      "type": "string",
      "enum": [
        "H",
        "S",
        "P"
      ],
      "description": "Office sought: H=House, S=Senate, P=President."
    },
    "cycle": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Election cycle year (even years only, e.g. 2024)."
    },
    "state": {
      "description": "Two-letter US state code (e.g., AZ, CA). Required for senate/house unless zip is provided.",
      "type": "string"
    },
    "district": {
      "description": "Two-digit district number (e.g. \"07\"). Required for house unless zip is provided.",
      "type": "string"
    },
    "zip": {
      "description": "ZIP code — finds races covering this ZIP. Search mode only.",
      "type": "string"
    },
    "election_full": {
      "description": "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 default, so an explicit value is distinguishable from an omission.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number (1-indexed). Search mode only; explicit page is rejected in summary mode. Defaults to 1 for search.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "description": "Results per page. Search mode only; defaults to 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "office",
    "cycle"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_search_legal

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. Each response is held to 100,000 bytes: when a page would exceed it, whole results are held back and nextFromHit gives the from_hit that continues each document type.

Parameters14

query	string	optional	Full-text search across legal documents.
type	string	optional	Document type filter. Omit to search every type the other filters apply to — all five when only query is given. admin_fines can be slow without a query.
ao_number	string	optional	Specific advisory opinion number (e.g. "2024-01"). Applies to advisory_opinions only: rejected with any other type, and with type omitted only advisory opinions are returned.
case_number	string	optional	Specific MUR, ADR, or administrative fine case number (e.g. "8343"). Applies to murs, adrs, and admin_fines: rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.
respondent	string	optional	Respondent name. Applies to enforcement cases (murs, adrs) only: rejected with any other type, and with type omitted only MURs and ADRs are returned.
regulatory_citation	string	optional	CFR citation in the form "<title> CFR <part>.<section>" (e.g. "11 CFR 110.1"; "C.F.R.", "§", and a suffix such as "110.1(b)" are accepted — a bare "110.1" is rejected as invalid_citation). One citation per value: "11 CFR 110.1; 11 CFR 110.2" is rejected, since only the first would be applied. Given with statutory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.
statutory_citation	string	optional	U.S.C. citation in the form "<title> U.S.C. <section>" (e.g. "52 U.S.C. 30104"; "USC", "§", and a suffix such as "30104(g)" are accepted — a bare "30104" is rejected as invalid_citation). One citation per value: "52 U.S.C. 30104, 52 U.S.C. 30118" is rejected, since only the first would be applied. Given with regulatory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.
min_penalty_amount	number	optional	Minimum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.
max_penalty_amount	number	optional	Maximum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.
date_kind	string	optional	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 received), document_date; type=murs or adrs → open_date (case opened), close_date (case closed), document_date; type=admin_fines → rtb_date (reason-to-believe finding), fd_date (final determination). type=statutes cannot be date-filtered. Required whenever min_date or max_date is given, together with type.
min_date	string	optional	Earliest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.
max_date	string	optional	Latest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.
from_hit	integer	optional	Offset for pagination (0-indexed), counted within each document type rather than across them. Default 0. When a response is bounded, nextFromHit gives the value that continues each type. The search index serves a 10,000-result window, so from_hit plus hits_returned must be 10,000 or less — the ceiling here assumes hits_returned of 1.
hits_returned	integer	optional	Results per page, applied per document type. Default 20, max 200. A response is held to 100,000 bytes, so a page of large records can carry fewer, with nextFromHit naming where each type continues. Bounded together with from_hit by the 10,000-result window.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Full-text search across legal documents.",
      "type": "string"
    },
    "type": {
      "description": "Document type filter. Omit to search every type the other filters apply to — all five when only query is given. admin_fines can be slow without a query.",
      "type": "string",
      "enum": [
        "advisory_opinions",
        "murs",
        "adrs",
        "admin_fines",
        "statutes"
      ]
    },
    "ao_number": {
      "description": "Specific advisory opinion number (e.g. \"2024-01\"). Applies to advisory_opinions only: rejected with any other type, and with type omitted only advisory opinions are returned.",
      "type": "string"
    },
    "case_number": {
      "description": "Specific MUR, ADR, or administrative fine case number (e.g. \"8343\"). Applies to murs, adrs, and admin_fines: rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
      "type": "string"
    },
    "respondent": {
      "description": "Respondent name. Applies to enforcement cases (murs, adrs) only: rejected with any other type, and with type omitted only MURs and ADRs are returned.",
      "type": "string"
    },
    "regulatory_citation": {
      "description": "CFR citation in the form \"<title> CFR <part>.<section>\" (e.g. \"11 CFR 110.1\"; \"C.F.R.\", \"§\", and a suffix such as \"110.1(b)\" are accepted — a bare \"110.1\" is rejected as invalid_citation). One citation per value: \"11 CFR 110.1; 11 CFR 110.2\" is rejected, since only the first would be applied. Given with statutory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.",
      "type": "string"
    },
    "statutory_citation": {
      "description": "U.S.C. citation in the form \"<title> U.S.C. <section>\" (e.g. \"52 U.S.C. 30104\"; \"USC\", \"§\", and a suffix such as \"30104(g)\" are accepted — a bare \"30104\" is rejected as invalid_citation). One citation per value: \"52 U.S.C. 30104, 52 U.S.C. 30118\" is rejected, since only the first would be applied. Given with regulatory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.",
      "type": "string"
    },
    "min_penalty_amount": {
      "description": "Minimum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
      "type": "number"
    },
    "max_penalty_amount": {
      "description": "Maximum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
      "type": "number"
    },
    "date_kind": {
      "description": "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 received), document_date; type=murs or adrs → open_date (case opened), close_date (case closed), document_date; type=admin_fines → rtb_date (reason-to-believe finding), fd_date (final determination). type=statutes cannot be date-filtered. Required whenever min_date or max_date is given, together with type.",
      "type": "string",
      "enum": [
        "issue_date",
        "request_date",
        "open_date",
        "close_date",
        "document_date",
        "rtb_date",
        "fd_date"
      ]
    },
    "min_date": {
      "description": "Earliest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.",
      "type": "string"
    },
    "max_date": {
      "description": "Latest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.",
      "type": "string"
    },
    "from_hit": {
      "default": 0,
      "description": "Offset for pagination (0-indexed), counted within each document type rather than across them. Default 0. When a response is bounded, nextFromHit gives the value that continues each type. The search index serves a 10,000-result window, so from_hit plus hits_returned must be 10,000 or less — the ceiling here assumes hits_returned of 1.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9999
    },
    "hits_returned": {
      "default": 20,
      "description": "Results per page, applied per document type. Default 20, max 200. A response is held to 100,000 bytes, so a page of large records can carry fewer, with nextFromHit naming where each type continues. Bounded together with from_hit by the 10,000-result window.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_get_legal_document

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

Parameters4

doc_type	string	required	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 field wants.
no	string	required	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 digit strings (e.g. "8363"); statutes are U.S. Code section numbers (e.g. "30123").
array	string	optional	Name of one top-level array field of the record to page through by entry — usually one listed in withheld when the record was too large to return whole (e.g. "dispositions", "documents"). Returns that array's entries from offset while they fit the response budget, in slice, with the record's scalar fields. Omit to fetch the record itself.
offset	integer	optional	Entry offset (0-indexed) into array. Requires array; defaults to 0 when array is given. Pass the next_offset a previous slice returned to continue.

Raw schema

{
  "type": "object",
  "properties": {
    "doc_type": {
      "type": "string",
      "enum": [
        "advisory_opinions",
        "murs",
        "adrs",
        "admin_fines",
        "statutes"
      ],
      "description": "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 field wants."
    },
    "no": {
      "type": "string",
      "minLength": 1,
      "description": "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 digit strings (e.g. \"8363\"); statutes are U.S. Code section numbers (e.g. \"30123\")."
    },
    "array": {
      "description": "Name of one top-level array field of the record to page through by entry — usually one listed in withheld when the record was too large to return whole (e.g. \"dispositions\", \"documents\"). Returns that array's entries from offset while they fit the response budget, in slice, with the record's scalar fields. Omit to fetch the record itself.",
      "type": "string",
      "minLength": 1
    },
    "offset": {
      "description": "Entry offset (0-indexed) into array. Requires array; defaults to 0 when array is given. Pass the next_offset a previous slice returned to continue.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "doc_type",
    "no"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

openfec_lookup_calendar

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.

Parameters13

mode	string	optional	events = FEC calendar events. filing_deadlines = report due dates. election_dates = upcoming/past elections.
state	string	optional	Two-letter state code (e.g., AZ, CA). Primarily for election_dates mode.
office	string	optional	Office sought (H=House, S=Senate, P=President). Election dates mode.
district	string	optional	Two-digit House district (e.g., "14", "07"); a single digit is zero-padded. Pair it with state — alone it matches that district number in every state. At-large races carry no district upstream, so a district filter never matches them. Election dates mode.
report_type	string	optional	Report type code (e.g. "Q1", "Q2"). Filing deadlines mode only.
report_year	integer	optional	Report year. Filing deadlines mode.
category	string	optional	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=IE Periods, 32=Open Meetings, 33=Conferences, 34=Roundtables, 36=Election Dates, 37=Federal Holidays, 38=FEA Periods, 39=Executive Sessions, 40=Public Hearings. Events mode only.
election_year	integer	optional	Election year. Election dates mode.
description	string	optional	Full-text event description search. Events mode.
min_date	string	optional	Earliest date (YYYY-MM-DD).
max_date	string	optional	Latest date (YYYY-MM-DD).
page	integer	optional	Page number (1-indexed). Default 1.
per_page	integer	optional	Results per page. Default 20, max 100.

Raw schema

{
  "type": "object",
  "properties": {
    "mode": {
      "default": "events",
      "description": "events = FEC calendar events. filing_deadlines = report due dates. election_dates = upcoming/past elections.",
      "type": "string",
      "enum": [
        "events",
        "filing_deadlines",
        "election_dates"
      ]
    },
    "state": {
      "description": "Two-letter state code (e.g., AZ, CA). Primarily for election_dates mode.",
      "type": "string"
    },
    "office": {
      "description": "Office sought (H=House, S=Senate, P=President). Election dates mode.",
      "type": "string",
      "enum": [
        "H",
        "S",
        "P"
      ]
    },
    "district": {
      "description": "Two-digit House district (e.g., \"14\", \"07\"); a single digit is zero-padded. Pair it with state — alone it matches that district number in every state. At-large races carry no district upstream, so a district filter never matches them. Election dates mode.",
      "type": "string"
    },
    "report_type": {
      "description": "Report type code (e.g. \"Q1\", \"Q2\"). Filing deadlines mode only.",
      "type": "string"
    },
    "report_year": {
      "description": "Report year. Filing deadlines mode.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "category": {
      "description": "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=IE Periods, 32=Open Meetings, 33=Conferences, 34=Roundtables, 36=Election Dates, 37=Federal Holidays, 38=FEA Periods, 39=Executive Sessions, 40=Public Hearings. Events mode only.",
      "type": "string",
      "enum": [
        "20",
        "21",
        "22",
        "23",
        "24",
        "25",
        "26",
        "27",
        "28",
        "29",
        "32",
        "33",
        "34",
        "36",
        "37",
        "38",
        "39",
        "40"
      ]
    },
    "election_year": {
      "description": "Election year. Election dates mode.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "description": {
      "description": "Full-text event description search. Events mode.",
      "type": "string"
    },
    "min_date": {
      "description": "Earliest date (YYYY-MM-DD).",
      "type": "string"
    },
    "max_date": {
      "description": "Latest date (YYYY-MM-DD).",
      "type": "string"
    },
    "page": {
      "default": 1,
      "description": "Page number (1-indexed). Default 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "per_page": {
      "default": 20,
      "description": "Results per page. Default 20, max 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

README.md22 KBView on GitHub

@cyanheads/openfec-mcp-server

Access FEC campaign finance data through MCP. Query data about candidates, money trails, and election filings. STDIO & Streamable HTTP.

12 Tools • 5 Resources • 2 Prompts

MCP SDK TypeScript Bun

Public Hosted Server: https://openfec.caseyjhand.com/mcp

Overview

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. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.

Tools

Tool	Description
`openfec_search_candidates`	Find federal candidates by name, state, office, party, or cycle; fetch one by FEC ID with financial totals
`openfec_search_committees`	Find political committees by name, type, candidate affiliation, or state; fetch one by FEC ID
`openfec_get_committee_totals`	Pre-aggregated financial totals for one committee by cycle, or ranked across committees of one entity type
`openfec_search_contributions`	Itemized contributions (Schedule A), or aggregates by size, state, employer, or occupation
`openfec_search_disbursements`	Itemized committee spending (Schedule B), or aggregates by purpose or recipient
`openfec_search_expenditures`	Independent expenditures (Schedule E) supporting or opposing candidates, itemized or totaled per candidate
`openfec_search_coordinated_expenditures`	Coordinated party expenditures (Schedule F) made on behalf of a candidate
`openfec_search_filings`	FEC filings and reports by committee, candidate, form type, or date range
`openfec_lookup_elections`	Candidates in a federal race with their fundraising totals, or an aggregate race summary
`openfec_search_legal`	Advisory opinions, enforcement cases, alternative dispute resolutions, administrative fines, and statutes
`openfec_get_legal_document`	One legal document in full, including the arrays search trims away, paged by entry when too large for one response
`openfec_lookup_calendar`	FEC calendar events, filing deadlines, and election dates

Resources

Resource	Description
`openfec://candidate/{candidate_id}`	Candidate profile with financial totals and principal committees
`openfec://committee/{committee_id}`	Committee profile with type, designation, and financial summary
`openfec://election/{cycle}/{office}`	Presidential race with candidate financial totals
`openfec://election/{cycle}/{office}/{state}`	Senate or at-large House race with candidate financial totals
`openfec://election/{cycle}/{office}/{state}/{district}`	House district race with candidate financial totals

The same data is reachable through openfec_search_candidates, openfec_search_committees, and openfec_lookup_elections for tool-only clients.

Prompts

Prompt	Description
`openfec_money_trail`	Trace the money around a candidate: direct fundraising, PAC support, independent expenditures, and party spending
`openfec_campaign_analysis`	Structured analysis of a candidate's financial position

Capability reference

`openfec_search_candidates` _tool

query 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 record
include_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_totals
Typed errors: candidate_not_found, inputs_not_applicable_to_id_lookup

`openfec_search_committees` _tool

query 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)
Typed errors: committee_not_found, inputs_not_applicable_to_id_lookup

`openfec_get_committee_totals` _tool

mode: "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 page
Rows carry receipts, disbursements, cash on hand, debts, and the itemized/unitemized split; the output mode says whether rows are cycles or committees
Typed errors: committee_id_required_for_single_mode, entity_type_required_for_group_mode, committee_totals_not_found

`openfec_search_contributions` _tool

itemized (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_id
The output mode 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_approximate
Typed errors: itemized_requires_committee_id, aggregate_requires_committee_id

`openfec_search_disbursements` _tool

committee_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_id
Itemized responses carry next_cursor, count, and count_is_approximate; aggregate modes page by number

`openfec_search_expenditures` _tool

itemized (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 otherwise
by_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_scope

`openfec_search_coordinated_expenditures` _tool

Scope by spending party committee_id, benefiting candidate_id, cycle, payee, dates, and amounts; unscoped queries span all years
Page-based, 80 rows per page when scoped by committee_id and 25 otherwise; rows carry subordinate_committee_id, the committee the spending is attributed to

`openfec_search_filings` _tool

Filters: committee_id, candidate_id, filer_name, form_type (F3, F3P, F3X, F24, F1, F2, F5), report_type, report_year, cycle, is_amended, and receipt date range; 65 rows per page
most_recent defaults to true, hiding superseded amendments; rows carry form and report type, financial totals, and pdf_url

`openfec_lookup_elections` _tool

office and an even cycle are required; Senate also needs state and House state plus district, unless a zip scopes a search
mode: "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 row
Typed errors: cycle_must_be_even, missing_state_for_office, missing_district_for_house, summary_does_not_support_zip

`openfec_search_legal` _tool

type (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 records
Citations, penalty bounds, respondent, ao_number, and case_number each filter only some types; one sent with a type 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 one
Citations take the form upstream parses — 52 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 way
Offset paging via from_hit / hits_returned, up to 200 per type within a 10,000-result window
Results are trimmed: documents 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 record
Each response stays under 100,000 bytes: whole results are admitted one type at a time until the next would not fit, and a page that held some back reports truncated, shown, and nextFromHit — the from_hit that continues each type, passed back with that type

`openfec_get_legal_document` _tool

doc_type is the plural of a search result's document_type (mur → murs); no is that result's no field
Returns the untrimmed record, including documents, commission_votes, and dispositions; fails as legal_document_not_found
A record over 100,000 bytes returns its scalar fields, the arrays that fit (smallest first), and withheld — 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_record

`openfec_lookup_calendar` _tool

events (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 page
A district filter never matches an at-large race; pair it with state

`openfec://candidate/{candidate_id}` _resource

Candidate record merged with its financial totals and principal_committees (current designation P, not scoped to a cycle)
candidate_id comes from openfec_search_candidates; fails as candidate_not_found

`openfec://committee/{committee_id}` _resource

Committee record merged with its financial totals, which are absent for a committee that files no Form 3/3X/3P
committee_id comes from openfec_search_committees; fails as committee_not_found

`openfec://election/{cycle}/{office}` _resource

Presidential races (office P), with totals for the full election period
First page only: a longer race carries truncation_notice pointing to openfec_lookup_elections, and an empty one empty_result_notice

`openfec://election/{cycle}/{office}/{state}` _resource

Senate races, or an at-large House race in a single-district state (office S or H)
Same first-page limit and notices as the presidential template

`openfec://election/{cycle}/{office}/{state}/{district}` _resource

House district races (office H)
Same first-page limit and notices as the presidential template

`openfec_money_trail` _prompt

Arguments: candidate_name or candidate_id (one required), optional cycle
Seven steps: identify the candidate, resolve the cycle's principal committee via candidate_pcc_id, then direct fundraising, independent expenditures, coordinated party spending, disbursements, and a synthesis

`openfec_campaign_analysis` _prompt

Arguments: candidate_name or candidate_id (one required), optional cycle
Seven steps: candidate overview, principal committee and per-cycle trajectory, fundraising mix, burn rate, competitive position, outside money, and an assessment

Features

Built 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:

Type-safe client for the OpenFEC REST API with retry and a configurable timeout; error messages have the API key stripped and HTTP failures carry recovery hints
Cycles are even years covering two calendar years (2024 = Jan 2023 – Dec 2024); itemized Schedule A/B/E default to the current cycle when cycle is omitted, and election_full (default true) widens a race total to the full election period (4yr president, 6yr senate, 2yr house)
Itemized contributions and disbursements scope to a 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_elections
Itemized Schedule A/B/E page with an opaque next_cursor, valid only for an otherwise-identical call; other tools page by number, and legal search by offset

Agent-friendly output:

Effective-query echo: every tool response carries search_criteria with the post-default filters, and an empty result carries a notice on how to broaden it
Response budget of 100,000 bytes per surface: high-volume tools cap rows per page and report truncated, 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 row
Typed contracts: multi-mode tools echo the resolved mode 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_approximate

Getting started

Public Hosted Instance

A public instance is available at https://openfec.caseyjhand.com/mcp — no installation required. Point any MCP client at it via Streamable HTTP:

json

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

Self-Hosted / Local

Add the following to your MCP client configuration file.

json

{
  "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):

json

{
  "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:

json

{
  "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

Prerequisites

Bun v1.4.0 or higher (or Node.js v24+).
Optional: a free OpenFEC API key raises the rate limit from 30 to 1,000 requests per hour over the default DEMO_KEY.

Installation

Clone the repository:

git clone https://github.com/cyanheads/openfec-mcp-server.git

Navigate into the directory:

cd openfec-mcp-server

Install dependencies:

bun install

Configure environment:

cp .env.example .env
# edit .env and set FEC_API_KEY (optional)

Configuration

Variable	Description	Default
`FEC_API_KEY`	OpenFEC API key from api.data.gov. `DEMO_KEY` allows 30 req/hr; your own key allows 1,000.	`DEMO_KEY`
`FEC_BASE_URL`	OpenFEC API base URL.	`https://api.open.fec.gov/v1`
`FEC_MAX_RETRIES`	Retry attempts for failed API requests.	`3`
`FEC_REQUEST_TIMEOUT`	Per-request timeout, in ms.	`30000`
`MCP_TRANSPORT_TYPE`	Transport: `stdio` or `http`.	`stdio`
`MCP_HTTP_PORT`	HTTP server port.	`3010`
`MCP_SESSION_MODE`	HTTP session mode: `stateless`, `stateful`, or `auto`. Overrides the `stateless` mode the server declares.	`stateless`
`MCP_AUTH_MODE`	Authentication: `none`, `jwt`, or `oauth`.	`none`
`MCP_LOG_LEVEL`	Log level (`debug`, `info`, `warning`, `error`, etc.).	`info`
`LOGS_DIR`	Directory for log files (Node.js only).	`<project-root>/logs`
`STORAGE_PROVIDER_TYPE`	Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1`.	`in-memory`
`OTEL_ENABLED`	Enable OpenTelemetry.	`false`

See .env.example for the full list of optional overrides.

Running the server

Local development

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

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.

Project structure

Directory	Purpose
`src/index.ts`	`createApp()` entry point — registers tools/resources/prompts and inits the OpenFEC service.
`src/config`	Server-specific environment variable parsing and validation with Zod.
`src/mcp-server/tools`	Tool definitions (`*.tool.ts`), with shared validators and formatters in `definitions/utils/`.
`src/mcp-server/resources`	Resource definitions (`*.resource.ts`). Candidate, committee, and three election-race templates.
`src/mcp-server/prompts`	Prompt definitions (`*.prompt.ts`). Money trail and campaign analysis.
`src/services/openfec`	OpenFEC API client and domain types.
`tests/`	Unit and integration tests, mirroring the `src/` structure.
`scripts/`	Build, clean, devcheck, tree, changelog, and lint scripts.
`docs/`	Design notes and the OpenFEC OpenAPI spec.

Development guide

See CLAUDE.md for development guidelines and architectural rules. The short version:

Handlers throw, framework catches — no try/catch in tool logic
Use ctx.log for logging, ctx.state for storage
Register new tools and resources in the barrels at src/mcp-server/*/definitions/index.ts
Wrap the OpenFEC API: validate raw → normalize to domain type → return the output schema; never fabricate fields the upstream response omitted

Contributing

Issues are welcome. Run checks and tests before submitting:

bun run devcheck
bun run test

License

Apache-2.0 — see LICENSE for details.

Install

Tools (12)

openfec_search_candidatesopenfec_search_committeesopenfec_get_committee_totalsopenfec_search_contributionsopenfec_search_disbursementsopenfec_search_expendituresopenfec_search_coordinated_expendituresopenfec_search_filings

Configuration

Environment variables

FEC_API_KEY

OpenFEC API key — optional (DEMO_KEY: 30 req/hr). Own key: 1000 req/hr. Free at api.data.gov.

MCP_LOG_LEVELdefault info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_HTTP_HOSTdefault 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "openfec-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/openfec-mcp-server@0.9.0",
        "run",
        "start:stdio"
      ],
      "env": {
        "FEC_API_KEY": "<YOUR_FEC_API_KEY>",
        "MCP_LOG_LEVEL": "info"
      }
    }
  }
}

io.github.cyanheads/openfec-mcp-server — MCP Server for FEC Data

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Related Topics

Topics

openfec_search_candidates

openfec_search_committees

openfec_get_committee_totals

openfec_search_contributions

openfec_search_disbursements

openfec_search_expenditures

openfec_search_coordinated_expenditures

openfec_search_filings

openfec_lookup_elections

openfec_search_legal

openfec_get_legal_document

openfec_lookup_calendar

@cyanheads/openfec-mcp-server

Overview

Tools

Resources

Prompts

Capability reference

openfec_search_candidates tool

openfec_search_committees tool

openfec_get_committee_totals tool

openfec_search_contributions tool

openfec_search_disbursements tool

openfec_search_expenditures tool

openfec_search_coordinated_expenditures tool

openfec_search_filings tool

openfec_lookup_elections tool

openfec_search_legal tool

openfec_get_legal_document tool

openfec_lookup_calendar tool

openfec://candidate/{candidate_id} resource

openfec://committee/{committee_id} resource

openfec://election/{cycle}/{office} resource

openfec://election/{cycle}/{office}/{state} resource

openfec://election/{cycle}/{office}/{state}/{district} resource

openfec_money_trail prompt

openfec_campaign_analysis prompt

Features

Getting started

Public Hosted Instance

Self-Hosted / Local

Prerequisites

Installation

Configuration

Running the server

Local development

Docker

Project structure

Development guide

Contributing

License

Install

Configuration

Related servers

`openfec_search_candidates` _tool

`openfec_search_committees` _tool

`openfec_get_committee_totals` _tool

`openfec_search_contributions` _tool

`openfec_search_disbursements` _tool

`openfec_search_expenditures` _tool

`openfec_search_coordinated_expenditures` _tool

`openfec_search_filings` _tool

`openfec_lookup_elections` _tool

`openfec_search_legal` _tool

`openfec_get_legal_document` _tool

`openfec_lookup_calendar` _tool

`openfec://candidate/{candidate_id}` _resource

`openfec://committee/{committee_id}` _resource

`openfec://election/{cycle}/{office}` _resource

`openfec://election/{cycle}/{office}/{state}` _resource

`openfec://election/{cycle}/{office}/{state}/{district}` _resource

`openfec_money_trail` _prompt

`openfec_campaign_analysis` _prompt