openfec-mcp-server

v0.11.0 pre-1.0

Access FEC campaign finance data on candidates, money trails, and election filings via MCP. STDIO or Streamable HTTP.

openfec.caseyjhand.com/mcp
claude mcp add --transport http openfec-mcp-server https://openfec.caseyjhand.com/mcp
codex mcp add openfec-mcp-server --url https://openfec.caseyjhand.com/mcp
{
  "mcpServers": {
    "openfec-mcp-server": {
      "url": "https://openfec.caseyjhand.com/mcp"
    }
  }
}
gemini mcp add --transport http openfec-mcp-server https://openfec.caseyjhand.com/mcp
{
  "mcpServers": {
    "openfec-mcp-server": {
      "command": "bunx",
      "args": [
        "mcp-remote",
        "https://openfec.caseyjhand.com/mcp"
      ]
    }
  }
}
{
  "mcpServers": {
    "openfec-mcp-server": {
      "type": "http",
      "url": "https://openfec.caseyjhand.com/mcp"
    }
  }
}
curl -X POST https://openfec.caseyjhand.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"curl","version":"1.0.0"}}}'

Tools

12

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_candidates",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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": "Party code as OpenFEC files it, up to three characters (e.g., DEM, REP, LIB, W).",
      "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.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "additionalProperties": false
}
view source ↗

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

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_committees",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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": "Party code as OpenFEC files it, up to three characters (e.g., DEM, REP, LIB, W).",
      "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
    }
  },
  "additionalProperties": false
}
view source ↗

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_get_committee_totals",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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, in any case — 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 code, in any case — 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
    }
  },
  "required": [
    "mode",
    "page",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

openfec_search_contributions

Search itemized contributions (Schedule A) or get aggregate breakdowns by size, state, employer, or occupation. Use to answer "who is funding this committee?" or "where has this donor given?" Itemized mode needs a recipient committee_id or a donor: contributor_id, contributor_name, or contributor_employer. Aggregate by_size/by_state can use candidate_id instead of committee_id.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_contributions",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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. Without committee_id or candidate_id, by_size and by_state return one row per committee and cycle across every committee on file, not a combined breakdown.",
      "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. In itemized mode it scopes the search on its own or narrows a donor scope to gifts to this committee.",
      "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; those cover the full election period ending in cycle (4yr president, 6yr senate, 2yr house).",
      "type": "string"
    },
    "contributor_id": {
      "description": "FEC committee ID of a registered donor (C + eight digits): the receipts recipients reported from it. Earmarked contributions carry the conduit ID here (e.g. ActBlue, C00401224) with the individual in contributor_name. Itemized only.",
      "type": "string"
    },
    "contributor_name": {
      "description": "Full-text donor name search. Itemized only; scopes the search on its own. Without committee_id, a common name can time out upstream — add committee_id or a more specific name.",
      "type": "string"
    },
    "contributor_employer": {
      "description": "Full-text employer search. Itemized only; scopes the search on its own. Without committee_id, an employer scan can time out upstream — add committee_id to narrow it.",
      "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 and for candidate-scoped by_size/by_state, where it names the election: those totals cover the full election period ending in it (4yr president, 6yr senate, 2yr house), not this two-year cycle alone.",
      "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.",
      "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": [
    "mode",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

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

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_disbursements",
    "arguments": {
      "committee_id": "<committee_id>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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.",
      "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": [
    "mode",
    "committee_id",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

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

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_expenditures",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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), largest total first.",
      "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": "Party code as OpenFEC files it, up to three characters (e.g., DEM, REP, LIB, W). Filters on the party of the targeted candidate. 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": "Which Schedule E filings to read. Omitted returns both 24/48-hour notices and periodic-report rows, which overlap: most spending filed on a notice is reported again on the next periodic report of the same spender, so never add the two kinds together. false returns periodic-report rows only, which sum once memo entries (memo_code \"X\") are left out. true returns 24/48-hour notices only — the newest spending, filed before it reaches a periodic report. 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.",
      "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": [
    "mode",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_coordinated_expenditures",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "page",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_search_filings",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "most_recent",
    "page",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_lookup_elections",
    "arguments": {
      "office": "<office>",
      "cycle": "<cycle>"
    }
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "mode": {
      "default": "search",
      "description": "search = candidates in a race with financial totals; with zip, locators for the races covering that ZIP instead. 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. Presidential races are filed under US: omit it or pass US.",
      "type": "string"
    },
    "district": {
      "description": "Two-digit district number (e.g. \"07\"); 00 for an at-large House seat (e.g., WY, AK). Required for house unless zip is provided. Presidential and Senate races are filed under 00: omit it or pass 00.",
      "type": "string"
    },
    "zip": {
      "description": "ZIP code — returns a locator (office, state, district, cycle) for each race covering this ZIP, not candidates; pass a locator back as state and district for that race. 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": [
    "mode",
    "office",
    "cycle"
  ],
  "additionalProperties": false
}
view source ↗

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.

read
invocation
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "openfec_lookup_calendar",
    "arguments": {}
  }
}
schema
{
  "$schema": "https://json-schema.org/draft/2020-12/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), in any case. 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 a blank district upstream, so a numbered district 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
    }
  },
  "required": [
    "mode",
    "page",
    "per_page"
  ],
  "additionalProperties": false
}
view source ↗

Resources

5

Fetch a federal candidate profile with current financial totals and principal_committees. principal_committees lists committees by their current designation, with no cycle — it can include past campaigns' committees and miss one since redesignated. For a given cycle's principal committee, use openfec_lookup_elections (mode: search) and read candidate_pcc_id. Candidate IDs start with H (House), S (Senate), or P (President) followed by exactly eight letters or digits.

uri openfec://candidate/{candidate_id} mime application/json

Fetch a political committee profile with type, designation, and financial summary. Committee IDs start with C followed by exactly eight digits (e.g., C00358796).

uri openfec://committee/{committee_id} mime application/json

Fetch a presidential election race with candidate financial totals. For senate races use openfec://election/{cycle}/S/{state}. For house races use openfec://election/{cycle}/H/{state}/{district}.

uri openfec://election/{cycle}/{office} mime application/json

Fetch a senate race, or the at-large house race of a state or territory with one seat (e.g., WY, AK, DC), with candidate financial totals. A house race here is read as district 00, the district OpenFEC files at-large seats under.

uri openfec://election/{cycle}/{office}/{state} mime application/json

Prompts

2

Multi-step framework for tracing the flow of money around a candidate or race — direct fundraising, PAC support, independent expenditures, and party spending.

  • candidate_name — Candidate name to investigate. Provide this or candidate_id.
  • candidate_id — FEC candidate ID (e.g., P00003392). Provide this or candidate_name.
  • cycle — Election cycle year (e.g., 2024). Defaults to current cycle.

Structured analysis of a candidate's financial position — fundraising trajectory, burn rate, cash reserves, donor composition, and opponent comparison.

  • candidate_name — Candidate name to analyze. Provide this or candidate_id.
  • candidate_id — FEC candidate ID (e.g., P00003392). Provide this or candidate_name.
  • cycle — Election cycle year (e.g., 2024). Defaults to current cycle.

Extensions

1

io.modelcontextprotocol/skills

{
  "directoryRead": true
}