Skip to main content
Glama

us-lobbying-mcp-server

Server Details

Search US lobbying disclosures and foreign-agent registrations via MCP.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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

A4.1/5.0

Scored across 9 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count5/5

Nine tools is well-scoped for a lobbying disclosure research server. Each tool covers a meaningful part of the domain without excessive fragmentation.

Completeness5/5

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 tools
uslobbying_dataframe_describeDescribe disclosure tablesA
Read-onlyIdempotent
Inspect

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 ProfileA
Read-onlyIdempotent
Inspect

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 ContributionsA
Read-onlyIdempotent
Inspect

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 SpendingA
Read-onlyIdempotent
Inspect

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 ReferenceA
Read-onlyIdempotent
Inspect

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 FilingsA
Read-onlyIdempotent
Inspect

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 agentsA
Read-onlyIdempotent
Inspect

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 LobbyistsA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.