Capitol Ledger MCP server

Capitol Ledger MCP

Read-only congressional stock disclosure research for AI agents. Search official U.S. House disclosures, inspect saved synthetic disclosure-ledger portfolios, and explain portfolio changes with source and timing context.

Request pilot access · API documentation · PyPI package · Official MCP Registry · Public fictional sample · Methodology

<!-- mcp-name: io.github.joalbrecht/capitol-ledger-mcp -->

Access

The adapter is open source. The hosted data API requires an approved Capitol Ledger API key. Request an invited free 14-day pilot at the link above. Approved pilot accounts default to 1,000 authenticated requests per UTC day, shared across keys. No payment details or automatic paid conversion. Submitting an application does not grant access or subscribe you to a newsletter.

The public JSON sample is fictional and requires no key. It is useful for inspecting the response shape; it is not a real disclosure or live data.

Install

Python 3.12 or later is required. Install the published PyPI package:

pip install capitol-ledger-mcp

Or run without a permanent installation:

uvx --from capitol-ledger-mcp capitol-ledger-mcp

To install from this public repository instead:

pip install 'git+https://github.com/joalbrecht/capitol-ledger-mcp.git'

Connect your MCP client

For an installed adapter, use this local stdio configuration:

{
  "mcpServers": {
    "capitol-ledger": {
      "command": "capitol-ledger-mcp",
      "env": {
        "CAPITOL_LEDGER_API_URL": "https://capitol-ledger.com",
        "CAPITOL_LEDGER_API_KEY": "YOUR_APPROVED_API_KEY"
      }
    }
  }
}

Replace the placeholder locally and keep the key in your client's secret store. Do not put it in a shared prompt, URL, issue, or public repository. If your client cannot find the command, use its absolute installation path.

A client using uvx can instead use "command": "uvx" and "args": ["--from", "capitol-ledger-mcp", "capitol-ledger-mcp"], with the same env. This is a local stdio server that calls a hosted HTTPS API. It is not a hosted remote MCP endpoint. No broker or trading-account credentials are needed.

Tools

Example questions after connecting:

• What NVDA purchases were disclosed in the last 30 days? Include source links.
• Show the latest saved synthetic disclosure portfolio and its period.
• What changed in that report? Use the same report ID.

Search defaults to 30 days, with at most 100 rows per call. side accepts purchase, sale, or exchange. Timestamps must include a timezone. Reuse returned asof and availableafter when paging with meta.nextoffset. Pin reportid to compare a portfolio and its changes over the same period.

Coverage and interpretation

Shortened. The full README is on GitHub.