Skip to main content
Glama
cstillick

guardian-contributions-mcp

by cstillick

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GUARDIAN_DATABASE_URLNoDatabase connection string. Defaults to local SQLite if not set.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_candidatesA

Resolve candidates to committees (Org IDs). Never fuzzy-matches: returns all matches and flags has_multiple_committees so the caller picks the regular-cycle one. Filter by name, district (HD-42/SD-15), office, party ((D)/(R)), or cycle.

get_committeeA

Committee detail by Org ID (Ethics #), including any OTHER committees the same candidate has (surfaces Special-vs-General — Rule 6).

list_district_candidatesC

Every candidate/committee in a House/Senate district (whole-race rollup).

list_filingsB

All reports a committee filed (type, period, amended), newest-first.

get_reportC

One filed report's parsed Schedule Summary (Reporting-Period column).

get_summaryB

Pre-Primary / periodic figures (Beginning, Raised excl-loans, Loans, Expended, Ending). ALWAYS from the parsed report PDF — never re-summed from bulk (Rule 3).

get_contributionsC

Itemized receipts + totals for a committee or a whole district. Optional window (date_from/date_to ISO), receipt_type, and min_amount filters.

get_continuingA

Deduped continuing-window total (Raised vs Loans split), counting each receipt once across however many continuing reports were filed (Appendix C / Rule 2). Defaults to the cycle's computed continuing window.

get_combinedA

The headline number: Pre-Primary base + Continuing layered on top, for one committee (org_id) or every candidate in a district. Recomputes Ending = Beginning + Raised + Loans − Expended; note: Ending omits continuing-period spend.

get_flagsC

Computed alerts: large-loan self-dealing (loan ≥ raised), sub-$1,000 continuing receipts, amended-report-used, multiple committees, no Pre-Primary, no committee found, identity mismatches.

get_calendarB

The cycle's reporting calendar: primary date (3rd Tue of June), Pre-Primary period, and continuing window — computed, not hardcoded (Rule 1).

refresh_statusA

Extract as-of (max Filed/Receipt date) and whether it changed since the prior pull — so an identical re-pull is reported as 'no change' (Rule 13), not a fake update.

queryA

Flexible category selector — pick {who/where} × {what} in one call.

select: any of candidate, committee (Org ID), district, office, party, cycle. category: summary | combined | continuing_total | contributions | loans | report | filing_history | flags. window: {from, to} ISO dates (optional; defaults to the calendar). options: {dedup, min_amount, include_amended}. Returns a uniform envelope {as_of, selection, category, data, caveats}.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
status_resource

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cstillick/guardian-contributions-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server