Skip to content
MCP server

Capitol Ledger

Read-only House stock disclosures and synthetic portfolio research, with source links

Runs locallyStatus and history
Install
Pricing
Free trial
Platforms
API, CLI, self-hosted
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Capitol Ledger

Capitol Ledger is an MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Capitol Ledger turns official U.S. House stock disclosures into structured research data, with source links and dates an agent can explain. This package is a local stdio adapter, installed from PyPI, that calls the hosted HTTPS API using a key stored in your environment. There is no hosted MCP endpoint.

The disclosure data keeps three dates apart: the transaction date, when the filing became public, and when Capitol Ledger collected it. Historical queries exclude rows collected after the instant you request, and paging reuses the returned as_of value so results stay consistent. Amounts are ranges, not exact values. Portfolio snapshots come from a synthetic ledger valued at range midpoints, which the site says does not represent actual member holdings.

Coverage is House only; Senate data is excluded. Access is by invitation: a free 14-day pilot gives 1,000 authenticated requests per UTC day with no payment details or automatic conversion. A public fictional JSON sample shows the response shape without a key. The service is research data, not investment advice.

Install

Run in a terminal

claude mcp add capitol-ledger-mcp --env CAPITOL_LEDGER_API_KEY='<CAPITOL_LEDGER_API_KEY>' -- uvx capitol-ledger-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "capitol-ledger-mcp": {
      "command": "uvx",
      "args": [
        "capitol-ledger-mcp"
      ],
      "env": {
        "CAPITOL_LEDGER_API_KEY": "<CAPITOL_LEDGER_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "capitol-ledger-mcp": {
      "command": "uvx",
      "args": [
        "capitol-ledger-mcp"
      ],
      "env": {
        "CAPITOL_LEDGER_API_KEY": "<CAPITOL_LEDGER_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "capitol-ledger-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "capitol-ledger-mcp"
      ],
      "env": {
        "CAPITOL_LEDGER_API_KEY": "<CAPITOL_LEDGER_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "capitol-ledger-mcp": {
      "command": "uvx",
      "args": [
        "capitol-ledger-mcp"
      ],
      "env": {
        "CAPITOL_LEDGER_API_KEY": "<CAPITOL_LEDGER_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "capitol-ledger-mcp": {
      "command": "uvx",
      "args": [
        "capitol-ledger-mcp"
      ],
      "env": {
        "CAPITOL_LEDGER_API_KEY": "<CAPITOL_LEDGER_API_KEY>"
      }
    }
  }
}

Configuration

  • CAPITOL_LEDGER_API_KEYAPI key issued after pilot approval at https://capitol-ledger.com/agents#pilotRequired
  • CAPITOL_LEDGER_API_URLCapitol Ledger HTTPS API origin

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

search_disclosures
Search House stock disclosures with filing links and amount ranges.
get_portfolio
Opening and closing allocations for a saved synthetic ledger report.
get_portfolio_changes
Purchases, sales and allocation changes for a saved period.

What it does

Disclosure search
Filter House disclosures by ticker, purchase, sale or exchange, with filing links and amount ranges.
Synthetic portfolio
Read opening and closing allocations from a saved synthetic ledger report.
Period changes
See purchases, sales and allocation changes for a saved report.
Separate timestamps
Transaction date, filing availability and collection time are kept distinct.
Reproducible paging
Pin report_id and reuse as_of for consistent results.
Fictional public sample
A key-free JSON sample shows the data shape.

Good for

  • Check what NVDA purchases were disclosed in the last 30 days
  • Review a saved synthetic portfolio and its period
  • Explain what changed in a portfolio report
  • Build a research agent that cites disclosure filings

Pricing

Free trial

Invited 14-day free pilot; later pricing not published

Prices change. Check capitol-ledger.com before you buy.

Capitol Ledger FAQ

Do I need a key?

Yes. An approved Capitol Ledger API key is required, issued through the pilot request.

Does it cover the Senate?

No. Coverage is House disclosures only.

Are portfolio numbers real holdings?

No. They come from a synthetic disclosure ledger using midpoints of disclosed ranges.

What Python version is needed?

Python 3.12 or later.

Is it hosted remotely?

No. It is a local stdio server that calls the hosted API.

Is Capitol Ledger free?

Capitol Ledger is a paid product with a free trial.

How do I add Capitol Ledger to Claude Code?

Run this command in your terminal: claude mcp add capitol-ledger-mcp --env CAPITOL_LEDGER_API_KEY='<CAPITOL_LEDGER_API_KEY>' -- uvx capitol-ledger-mcp

What are the best alternatives to Capitol Ledger?

The closest alternatives to Capitol Ledger are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Capitol Ledger

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments