# Capitol Ledger

> Capitol Ledger is an MCP server for finance and payments. Read-only House stock disclosures and synthetic portfolio research, with source links. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** API, CLI, self-hosted
- **Website:** https://capitol-ledger.com/agents
- **Repository:** https://github.com/joalbrecht/capitol-ledger-mcp
- **MCP Registry name:** io.github.joalbrecht/capitol-ledger-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/capitol-ledger
