`candidate_financials`

Pack: open-fec · Endpoint: https://gateway.pipeworx.io/open-fec/mcp

Get campaign finance summary for a candidate by their FEC candidate ID (e.g., “P80001571”). Returns total receipts, disbursements, cash on hand, individual contributions, PAC contributions, and loans. Use search_candidates first to find the candidate ID.

Parameters

Name	Type	Required	Description
`_apiKey`	string	yes	OpenFEC API key
`candidate_id`	string	yes	FEC candidate ID (e.g., “P80001571”)
`cycle`	number	no	Election cycle year (e.g., 2024). Defaults to most recent.

Example call

Arguments

{
  "candidate_id": "P80001571",
  "_apiKey": "your-open-fec-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/open-fec/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"candidate_financials","arguments":{"candidate_id":"P80001571","_apiKey":"your-open-fec-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('candidate_financials', {
  "candidate_id": "P80001571",
  "_apiKey": "your-open-fec-api-key"
});

More examples

{
  "candidate_id": "P80001571",
  "cycle": 2024,
  "_apiKey": "your-open-fec-api-key"
}

Response shape

Always returns: candidate_id, cycles

Field	Type	Description
`candidate_id`	string	FEC candidate ID
`cycles`	array	Financial summary for each election cycle

Full JSON Schema

{
  "type": "object",
  "properties": {
    "candidate_id": {
      "type": "string",
      "description": "FEC candidate ID"
    },
    "cycles": {
      "type": "array",
      "description": "Financial summary for each election cycle",
      "items": {
        "type": "object",
        "properties": {
          "candidate_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "FEC candidate ID"
          },
          "candidate_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Candidate name"
          },
          "cycle": {
            "type": [
              "number",
              "null"
            ],
            "description": "Election cycle year"
          },
          "coverage_start": {
            "type": [
              "string",
              "null"
            ],
            "description": "Start date of financial coverage period"
          },
          "coverage_end": {
            "type": [
              "string",
              "null"
            ],
            "description": "End date of financial coverage period"
          },
          "total_receipts": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total campaign receipts in dollars"
          },
          "total_disbursements": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total campaign disbursements in dollars"
          },
          "cash_on_hand": {
            "type": [
              "number",
              "null"
            ],
            "description": "Cash on hand at end of period in dollars"
          },
          "debts_owed": {
            "type": [
              "number",
              "null"
            ],
            "description": "Debts owed by committee in dollars"
          },
          "individual_contributions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total individual contributions in dollars"
          },
          "total_contributions": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total contributions in dollars"
          },
          "pac_contributions": {
            "type": [
              "number",
              "null"
            ],
            "description": "PAC contributions in dollars"
          },
          "candidate_contribution": {
            "type": [
              "number",
              "null"
            ],
            "description": "Candidate's own contributions in dollars"
          },
          "total_loans": {
            "type": [
              "number",
              "null"
            ],
            "description": "Total loans to campaign in dollars"
          },
          "operating_expenditures": {
            "type": [
              "number",
              "null"
            ],
            "description": "Operating expenditures in dollars"
          }
        }
      }
    }
  },
  "required": [
    "candidate_id",
    "cycles"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "open-fec": {
      "url": "https://gateway.pipeworx.io/open-fec/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

candidate_financials