Server definition
- Hash
- sha256:2f6193e41590e00ed990beef4fecd931aee25ebdfd37652aa244f59d7d0e5efd
- What it is
- What a remote MCP server returned when asked what it offers: 12 tools
The blob, as servednamed by its sha256
{
"instructions": "Use the openfec_* tools for US federal campaign finance data: candidates, committees, contributions (Schedule A), disbursements (Schedule B), independent expenditures (Schedule E), filings, elections, calendar, and legal documents. Candidate IDs use H/S/P prefixes (House/Senate/President); committee IDs use C. Cycles are even-year integers covering the prior 2 years (2024 = Jan 2023 – Dec 2024). Itemized contributions and disbursements scope to committee_id, not candidate_id.",
"tools": [
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"committee_designation": {
"description": "Committee designation — A (authorized), B (lobbyist PAC), D (leadership PAC), J (joint fundraiser), P (principal campaign), U (unauthorized). by_entity_type mode only.",
"type": "string"
},
"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"
},
"committee_state": {
"description": "Two-letter state code of the committee. by_entity_type mode only.",
"type": "string"
},
"committee_type": {
"description": "Committee type code — H (House), S (Senate), P (Presidential), O (Super PAC), N/Q (PAC), X/Y (party). by_entity_type mode only.",
"type": "string"
},
"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"
},
"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.",
"enum": [
"presidential",
"pac",
"party",
"pac-party",
"house-senate",
"ie-only"
],
"type": "string"
},
"max_disbursements": {
"description": "Maximum total disbursements 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"
},
"min_receipts": {
"description": "Minimum total receipts in dollars. by_entity_type mode only.",
"type": "number"
},
"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.",
"enum": [
"single",
"by_entity_type"
],
"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"
},
"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.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 20,
"description": "Results per page.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"enum": [
"cycle",
"-cycle",
"receipts",
"-receipts",
"disbursements",
"-disbursements",
"last_cash_on_hand_end_period",
"-last_cash_on_hand_end_period"
],
"type": "string"
}
},
"type": "object"
},
"name": "openfec_get_committee_totals",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `committee_id_required_for_single_mode`: Mode single invoked without a committee_id. `entity_type_required_for_group_mode`: Mode by_entity_type invoked without an entity_type. `inputs_not_applicable_to_mode`: A grouped-search filter (entity_type, committee_state, committee_type, committee_designation, organization_type, or a receipts/disbursements bound) was supplied alongside mode single, which cannot apply it. `committee_totals_not_found`: Single-committee lookup matched no totals row — the committee_id does not exist, it filed nothing in the requested cycle, or it has never filed a financial report at all. Other values are possible when a failure originates below the handler.",
"examples": [
"committee_id_required_for_single_mode",
"entity_type_required_for_group_mode",
"inputs_not_applicable_to_mode",
"committee_totals_not_found"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. Rows mean different things by mode — single rows are cycles of one committee, by_entity_type rows are different committees — so read this rather than inferring from the fields present.",
"enum": [
"single",
"by_entity_type"
],
"type": "string"
},
"notice": {
"description": "Guidance when the response carries no totals: how to broaden a search that matched nothing, or which requested position ran out when totals did match.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Committee totals result set; one row per cycle in single mode, one row per committee in by_entity_type mode.",
"items": {
"additionalProperties": {},
"description": "Committee totals row for one committee and cycle; common keys include committee_id, committee_name, cycle, receipts, disbursements, last_cash_on_hand_end_period, last_debts_owed_by_committee, individual_contributions, and coverage_end_date.",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"totalCount": {
"description": "Total matching totals rows before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Fetch one FEC legal document — advisory opinion, MUR, ADR, administrative fine, or statute — by its type and number. openfec_search_legal replaces each result's documents and dispositions arrays with a count and category summary and cuts every commission vote down to a date and a 200-character action; this returns the record as upstream sends it, whole when it fits the 100,000-byte response budget. A larger record returns its scalar fields and the arrays that fit, with the rest listed in withheld; page through one by re-calling with array and offset. doc_type is the plural form of the document_type discriminator on a search result (advisory_opinion becomes advisory_opinions, mur becomes murs, adr becomes adrs, admin_fine becomes admin_fines, statute becomes statutes), and no is that result's no field — every document type carries it, and advisory opinions repeat it as ao_no.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"array": {
"description": "Name of one top-level array field of the record to page through by entry — usually one listed in withheld when the record was too large to return whole (e.g. \"dispositions\", \"documents\"). Returns that array's entries from offset while they fit the response budget, in slice, with the record's scalar fields. Omit to fetch the record itself.",
"minLength": 1,
"type": "string"
},
"doc_type": {
"description": "Legal document type, always plural. openfec_search_legal reports the singular form in each result document_type — advisory_opinion, mur, adr, admin_fine, statute — so add an \"s\" to get the value this field wants.",
"enum": [
"advisory_opinions",
"murs",
"adrs",
"admin_fines",
"statutes"
],
"type": "string"
},
"no": {
"description": "Document number, copied from the no field of the matching openfec_search_legal result. Advisory opinions are year-serial (e.g. \"2024-01\", also repeated as ao_no); murs, adrs, and admin_fines are digit strings (e.g. \"8363\"); statutes are U.S. Code section numbers (e.g. \"30123\").",
"minLength": 1,
"type": "string"
},
"offset": {
"description": "Entry offset (0-indexed) into array. Requires array; defaults to 0 when array is given. Pass the next_offset a previous slice returned to continue.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"doc_type",
"no"
],
"type": "object"
},
"name": "openfec_get_legal_document",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"document",
"search_criteria",
"attachedDocumentCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"attachedDocumentCount": {
"description": "Number of related filings in the record documents array — the full count, whether this response carries them in document, in a slice, or holds them back. Compare against the document_count openfec_search_legal reported for the same record.",
"type": "number"
},
"document": {
"additionalProperties": {},
"description": "The legal document record, fields as upstream sends them — the full documents array openfec_search_legal summarizes, the complete dispositions and commission_votes entries, and the scalar and date fields (name, type, url, penalty and determination amounts, case dates). Whole when it fits the 100,000-byte response budget; otherwise the scalar fields and the arrays that fit, with the rest in withheld. With array set, the record's non-array fields only — the entries are in slice. Fields present vary by document type.",
"properties": {},
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `legal_document_not_found`: No legal document exists at the requested doc_type and document number. `array_not_in_record`: The array input names a field this record does not carry as an array. `offset_without_array`: offset was given without array, so there is no array for it to index. Other values are possible when a failure originates below the handler.",
"examples": [
"legal_document_not_found",
"array_not_in_record",
"offset_without_array"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "How to continue: which arrays were held back and how to page them, where a slice continues, or that an offset ran past the end of its array.",
"type": "string"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"slice": {
"additionalProperties": false,
"description": "A run of the requested array. Present only when array was given.",
"properties": {
"array": {
"description": "The array these entries come from.",
"type": "string"
},
"entries": {
"description": "Entries from offset, as many as fit the response budget — at least one while offset is inside the array.",
"items": {
"description": "One entry, exactly as the record carries it."
},
"type": "array"
},
"next_offset": {
"description": "Offset that continues the array. Absent once the last entry is here.",
"type": "number"
},
"offset": {
"description": "Offset (0-indexed) of the first entry here.",
"type": "number"
},
"total": {
"description": "Entries in the whole array.",
"type": "number"
}
},
"required": [
"array",
"offset",
"total",
"entries"
],
"type": "object"
},
"withheld": {
"description": "Arrays held back from document because the whole record exceeds the 100,000-byte response budget, smallest first. Page through one by re-calling with array set to its name. Absent when document is the whole record.",
"items": {
"additionalProperties": false,
"description": "One array held back from document.",
"properties": {
"array": {
"description": "Name of the array field held back — pass it as array.",
"type": "string"
},
"bytes": {
"description": "Size of the whole array as JSON, in UTF-8 bytes.",
"type": "number"
},
"count": {
"description": "Entries in the array.",
"type": "number"
}
},
"required": [
"array",
"count",
"bytes"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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.",
"enum": [
"20",
"21",
"22",
"23",
"24",
"25",
"26",
"27",
"28",
"29",
"32",
"33",
"34",
"36",
"37",
"38",
"39",
"40"
],
"type": "string"
},
"description": {
"description": "Full-text event description search. Events mode.",
"type": "string"
},
"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 no district upstream, so a district filter never matches them. Election dates mode.",
"type": "string"
},
"election_year": {
"description": "Election year. Election dates mode.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"max_date": {
"description": "Latest date (YYYY-MM-DD).",
"type": "string"
},
"min_date": {
"description": "Earliest date (YYYY-MM-DD).",
"type": "string"
},
"mode": {
"default": "events",
"description": "events = FEC calendar events. filing_deadlines = report due dates. election_dates = upcoming/past elections.",
"enum": [
"events",
"filing_deadlines",
"election_dates"
],
"type": "string"
},
"office": {
"description": "Office sought (H=House, S=Senate, P=President). Election dates mode.",
"enum": [
"H",
"S",
"P"
],
"type": "string"
},
"page": {
"default": 1,
"description": "Page number (1-indexed). Default 1.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 20,
"description": "Results per page. Default 20, max 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"report_type": {
"description": "Report type code (e.g. \"Q1\", \"Q2\"). Filing deadlines mode only.",
"type": "string"
},
"report_year": {
"description": "Report year. Filing deadlines mode.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"state": {
"description": "Two-letter state code (e.g., AZ, CA). Primarily for election_dates mode.",
"type": "string"
}
},
"type": "object"
},
"name": "openfec_lookup_calendar",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `inputs_not_applicable_to_mode`: A filter belonging to a different calendar mode was supplied, which the chosen mode cannot apply. Other values are possible when a failure originates below the handler.",
"examples": [
"inputs_not_applicable_to_mode"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. Each mode reads a different FEC dataset with its own row shape — calendar events, report due dates, or election dates — so read this rather than inferring the dataset from the fields present.",
"enum": [
"events",
"filing_deadlines",
"election_dates"
],
"type": "string"
},
"notice": {
"description": "Guidance when the response carries no calendar entries: how to broaden a search that matched nothing, or which requested position ran out when entries did match.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Calendar result set; events, filing deadlines, or election dates depending on mode.",
"items": {
"additionalProperties": {},
"description": "Event record (mode=events), filing deadline record (mode=filing_deadlines), or election date record (mode=election_dates).",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"totalCount": {
"description": "Total matching calendar entries before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"cycle": {
"description": "Election cycle year (even years only, e.g. 2024).",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"district": {
"description": "Two-digit district number (e.g. \"07\"). Required for house unless zip is provided.",
"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"
},
"mode": {
"default": "search",
"description": "search = candidates in a race with financial totals. summary = aggregate race financial summary.",
"enum": [
"search",
"summary"
],
"type": "string"
},
"office": {
"description": "Office sought: H=House, S=Senate, P=President.",
"enum": [
"H",
"S",
"P"
],
"type": "string"
},
"page": {
"description": "Page number (1-indexed). Search mode only; explicit page is rejected in summary mode. Defaults to 1 for search.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page. Search mode only; defaults to 20.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"state": {
"description": "Two-letter US state code (e.g., AZ, CA). Required for senate/house unless zip is provided.",
"type": "string"
},
"zip": {
"description": "ZIP code — finds races covering this ZIP. Search mode only.",
"type": "string"
}
},
"required": [
"office",
"cycle"
],
"type": "object"
},
"name": "openfec_lookup_elections",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `cycle_must_be_even`: Cycle is an odd year. `missing_state_for_office`: Senate or House office without a state and without a zip. `missing_district_for_house`: House office without a district number and without a zip. `summary_does_not_support_zip`: Summary mode invoked with a zip parameter. `inputs_not_applicable_to_mode`: The resolved elections endpoint does not accept one or more explicitly supplied inputs. Other values are possible when a failure originates below the handler.",
"examples": [
"cycle_must_be_even",
"missing_state_for_office",
"missing_district_for_house",
"summary_does_not_support_zip",
"inputs_not_applicable_to_mode"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. Row shapes differ by mode — search rows are per-candidate financial records, summary is one aggregate race row — so read this rather than inferring the shape from the fields present.",
"enum": [
"search",
"summary"
],
"type": "string"
},
"notice": {
"description": "Guidance when the response carries no election results: how to broaden a search that matched nothing, or which requested position ran out when results did match.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Election race result set; candidate financial rows in search mode, a single aggregate summary row in summary mode.",
"items": {
"additionalProperties": {},
"description": "Candidate financial row (search mode) or aggregate race summary (summary mode).",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"totalCount": {
"description": "Total matching candidates or race summaries.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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"
},
"candidate_status": {
"description": "Candidate status: C=present, F=future, N=not yet, P=prior.",
"enum": [
"C",
"F",
"N",
"P"
],
"type": "string"
},
"cycle": {
"description": "Two-year election cycle (even year, e.g., 2024).",
"type": "number"
},
"district": {
"description": "Two-digit district number for House candidates.",
"type": "string"
},
"election_year": {
"description": "Specific election year the candidate ran in.",
"type": "number"
},
"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"
},
"incumbent_challenge": {
"description": "Incumbent status: I=incumbent, C=challenger, O=open seat.",
"enum": [
"I",
"C",
"O"
],
"type": "string"
},
"office": {
"description": "Filter by office: H=House, S=Senate, P=President.",
"enum": [
"H",
"S",
"P"
],
"type": "string"
},
"page": {
"description": "Search-results page number (1-indexed). Defaults to 1 on the search path.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"party": {
"description": "Three-letter party code (e.g., DEM, REP, LIB).",
"type": "string"
},
"per_page": {
"description": "Search results per page. Defaults to 20 on the search path. With include_totals, at most 35 candidates are requested when cycle or election_year scopes the totals and 5 when the totals span every cycle, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Full-text candidate name search.",
"type": "string"
},
"state": {
"description": "Two-letter US state code (e.g., AZ, CA).",
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_candidates",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"candidates",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"candidates": {
"description": "Candidate result set; one record per match.",
"items": {
"additionalProperties": {},
"description": "Candidate record; common keys include candidate_id, name, party, state, office, and cycles.",
"properties": {},
"type": "object"
},
"type": "array"
},
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `candidate_not_found`: Single-candidate lookup by candidate_id returned no record. `inputs_not_applicable_to_id_lookup`: A direct candidate_id lookup includes search-only inputs, or totals-only scope while include_totals is false. Other values are possible when a failure originates below the handler.",
"examples": [
"candidate_not_found",
"inputs_not_applicable_to_id_lookup"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"missing_totals": {
"description": "Candidates whose financial totals were not retrieved because the totals fetch hit its page cap. Re-query each one on its own with candidate_id to get its totals.",
"items": {
"description": "FEC candidate ID with no totals row in this response.",
"type": "string"
},
"type": "array"
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when candidates did match, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching candidates before pagination.",
"type": "number"
},
"totals": {
"description": "Financial totals (receipts, disbursements, cash_on_hand) when include_totals is true. One row per candidate per cycle.",
"items": {
"additionalProperties": {},
"description": "Per-cycle financial totals row for a candidate committee.",
"properties": {},
"type": "object"
},
"type": "array"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"candidate_id": {
"description": "Find committees linked to this candidate (authorized, leadership, joint fundraising). Get IDs from openfec_search_candidates results.",
"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"
},
"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"
},
"cycle": {
"description": "Two-year election cycle (even year).",
"type": "number"
},
"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"
},
"page": {
"description": "Search-results page number (1-indexed). Defaults to 1 on the search path.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"party": {
"description": "Three-letter party code (e.g., DEM, REP).",
"type": "string"
},
"per_page": {
"description": "Search results per page. Defaults to 20 on the search path.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"query": {
"description": "Full-text committee name search.",
"type": "string"
},
"state": {
"description": "Two-letter state code.",
"type": "string"
},
"treasurer_name": {
"description": "Full-text treasurer name search.",
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_committees",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"committees",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"committees": {
"description": "Committee result set; one record per match.",
"items": {
"additionalProperties": {},
"description": "Committee record; common keys include committee_id, name, type, designation, party, and state.",
"properties": {},
"type": "object"
},
"type": "array"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `committee_not_found`: Single-committee lookup by committee_id returned no record. `inputs_not_applicable_to_id_lookup`: A direct committee_id lookup includes inputs that only the committee search endpoint supports. Other values are possible when a failure originates below the handler.",
"examples": [
"committee_not_found",
"inputs_not_applicable_to_id_lookup"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when the response carries no committees: how to broaden a search that matched nothing, or which requested position ran out when committees did match.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"totalCount": {
"description": "Total matching committees before pagination.",
"type": "number"
}
},
"type": "object"
}
},
{
"description": "Search itemized individual contributions (Schedule A) or get aggregate breakdowns by size, state, employer, or occupation. Use to answer \"who is funding this committee?\" Itemized mode requires a committee_id. Aggregate by_size/by_state can use candidate_id instead.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"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.",
"type": "string"
},
"committee_id": {
"description": "Receiving committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.",
"type": "string"
},
"contributor_city": {
"description": "Contributor city. Itemized only.",
"type": "string"
},
"contributor_employer": {
"description": "Full-text employer search. Itemized only.",
"type": "string"
},
"contributor_name": {
"description": "Full-text donor name search. Itemized only.",
"type": "string"
},
"contributor_occupation": {
"description": "Full-text occupation search. 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"
},
"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"
},
"cycle": {
"description": "Two-year election cycle (e.g., 2024). Even years only. Defaults to current cycle for itemized mode.",
"type": "number"
},
"is_individual": {
"description": "Only individual contributions (excludes committee-to-committee transfers). Itemized only.",
"type": "boolean"
},
"max_amount": {
"description": "Maximum contribution amount in dollars. Itemized only.",
"type": "number"
},
"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"
},
"min_date": {
"description": "Earliest contribution date (YYYY-MM-DD). Itemized only.",
"type": "string"
},
"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.",
"enum": [
"itemized",
"by_size",
"by_state",
"by_employer",
"by_occupation"
],
"type": "string"
},
"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.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 20,
"description": "Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"enum": [
"contribution_receipt_date",
"-contribution_receipt_date",
"contribution_receipt_amount",
"-contribution_receipt_amount"
],
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_contributions",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"committee": {
"additionalProperties": {},
"description": "The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own committee object.",
"properties": {},
"type": "object"
},
"count": {
"description": "Total matching contributions (itemized mode). Check count_is_approximate before quoting it as a figure.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports count as an estimate rather than a tally, which it does on its highest-volume queries. Absent means the count is a tally.",
"type": "boolean"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id. `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id. `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it. `inputs_not_applicable_to_mode`: The resolved Schedule A endpoint does not accept one or more explicitly supplied inputs. Other values are possible when a failure originates below the handler.",
"examples": [
"itemized_requires_committee_id",
"aggregate_requires_committee_id",
"itemized_only_filters_in_aggregate_mode",
"inputs_not_applicable_to_mode"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. \"by_size\" and \"by_state\" resolve to \"by_size_candidate\" / \"by_state_candidate\" when scoped by candidate_id — a different endpoint with different row shapes — so read this rather than assuming the mode you sent.",
"enum": [
"itemized",
"by_size",
"by_state",
"by_employer",
"by_occupation",
"by_size_candidate",
"by_state_candidate"
],
"type": "string"
},
"next_cursor": {
"description": "Pagination cursor for the next page of itemized results. Null when no more pages.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when contributions did match, that the total is an estimate, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination info (aggregate modes only).",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Contribution result set; itemized records or aggregate buckets depending on mode.",
"items": {
"additionalProperties": {},
"description": "Itemized contribution record (mode=itemized) or aggregate row (mode=by_size, by_state, by_employer, by_occupation).",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching contributions or aggregate rows.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"candidate_id": {
"description": "Benefiting candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
"type": "string"
},
"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"
},
"cycle": {
"description": "Two-year election cycle (e.g., 2024). Even years only. Omitting it searches every cycle on record.",
"type": "number"
},
"max_amount": {
"description": "Maximum expenditure amount in dollars.",
"type": "number"
},
"max_date": {
"description": "Latest expenditure date (YYYY-MM-DD).",
"type": "string"
},
"min_amount": {
"description": "Minimum expenditure amount in dollars.",
"type": "number"
},
"min_date": {
"description": "Earliest expenditure date (YYYY-MM-DD).",
"type": "string"
},
"page": {
"default": 1,
"description": "Page number (1-indexed). Read pagination.pages in the response to see how many pages exist.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"payee_name": {
"description": "Full-text payee name search (the vendor the party paid).",
"type": "string"
},
"per_page": {
"default": 20,
"description": "Results per page. At most 80 are requested upstream when scoped by committee_id and 25 otherwise, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"enum": [
"expenditure_date",
"-expenditure_date",
"expenditure_amount",
"-expenditure_amount"
],
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_coordinated_expenditures",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"committee": {
"additionalProperties": {},
"description": "The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own committee object.",
"properties": {},
"type": "object"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when expenditures did match, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Coordinated expenditure result set; one record per itemized transaction.",
"items": {
"additionalProperties": {},
"description": "Coordinated expenditure record; common keys include expenditure_date, expenditure_amount, payee_name, candidate_id, candidate_name, candidate_office, expenditure_type_full, pdf_url, and subordinate_committee_id — the committee the expenditure was attributed to, which is usually the spender but can be another committee; look it up with openfec_search_committees.",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching coordinated expenditures before pagination.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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?\"",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"committee_id": {
"description": "Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results. Required for all modes.",
"minLength": 1,
"type": "string"
},
"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"
},
"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"
},
"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"
},
"max_amount": {
"description": "Maximum amount in dollars. Itemized only.",
"type": "number"
},
"max_date": {
"description": "Latest disbursement date (YYYY-MM-DD). Itemized only.",
"type": "string"
},
"min_amount": {
"description": "Minimum amount in dollars. Itemized only.",
"type": "number"
},
"min_date": {
"description": "Earliest disbursement date (YYYY-MM-DD). Itemized only.",
"type": "string"
},
"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).",
"enum": [
"itemized",
"by_purpose",
"by_recipient",
"by_recipient_id"
],
"type": "string"
},
"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.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 20,
"description": "Results per page. Itemized mode sends at most 30 upstream, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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"
},
"recipient_name": {
"description": "Full-text payee name search. Itemized only.",
"type": "string"
},
"recipient_state": {
"description": "Recipient state. Itemized only.",
"type": "string"
},
"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.",
"enum": [
"disbursement_date",
"-disbursement_date",
"disbursement_amount",
"-disbursement_amount"
],
"type": "string"
}
},
"required": [
"committee_id"
],
"type": "object"
},
"name": "openfec_search_disbursements",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"committee": {
"additionalProperties": {},
"description": "The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own committee object.",
"properties": {},
"type": "object"
},
"count": {
"description": "Total matching disbursements (itemized mode). Check count_is_approximate before quoting it as a figure.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports count as an estimate rather than a tally, which it does on its highest-volume queries. Absent means the count is a tally.",
"type": "boolean"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it. `inputs_not_applicable_to_mode`: Itemized mode receives an explicit page number that its keyset endpoint cannot apply. Other values are possible when a failure originates below the handler.",
"examples": [
"itemized_only_filters_in_aggregate_mode",
"inputs_not_applicable_to_mode"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. Row shapes differ by mode — itemized rows are individual payments, aggregate rows are buckets with a total — so read this rather than inferring the shape from the fields present.",
"enum": [
"itemized",
"by_purpose",
"by_recipient",
"by_recipient_id"
],
"type": "string"
},
"next_cursor": {
"description": "Pagination cursor for the next page of itemized results. Null when no more pages.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when disbursements did match, that the total is an estimate, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination info (aggregate modes only).",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Disbursement result set; itemized records or aggregate buckets depending on mode.",
"items": {
"additionalProperties": {},
"description": "Itemized disbursement record (mode=itemized) or aggregate row (mode=by_purpose, by_recipient, by_recipient_id).",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching disbursements or aggregate rows.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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).",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"candidate_id": {
"description": "Targeted candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
"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.",
"enum": [
"H",
"S",
"P"
],
"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_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_party": {
"description": "Three-letter party code of the targeted candidate (e.g., DEM, REP). Itemized only — by_candidate rejects it, since the aggregate endpoint has no party filter.",
"type": "string"
},
"committee_id": {
"description": "Spending committee ID (e.g., C00703975). Get IDs from openfec_search_committees results.",
"type": "string"
},
"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"
},
"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"
},
"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"
},
"is_notice": {
"description": "Only 24/48-hour notice filings (near-election spending). Itemized only.",
"type": "boolean"
},
"max_amount": {
"description": "Maximum expenditure amount in dollars. Itemized only.",
"type": "number"
},
"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"
},
"min_date": {
"description": "Earliest expenditure date (YYYY-MM-DD). Itemized only.",
"type": "string"
},
"mode": {
"default": "itemized",
"description": "Query mode. \"itemized\" returns individual expenditure records (keyset pagination). \"by_candidate\" returns aggregated totals per candidate by committee (page-based).",
"enum": [
"itemized",
"by_candidate"
],
"type": "string"
},
"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"
},
"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.",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"payee_name": {
"description": "Full-text payee name search. Itemized only.",
"type": "string"
},
"per_page": {
"default": 20,
"description": "Results per page. Itemized mode sends at most 60 upstream when scoped by committee_id and 30 otherwise, keeping the response under a 100,000-byte budget; a page bounded below your request reports truncated and cap, and next_cursor continues it.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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.",
"enum": [
"expenditure_date",
"-expenditure_date",
"expenditure_amount",
"-expenditure_amount",
"office_total_ytd",
"-office_total_ytd"
],
"type": "string"
},
"support_oppose": {
"description": "S = support, O = oppose. Filter by whether the expenditure supports or opposes the candidate.",
"enum": [
"S",
"O"
],
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_expenditures",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"mode",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"committee": {
"additionalProperties": {},
"description": "The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own committee object.",
"properties": {},
"type": "object"
},
"count": {
"description": "Total matching independent expenditures (itemized mode). Check count_is_approximate before quoting it as a figure.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports count as an estimate rather than a tally, which it does on its highest-volume queries. Absent means the count is a tally.",
"type": "boolean"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `by_candidate_requires_scope`: by_candidate mode invoked without a candidate_id and without a full race scope. `itemized_only_filters_in_aggregate_mode`: An itemized-only filter (payee_name, candidate_party, a date or amount bound, is_notice, most_recent, sort, cursor) was supplied alongside mode by_candidate, which cannot apply it. `inputs_not_applicable_to_mode`: Itemized mode receives an explicit page number or election_full, neither of which its keyset endpoint can apply. Other values are possible when a failure originates below the handler.",
"examples": [
"by_candidate_requires_scope",
"itemized_only_filters_in_aggregate_mode",
"inputs_not_applicable_to_mode"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"mode": {
"description": "Query mode as the server resolved it. Row shapes differ by mode — itemized rows are individual expenditures, by_candidate rows are per-candidate totals — so read this rather than inferring the shape from the fields present.",
"enum": [
"itemized",
"by_candidate"
],
"type": "string"
},
"next_cursor": {
"description": "Pagination cursor for the next page of itemized results. Null when no more pages.",
"type": [
"string",
"null"
]
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when expenditures did match, that the total is an estimate, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination info (by_candidate mode only).",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Expenditure result set; itemized records or per-candidate aggregates depending on mode.",
"items": {
"additionalProperties": {},
"description": "Itemized independent expenditure record (mode=itemized) or per-candidate aggregate row (mode=by_candidate).",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching expenditures or per-candidate aggregates.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"candidate_id": {
"description": "Associated candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results.",
"type": "string"
},
"committee_id": {
"description": "Filing committee ID (e.g., C00358796). Get IDs from openfec_search_committees results.",
"type": "string"
},
"cycle": {
"description": "Two-year election cycle (even year).",
"type": "number"
},
"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"
},
"is_amended": {
"description": "Filter to original or amended filings only.",
"type": "boolean"
},
"max_receipt_date": {
"description": "Latest FEC receipt date (YYYY-MM-DD).",
"type": "string"
},
"min_receipt_date": {
"description": "Earliest date FEC received the filing (YYYY-MM-DD).",
"type": "string"
},
"most_recent": {
"default": true,
"description": "Only the most recent version (filters out superseded amendments).",
"type": "boolean"
},
"page": {
"default": 1,
"description": "Page number (1-indexed).",
"maximum": 9007199254740991,
"minimum": 1,
"type": "integer"
},
"per_page": {
"default": 20,
"description": "Results per page. At most 65 are requested upstream, keeping the response under a 100,000-byte budget. A page bounded below your request reports truncated and cap, and pagination.per_page echoes the size applied — page numbers count at that size, so continue with the next page number.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"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"
}
},
"type": "object"
},
"name": "openfec_search_filings",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"pagination",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"cap": {
"description": "The per_page this call applied in place of the one requested — the page-size ceiling for this tool and scope. Present only when truncated is true.",
"type": "number"
},
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode.",
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"notice": {
"description": "Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when filings did match, that the total is an estimate, or that the page was bounded below the per_page requested and how to continue.",
"type": "string"
},
"pagination": {
"additionalProperties": false,
"description": "Page-based pagination metadata.",
"properties": {
"count": {
"description": "Total result count.",
"type": "number"
},
"count_is_approximate": {
"description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
"type": "boolean"
},
"page": {
"description": "Current page number (1-indexed).",
"type": "number"
},
"pages": {
"description": "Total number of pages.",
"type": "number"
},
"per_page": {
"description": "Results per page.",
"type": "number"
}
},
"required": [
"page",
"pages",
"count",
"per_page"
],
"type": "object"
},
"results": {
"description": "Filing result set; one record per match.",
"items": {
"additionalProperties": {},
"description": "Filing record; common keys include form_type, committee_id, committee_name, report_type, financial totals, and pdf_url.",
"properties": {},
"type": "object"
},
"type": "array"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Rows in this page. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching filings before pagination.",
"type": "number"
},
"truncated": {
"description": "True when this page holds fewer rows than the per_page requested because a full page would exceed the 100,000-byte response budget, and more rows remain. Absent on a complete page, including a naturally short last page.",
"type": "boolean"
}
},
"type": "object"
}
},
{
"description": "Search FEC legal documents: advisory opinions, enforcement cases (MURs), alternative dispute resolutions, administrative fines, and statutes. The citation, penalty, respondent, ao_number, and case_number filters each apply to only some document types; with type omitted, the search returns only the types every one of them applies to. Each response is held to 100,000 bytes: when a page would exceed it, whole results are held back and nextFromHit gives the from_hit that continues each document type.",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"ao_number": {
"description": "Specific advisory opinion number (e.g. \"2024-01\"). Applies to advisory_opinions only: rejected with any other type, and with type omitted only advisory opinions are returned.",
"type": "string"
},
"case_number": {
"description": "Specific MUR, ADR, or administrative fine case number (e.g. \"8343\"). Applies to murs, adrs, and admin_fines: rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
"type": "string"
},
"date_kind": {
"description": "Which date min_date/max_date bound. Each document type records its own dates, so this must be one the chosen type has: type=advisory_opinions → issue_date (opinion issued), request_date (request received), document_date; type=murs or adrs → open_date (case opened), close_date (case closed), document_date; type=admin_fines → rtb_date (reason-to-believe finding), fd_date (final determination). type=statutes cannot be date-filtered. Required whenever min_date or max_date is given, together with type.",
"enum": [
"issue_date",
"request_date",
"open_date",
"close_date",
"document_date",
"rtb_date",
"fd_date"
],
"type": "string"
},
"from_hit": {
"default": 0,
"description": "Offset for pagination (0-indexed), counted within each document type rather than across them. Default 0. When a response is bounded, nextFromHit gives the value that continues each type. The search index serves a 10,000-result window, so from_hit plus hits_returned must be 10,000 or less — the ceiling here assumes hits_returned of 1.",
"maximum": 9999,
"minimum": 0,
"type": "integer"
},
"hits_returned": {
"default": 20,
"description": "Results per page, applied per document type. Default 20, max 200. A response is held to 100,000 bytes, so a page of large records can carry fewer, with nextFromHit naming where each type continues. Bounded together with from_hit by the 10,000-result window.",
"maximum": 200,
"minimum": 1,
"type": "integer"
},
"max_date": {
"description": "Latest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.",
"type": "string"
},
"max_penalty_amount": {
"description": "Maximum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
"type": "number"
},
"min_date": {
"description": "Earliest date (YYYY-MM-DD) for the date_kind selected. Requires type and date_kind.",
"type": "string"
},
"min_penalty_amount": {
"description": "Minimum penalty amount in dollars. Applies to murs, adrs, and admin_fines (an administrative fine matches on its reason-to-believe or final-determination amount): rejected with advisory_opinions or statutes, and with type omitted only those three types are returned.",
"type": "number"
},
"query": {
"description": "Full-text search across legal documents.",
"type": "string"
},
"regulatory_citation": {
"description": "CFR citation in the form \"<title> CFR <part>.<section>\" (e.g. \"11 CFR 110.1\"; \"C.F.R.\", \"§\", and a suffix such as \"110.1(b)\" are accepted — a bare \"110.1\" is rejected as invalid_citation). One citation per value: \"11 CFR 110.1; 11 CFR 110.2\" is rejected, since only the first would be applied. Given with statutory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.",
"type": "string"
},
"respondent": {
"description": "Respondent name. Applies to enforcement cases (murs, adrs) only: rejected with any other type, and with type omitted only MURs and ADRs are returned.",
"type": "string"
},
"statutory_citation": {
"description": "U.S.C. citation in the form \"<title> U.S.C. <section>\" (e.g. \"52 U.S.C. 30104\"; \"USC\", \"§\", and a suffix such as \"30104(g)\" are accepted — a bare \"30104\" is rejected as invalid_citation). One citation per value: \"52 U.S.C. 30104, 52 U.S.C. 30118\" is rejected, since only the first would be applied. Given with regulatory_citation, matches a document that cites either one. On murs and adrs it cannot be combined with case_number, respondent, a penalty bound, or an open_date or close_date bound, which the search index would ignore. Applies to advisory_opinions, murs, and adrs: rejected with admin_fines or statutes, and with type omitted only those three types are returned.",
"type": "string"
},
"type": {
"description": "Document type filter. Omit to search every type the other filters apply to — all five when only query is given. admin_fines can be slow without a query.",
"enum": [
"advisory_opinions",
"murs",
"adrs",
"admin_fines",
"statutes"
],
"type": "string"
}
},
"type": "object"
},
"name": "openfec_search_legal",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"anyOf": [
{
"not": {
"required": [
"error"
]
},
"required": [
"results",
"total_count",
"search_criteria",
"totalCount"
]
},
{
"required": [
"error"
]
}
],
"properties": {
"error": {
"additionalProperties": {},
"description": "Present when the call failed. Absent on success.",
"properties": {
"code": {
"description": "JSON-RPC error code for this failure.",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"type": "integer"
},
"data": {
"additionalProperties": {},
"properties": {
"reason": {
"description": "Machine-readable failure mode. Declared by this tool: `missing_filter`: Called without any scoping filter at all. `date_filter_incomplete`: min_date or max_date given without both a type and a date_kind, or a date_kind given with neither bound. `date_kind_not_valid_for_type`: The requested date_kind is not a date this document type records. `filter_not_valid_for_type`: A type-specific filter was sent with a type it does not filter, or type-specific filters that no single document type accepts together — including a citation with case_number, respondent, a penalty bound, or an open_date or close_date bound on murs or adrs. `invalid_citation`: A citation is not in a form the search index parses, so upstream would ignore it and return the type unfiltered, or a value holds a second citation upstream would ignore. `legal_window_exceeded`: from_hit plus hits_returned exceeds the 10,000-result window the search index serves. Other values are possible when a failure originates below the handler.",
"examples": [
"missing_filter",
"date_filter_incomplete",
"date_kind_not_valid_for_type",
"filter_not_valid_for_type",
"invalid_citation",
"legal_window_exceeded"
],
"type": "string"
},
"recovery": {
"additionalProperties": {},
"description": "Actionable next step for the caller.",
"properties": {
"hint": {
"type": "string"
}
},
"required": [
"hint"
],
"type": "object"
},
"retryable": {
"description": "Whether retrying may succeed.",
"type": "boolean"
}
},
"type": "object"
},
"message": {
"description": "Human-readable description of what went wrong.",
"type": "string"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
"nextFromHit": {
"additionalProperties": {
"type": "number"
},
"description": "The from_hit that continues each document type with results held back, keyed by the value to pass as type (advisory_opinions, murs, adrs, admin_fines, statutes). Re-call with the same filters, that type, and this from_hit. Present only when truncated is true.",
"propertyNames": {
"type": "string"
},
"type": "object"
},
"notice": {
"description": "Guidance on the page returned: how to broaden a search that matched nothing, that from_hit ran past the end when documents did match, or — when truncated is set — how each document type continues.",
"type": "string"
},
"results": {
"description": "Legal document result set spanning advisory opinions, MURs, ADRs, admin fines, and statutes — only the types searched. Grouped by type in upstream order; when truncated is set, each type holds its first results up to the response budget.",
"items": {
"additionalProperties": {},
"description": "Legal document record. The document_type field discriminates among advisory_opinion, mur, adr, admin_fine, and statute. Common fields include no (the identifier every type carries, and the one openfec_get_legal_document takes; advisory opinions repeat it as ao_no), name, document_type, document_count and document_categories summarizing the related filings, and disposition_count and disposition_categories summarizing the dispositions.",
"properties": {},
"type": "object"
},
"type": "array"
},
"retrievalHint": {
"description": "How to recover the material trimmed out of these results. Present whenever any result was returned, because every result is trimmed.",
"type": "string"
},
"search_criteria": {
"additionalProperties": {},
"description": "Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured.",
"properties": {},
"type": "object"
},
"shown": {
"description": "Results in this response. Present only when truncated is true.",
"type": "number"
},
"totalCount": {
"description": "Total matching legal documents across the document types searched.",
"type": "number"
},
"total_count": {
"description": "Total matching documents across the types searched: the requested type, or with type omitted, every type the supplied filters apply to.",
"type": "number"
},
"truncated": {
"description": "True when results upstream returned for this page were held back because the next one would take the response past its 100,000-byte budget. Absent when the page is complete, including a naturally short page and an offset past the end.",
"type": "boolean"
}
},
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:2f6193e41590e00ed990beef4fecd931aee25ebdfd37652aa244f59d7d0e5efd | sha256sum