
Capitol Ledger
Read-only House stock disclosures and synthetic portfolio research, with source links
- 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-mcpAdd 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#pilotRequiredCAPITOL_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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments