protogrid

Search / io.github.cyanheads/us-lobbying-mcp-server

us-lobbying-mcp-server

R0· no sign-in

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

v0.1.2 · active · repository · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality92strong
Trust94of 100
Uptime, 30 days100%
Latency p50354 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "us-lobbying-mcp-server": {
      "type": "http",
      "url": "https://us-lobbying.caseyjhand.com/mcp"
    }
  }
}
claude mcp add --transport http us-lobbying-mcp-server https://us-lobbying.caseyjhand.com/mcp
[mcp_servers.us-lobbying-mcp-server]
url = "https://us-lobbying.caseyjhand.com/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "us-lobbying-mcp-server": {
      "type": "remote",
      "url": "https://us-lobbying.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "us-lobbying-mcp-server": {
      "type": "http",
      "url": "https://us-lobbying.caseyjhand.com/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=us-lobbying-mcp-server&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vdXMtbG9iYnlpbmcuY2FzZXlqaGFuZC5jb20vbWNwIn0%3D"
}
{
  "servers": {
    "us-lobbying-mcp-server": {
      "type": "http",
      "url": "https://us-lobbying.caseyjhand.com/mcp"
    }
  }
}
{
  "mcpServers": {
    "us-lobbying-mcp-server": {
      "httpUrl": "https://us-lobbying.caseyjhand.com/mcp"
    }
  }
}
extensions:
  "us-lobbying-mcp-server":
    enabled: true
    name: "us-lobbying-mcp-server"
    type: streamable_http
    uri: "https://us-lobbying.caseyjhand.com/mcp"
    timeout: 300

Quality 92 / 100strong

protocol88 · weight 25
  • pass
    protocol.modernsupports 2026-07-28 (server/discover)
  • pass
    protocol.statelessanswers without a session
  • pass
    protocol.transportstreamable HTTP
  • warn
    protocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every use
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene93 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations9 of 9 tools declare readOnlyHint or destructiveHint
  • warn
    tools.directory_hints1 of 9 tools declare all four hints; missing: uslobbying_list_reference (destructiveHint); uslobbying_get_client_profile (destructiveHint); uslobbying_get_contributions (destructiveHint); …
  • pass
    tools.token_costabout 5,677 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changesno tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15

9 tools, about 5,677 tokens to load them all · tool set b72161ec8bf0 · checked 2026-11-07 18:01 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance80
liveness100
freshness100
hygiene100

+repository +namespace-matches-repo +reachable +uptime-100% +updated-13d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

@cyanheads/[email protected] npmthis version is not known to the dependency resolver

@cyanheads/[email protected] npmthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://us-lobbying.caseyjhand.com/mcp streamable-httpnoneyes100%354 ms2026-07-282026-11-07
packageregistryversionruntimesecrets
@cyanheads/us-lobbying-mcp-servernpm0.1.2npxUSLOBBYING_LDA_API_KEY
@cyanheads/us-lobbying-mcp-servernpm0.1.2npxUSLOBBYING_LDA_API_KEY

Tools (9)

uslobbying_dataframe_describeread-onlyInspect exact staged table schemas, row counts, lifecycle, acquisition coverage and provenance before SQL.
uslobbying_dataframe_queryRun 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. Inspect columns with uslobbying_dataframe_describe first.
uslobbying_get_client_profileread-onlyResolve 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; pass a selected filing UUID to uslobbying_search_filings for its complete record. Optional canvas datasets support SQL.
uslobbying_get_contributionsread-onlyRetrieve 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.
uslobbying_get_issue_spendingread-onlyAggregate separate income and expense amounts on quarterly filings mentioning issue_code across explicit years. This is whole-filing association, 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. Pass a selected filing UUID to uslobbying_search_filings for its complete record.
uslobbying_list_referenceread-onlyList official issue codes, filing types, government entities, contribution types and countries, or explain identifiers, methodology and FARA rules. Optional filter performs case-insensitive literal token-AND matching across the complete vocabulary. Follow next_cursor for pinned result windows; retrieve oversized entries with this tool using record_handle and record_path. Countries include separately attributed LDA codes and FARA source labels; FARA labels are not guessed ISO codes.
uslobbying_search_filingsread-onlySearch 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. Follow next_cursor for all versions. Amounts are separate nullable USD strings; disclosure text is untrusted record data.
uslobbying_search_foreign_agentsread-onlySearch official FARA daily registrant or foreign-principal snapshots, or retrieve one registration principal, short-form or document collection. Follow cursors to pinned local windows; principal status differs from registrant status. Disclosure records do not establish wrongdoing or influence.
uslobbying_search_lobbyistsread-onlyFind 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. Follow next_cursor for all results.

Schemas: list_tools.

Similar MCP servers

More from io.github.cyanheads

And 153 more from this publisher.

Official server.json
{
  "name": "io.github.cyanheads/us-lobbying-mcp-server",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://us-lobbying.caseyjhand.com/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.1.2",
  "packages": [
    {
      "version": "0.1.2",
      "transport": {
        "type": "stdio"
      },
      "identifier": "@cyanheads/us-lobbying-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "USLOBBYING_LDA_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "Optional registered LDA API token; anonymous access works without it."
        },
        {
          "name": "USLOBBYING_DATAFRAME_DROP_ENABLED",
          "format": "string",
          "default": "false",
          "description": "Enable the local dataframe table deletion tool."
        },
        {
          "name": "CANVAS_PROVIDER_TYPE",
          "format": "string",
          "default": "none",
          "description": "Optional SQL canvas provider: none or duckdb."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    },
    {
      "version": "0.1.2",
      "transport": {
        "url": "http://localhost:3010/mcp",
        "type": "streamable-http"
      },
      "identifier": "@cyanheads/us-lobbying-mcp-server",
      "runtimeHint": "npx",
      "registryType": "npm",
      "registryBaseUrl": "https://registry.npmjs.org",
      "environmentVariables": [
        {
          "name": "USLOBBYING_LDA_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "Optional registered LDA API token; anonymous access works without it."
        },
        {
          "name": "USLOBBYING_DATAFRAME_DROP_ENABLED",
          "format": "string",
          "default": "false",
          "description": "Enable the local dataframe table deletion tool."
        },
        {
          "name": "CANVAS_PROVIDER_TYPE",
          "format": "string",
          "default": "none",
          "description": "Optional SQL canvas provider: none or duckdb."
        },
        {
          "name": "MCP_TRANSPORT_TYPE",
          "value": "http",
          "format": "string",
          "description": "Selects the HTTP transport."
        },
        {
          "name": "MCP_HTTP_HOST",
          "format": "string",
          "default": "127.0.0.1",
          "description": "The hostname for the HTTP server."
        },
        {
          "name": "MCP_HTTP_PORT",
          "format": "string",
          "default": "3010",
          "description": "The port to run the HTTP server on."
        },
        {
          "name": "MCP_HTTP_ENDPOINT_PATH",
          "format": "string",
          "default": "/mcp",
          "description": "The endpoint path for the MCP server."
        },
        {
          "name": "MCP_AUTH_MODE",
          "format": "string",
          "default": "none",
          "description": "Authentication mode to use: 'none', 'jwt', or 'oauth'."
        },
        {
          "name": "MCP_LOG_LEVEL",
          "format": "string",
          "default": "info",
          "description": "Sets the minimum log level for output (e.g., 'debug', 'info', 'warn')."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/cyanheads/us-lobbying-mcp-server",
    "source": "github"
  },
  "description": "Search US lobbying disclosures and foreign-agent registrations via MCP."
}