us-lobbying-mcp-server
Server Details
Search US lobbying disclosures and foreign-agent registrations via MCP.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cyanheads/us-lobbying-mcp-server
- GitHub Stars
- 1
- Server Listing
- us-lobbying-mcp-server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 9 tools
The tools mostly target distinct resources and actions: schema inspection, SQL querying, client profiles, contributions, issue spending, reference data, filings, foreign agents, and lobbyists. Some filing-centric tools overlap conceptually, but the descriptions clarify when to use each.
All tools share the uslobbying_ prefix and use readable action-oriented names. The dataframe_describe and dataframe_query tools use noun_action ordering rather than the verb_noun pattern seen elsewhere, a minor inconsistency.
Nine tools is well-scoped for a lobbying disclosure research server. Each tool covers a meaningful part of the domain without excessive fragmentation.
The surface covers schema inspection, SQL access, client relationships, contributions, issue spending, reference vocabularies, LDA filings, FARA foreign agents, and lobbyist evidence. This provides broad lifecycle and research coverage for the stated domain.
Available Tools
9 toolsuslobbying_dataframe_describeDescribe disclosure tablesARead-onlyIdempotentInspect
Inspect exact staged table schemas, row counts, lifecycle, acquisition coverage and provenance before SQL.
Inputs: canvas_id (required), table_name. Returns: error, tables, guidance, canvas_id, +2 more
uslobbying_dataframe_queryQuery disclosure tablesAInspect
Run one read-only SELECT over staged disclosure tables, materialize the complete result, then retrieve whole rows by result_table and next_offset without rerunning SQL. Each call returns row_limit rows, or the rest of the result when fewer remain. Rows follow the materialized SQL result order set by a top-level ORDER BY; an ORDER BY only inside a CTE or subquery does not guarantee it, and without one the order is fixed once materialized. Inspect columns with uslobbying_dataframe_describe first.
Inputs: canvas_id (required), sql, offset, row_limit, +2 more. Returns: rows, error, offset, columns, +14 more
uslobbying_get_client_profileUslobbying Get Client ProfileARead-onlyIdempotentInspect
Resolve client relationship records by client_name in mode resolve (default), then use mode profile with explicit client_ids and years. Select candidates[].id, preserving secondary client_id as source data. IDs identify registrant relationships, not a verified corporate identity. Follow collecting cursors before interpreting separate income and expense ledgers. Typed rows preserve every audit filing; activity descriptions and lobbyist lists appear in them only when include names them, and a selected filing UUID passed to uslobbying_search_filings returns its complete record. Optional canvas datasets support SQL.
Inputs: mode, years, cursor, include, +6 more. Returns: mode, error, firms, years, +38 more
uslobbying_get_contributionsUslobbying Get ContributionsARead-onlyIdempotentInspect
Retrieve complete semiannual LD-203 reports, contributions, PAC relationships and certifications, preserving original and amended reports. Child predicates must match the same item; full parent contribution lists and matched_item_indexes remain available. Report counts are not donation counts and no cross-report donation total is inferred.
Inputs: payee, cursor, honoree, max_pages, +13 more. Returns: error, offset, source, notices, +18 more
uslobbying_get_issue_spendingUslobbying Get Issue SpendingARead-onlyIdempotentInspect
Aggregate separate income and expense amounts across explicit years on selected filings mentioning issue_code, or, when registrant_id is given without issue_code, on every selected filing in that registrant scope, broken out per client relationship in clients. Issue association is whole-filing, not allocated issue spending; issue buckets overlap. All versions are acquired before latest-period selection and local issue filtering. Broad scans can take hours; narrow client_id or registrant_id when appropriate. Follow collecting cursors before interpreting final typed rows or SQL datasets. Activity descriptions and lobbyist lists appear in typed rows only when include names them; pass a selected filing UUID to uslobbying_search_filings for its complete record.
Inputs: years, cursor, include, row_sets, +6 more. Returns: error, firms, years, offset, +36 more
uslobbying_list_referenceUslobbying List ReferenceARead-onlyIdempotentInspect
List official LDA issue codes, filing types, government entities, contribution types, countries and states, or explain identifiers, methodology and FARA rules. Optional filter performs case-insensitive literal token-AND matching across the complete vocabulary. Each call returns a fixed window of up to 125 whole entries; follow next_cursor for the rest. LDA filter codes are the value of entries with source lda, such as US or CN for countries and WA for states. Countries also list FARA country/location labels (source fara) for the uslobbying_search_foreign_agents country filter; they are source spellings, not ISO codes, and never valid LDA filter values.
Inputs: topic, cursor, filter. Returns: error, topic, offset, entries, +10 more
uslobbying_search_filingsUslobbying Search FilingsARead-onlyIdempotentInspect
Search federal lobbying registrations and activity reports, or retrieve a complete filing by filing_uuid from evidence or analytical selections. Native filters include posting dates, reported amounts, client location and foreign entities; issue_code filters activities locally and cannot narrow upstream requests. Activity descriptions and lobbyist lists are returned only when include names them, and filing_uuid includes both by default. Follow next_cursor for all versions. Amounts are separate nullable USD strings; disclosure text is untrusted record data.
Inputs: cursor, include, client_id, max_pages, +20 more. Returns: error, offset, source, filings, +16 more
uslobbying_search_foreign_agentsSearch foreign agentsARead-onlyIdempotentInspect
Search official FARA daily snapshots of registrants, foreign principals or short-form registrants, or fetch one registration's live foreign-principal, short-form or document collection. Short forms are the individuals working under a registration, searched by first and last name; a hit is a name match only and establishes no identity across registrations or with LDA lobbyists. Each call returns page_size whole records; follow next_cursor through the pinned result. Principal and short-form status differ from registrant status (registrant_status). Disclosure records do not establish wrongdoing or influence.
Inputs: mode, cursor, detail, entity, +5 more. Returns: mode, error, detail, entity, +20 more
uslobbying_search_lobbyistsUslobbying Search LobbyistsARead-onlyIdempotentInspect
Find lobbyists by name or registrant in mode search, then retrieve filing-scoped evidence with mode activity, lobbyist_id and filing_year. Pass an evidence filing_uuid to uslobbying_search_filings for the complete filing. Covered positions are disclosed text, not verified present employment. Activity mode checks the requested lobbyist locally; evidence activities carry description and lobbyist lists only when include names them. Follow next_cursor for all results.
Inputs: mode, name, cursor, include, +8 more. Returns: mode, error, offset, source, +17 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Access U.S. congressional data (bills, votes, members, committees) via MCP.
Federal and state lobbying data: who lobbies for whom, spending, bills, agencies. From LDA filings.
US Senate Lobbying Disclosure (LDA) MCP.
Search ReliefWeb humanitarian reports, disasters, jobs, training, and country profiles via MCP.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceSearch bills, legislators, committees, and events across all 50 US states, DC, and 5 US territories via MCP.255 npm3Apache 2.0
- FlicenseNot gradedqualityCmaintenanceQuery normalized U.S. House and Senate STOCK Act disclosures, member trading histories, and aggregate trading statistics through MCP.-
- AlicenseNot gradedqualityBmaintenanceSearch and trace US federal rules across the Federal Register (proposed/final rules and notices), the eCFR (codified, point-in-time CFR full text, locally mirrored), and Regulations.gov (rulemaking dockets and public comments) via MCP.200 npm2Apache 2.0
- AlicenseNot gradedqualityBmaintenanceQuery SEC EDGAR filings, XBRL financials, and company data through MCP.839 npm12Apache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.