Metadata-Version: 2.4
Name: political-finance-mcp-server
Version: 0.1.0
Summary: MCP server for political finance data: campaign contributions, lobbying, voting records via FEC and OpenSecrets APIs
Project-URL: Homepage, https://github.com/AiAgentKarl/political-finance-mcp-server
Project-URL: Repository, https://github.com/AiAgentKarl/political-finance-mcp-server
License: MIT
Keywords: campaign,fec,finance,lobbying,mcp,political
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# political-finance-mcp-server

MCP server giving AI agents access to US political finance data: campaign contributions, PAC spending, lobbying records, and voting behavior.

## Data Sources
- **FEC API** (Federal Election Commission) — free, no registration required
- **ProPublica Congress API** — free with registration

## Tools

| Tool | Description |
|------|-------------|
| `get_candidate_fundraising` | Campaign contributions and spending by candidate |
| `get_top_donors_by_industry` | Top donors by industry sector |
| `get_pac_spending` | PAC (Political Action Committee) spending data |
| `get_campaign_finance_summary` | Overview of an election cycle's financing |
| `search_individual_donations` | Search donations by individual donor name |
| `get_congress_member_votes` | Voting records for Congress members |

## Installation

```bash
pip install political-finance-mcp-server
```

## Usage with Claude Desktop

```json
{
  "mcpServers": {
    "political-finance": {
      "command": "political-finance-mcp-server"
    }
  }
}
```

## Example Queries

- "How much did the tech industry donate to presidential candidates in 2024?"
- "Show me the top 10 PACs by spending in the 2024 election cycle"
- "Who donated more than $5000 with the last name Musk?"
- "What was Biden's total fundraising vs Trump in 2024?"

## License
MIT
