agent-fecfile

FEC Filing Plugin for Claude Code
A Claude Code plugin for analyzing Federal Election Commission (FEC) campaign finance filings. Includes an and an for API access.
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenVom Herausgeber

A Claude Code plugin for analyzing Federal Election Commission (FEC) campaign finance filings. Includes an and an for API access.
A Claude Code plugin + Agent Skill + MCP Server for analyzing Federal Election Commission (FEC) campaign finance filings.
This plugin enables AI agents to fetch, parse, and analyze FEC filings directly within agent sessions. Parsing and filtering happen outside the model context, allowing agents to programmatically reduce large filings before analysis, saving tokens and enabling efficient queries against filings of any size.
The plugin includes detailed field mappings for common form types and schedules, helping agents accurately interpret campaign finance data like contributions, disbursements, and committee information.
uv globally from their website (using their standard install commands). This ensures your system can find it automatically and allows Claude Desktop to run scripts in the background.You can install this plugin either through Claude Desktop's Code tab, or directly in your terminal if you use Claude Code.
# First, tell Claude where to find this plugin
claude plugin marketplace add hodgesmr/agent-fecfile
# Next, install the plugin
claude plugin install fecfile@agent-fecfile
Note: You may need to restart the app or start a new Code session for the new features to fully load.
Updating: If you need to update to a newer version in the future, run these commands:
claude plugin marketplace update agent-fecfile
claude plugin update fecfile@agent-fecfile
For agent runtimes that support Agent Skills and MCP but not Claude Code plugins (like Codex CLI):
git clone --branch latest [email protected]:hodgesmr/agent-fecfile.git ~/agent-fecfile
# Codex CLI Global install
ln -sfn ~/agent-fecfile/skills/fecfile ~/.codex/skills/fecfile
# Codex CLI
codex mcp add fec-api -- uv run ~/agent-fecfile/mcp-server/server.py
[!IMPORTANT] The MCP server loads the FEC API key from the system keyring on first tool use. You should expect to see a system prompt to authorize Python's access to the key the first time you use
search_committeesorget_filings.
Updating:
cd ~/agent-fecfile && git fetch --tags --force && git checkout latest
Once installed, ask your agent to analyze FEC filings.
[!TIP] For best results, use the most capable AI models available (like Claude Opus). More capable models produce better analysis and more accurate field interpretations.
If you already have an FEC filing ID, you can work with it directly, without needing an API key:
❯ What are the largest expenditures in filing 1896830?
⏺ FEC Filing 1896830 - Largest Expenditures
| # | Recipient | Amount | Date | Purpose |
|-----|----------------------------|-----------|------------|------------------|
| 1 | Trump National Doral Hotel | $1,013.61 | 2025-05-19 | RNC training |
| 2 | Uber.com | $19.77 | 2025-05-06 | Travel - Cabfare |
| | TOTAL (itemized) | $1,033.38 | | |
Note
Only 2 expenditures are itemized on Schedule B. The filing shows $21,283.49 in total
disbursements, meaning most spending (~$20,250) was below the $200 itemization
threshold and appears only in summary totals.
The largest single itemized expense was for RNC training at Trump National Doral Hotel
in May 2025.
❯ Show me a table of the contribution counts and totals, by state, in fec filing 1896830
⏺ FEC Filing 1896830 - Contributions by State
| State | Count | Total | % of Total |
|-------|-------|------------|------------|
| UT | 32 | $35,042.25 | 87.0% |
| VA | 2 | $2,400.00 | 6.0% |
| GA | 1 | $750.00 | 1.9% |
| MI | 1 | $750.00 | 1.9% |
| MD | 2 | $750.00 | 1.9% |
| FL | 1 | $600.00 | 1.5% |
| TOTAL | 39 | $40,292.25 | 100% |
Utah dominates with 87% of the total contributions. The committee received from
6 states total, with only 7 out-of-state contributions.
The MCP server provides committee and filing search via the authenticated FEC API.
To shield the key from LLM model consumption, the API key must be stored in your system keyring. The MCP server uses the Python keyring library, which supports a variety of operating system keyrings.
macOS:
fec-apiapi-keyOnce your API key is stored, queries become more powerful. You can search for committees and filings without knowing the filing ID in advance.
The MCP server provides search_committees and get_filings tools. The API key is loaded once at server startup and kept in memory—it is never visible to the model.
❯ What are the top expenditures in Utah Republican Party's most recent filing?
⏺ Top Expenditures - Utah Republican Party (December 2025)
Filing 1942957 | Coverage: Dec 1-31, 2025 | Total Disbursements: $20,500.65
┌─────────────────────────┬───────────┬────────────────────────┬────────┐
│ Payee │ Amount │ Purpose │ Date │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ USPS │ $4,699.58 │ Direct Mail │ Dec 23 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ CPMI Solutions │ $4,396.30 │ Direct Mailing │ Dec 22 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ NationBuilder │ $2,925.00 │ Office Subscriptions │ Dec 1 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ NationBuilder │ $2,646.00 │ Office Subscriptions │ Dec 29 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Chartwells │ $1,907.24 │ Event Registration Fee │ Dec 17 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Buckeye Premium Finance │ $1,071.48 │ Rent │ Dec 26 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Extra Space Storage │ $487.00 │ Storage │ Dec 2 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Extra Space Storage │ $487.00 │ Storage │ Dec 30 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Ring Central │ $170.31 │ Telephone │ Dec 11 │
├─────────────────────────┼───────────┼────────────────────────┼────────┤
│ Intuit │ $123.57 │ Office Subscriptions │ Dec 24 │
└─────────────────────────┴───────────┴────────────────────────┴────────┘
The bulk of December spending was on direct mail operations (~$9,100 combined
to USPS and CPMI Solutions) and NationBuilder software subscriptions (~$5,600).
agent-fecfile/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest (version source of truth)
│ └── marketplace.json # Marketplace catalog for plugin distribution
├── .mcp.json # MCP server configuration
├── mcp-server/
│ └── server.py # MCP server (authenticated FEC API)
├── skills/fecfile/
│ ├── SKILL.md # Agent Skill instructions
│ ├── references/ # Form and schedule documentation
│ │ ├── FORMS.md # Reference for FEC form types (F1, F2, F3, F99)
│ │ └── SCHEDULES.md # Field mappings for Schedules A, B, C, D, E
│ └── scripts/
│ └── fetch_filing.py # Fetches FEC filing data (public API)
├── README.md # Installation and usage for end users
├── CHANGELOG.md # Version history
└── release.sh # Automated release script
The MCP server:
search_committees and get_filings toolsNetwork access: This plugin requires network access to fetch data from the FEC (docquery.fec.gov, api.open.fec.gov). It will not work in environments where external network access is restricted.
Untrusted content: FEC filings should be considered untrusted content. A malicious campaign sneaking prompt injections into the memo text field of their F99 is probably unlikely, but not impossible.
Keyring access: The MCP server accesses the keyring on first tool use. You should expect a system prompt (e.g., "Python wants to access your keychain") when your agent first calls the MCP server. This is normal. The key is held in the MCP server's memory for the session duration. You should not see keyring prompts at any other time; if you do, investigate.
A Claude Code plugin + Agent Skill + MCP Server for analyzing Federal Election Commission (FEC) campaign finance filings.
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Agent Fecfile läuft lokal über stdio.
Zuletzt geprüft: 2026-10-27. A Claude Code plugin + Agent Skill + MCP Server for analyzing Federal Election Commission (FEC) campaign finance filings.