Capitol Ledger — Congressional Stock Disclosures
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
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.
Related MCP server: ibkr-mcp
Install
Python 3.12 or later is required. Install the published PyPI package:
pip install capitol-ledger-mcpOr run without a permanent installation:
uvx --from capitol-ledger-mcp capitol-ledger-mcpTo 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
Tool | Purpose | Parameters |
| Search House stock disclosures with filing links and amount ranges | Optional |
| Opening/closing allocations for a saved synthetic ledger report | Optional |
| Purchases, sales, and allocation changes for a saved period | Optional |
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 as_of
and available_after when paging with meta.next_offset. Pin report_id to compare
a portfolio and its changes over the same period.
Coverage and interpretation
House only. Senate data is excluded.
Disclosures are delayed. The transaction date, public filing availability, and collection time are separate; do not describe a newly filed disclosure as a trade that just happened.
Disclosed amounts are ranges, not exact transaction values. Synthetic ledger values use midpoint estimates.
Portfolio snapshots represent a synthetic disclosure ledger, not actual member holdings or Capitol Ledger's executable strategy portfolio. Reports may be daily, weekly, monthly, or ad hoc; inspect returned period metadata.
Preserve source URLs, calculation metadata, freshness, and coverage warnings. Completeness is not guaranteed. Historical queries use current parsed records, not a complete versioned archive of parser/source revisions.
Research data only; no personalized investment advice or order execution.
Pilot access is for internal research workflows; contact Capitol Ledger about redistribution or serving downstream users. The code's MIT license does not grant redistribution rights to the hosted data.
Usage and errors
All three tools use the API's account-wide quota. Usage and expiry can be checked
outside MCP using authenticated GET /api/v1/account (this also consumes a call).
401: invalid/revoked key.
403: inactive/expired access.
404: no completed saved report for that query.
422: invalid parameters.
429: daily quota exhausted; see the HTTP API's
Retry-Afterheader.
The tools never change subscriptions, rotate keys, submit orders, or access a local product database. API calls require HTTPS except for local development; redirects are not followed with credentials. Keys are environment credentials, not tool inputs. Model inference runs in your MCP client; this adapter only retrieves research data.
Container option
A non-root container is included for directory safety/quality checks and clients that prefer Docker. Pass credentials at runtime; they are never baked into the image.
docker build -t capitol-ledger-mcp .
docker run --rm -i -e CAPITOL_LEDGER_API_KEY -e CAPITOL_LEDGER_API_URL capitol-ledger-mcpUse -i for MCP stdio; do not allocate a TTY. Starting the server and listing its
tools do not require a key, but data calls do.
Development
pip install -e '.[dev]'
pytest
ruff check .Tests use mocked HTTP and do not need live credentials or consume API quota.
Publishing
See PUBLISHING.md for the release workflow, PyPI trusted publisher setup, and official MCP Registry metadata. Directory submissions are not evidence of endorsement or listing approval.
License and contact
MIT for the adapter code. Hosted API access and data rights are separate. Contact: hello@capitol-ledger.com.
Available Tools
3 toolsget_portfolioARead-only
Get a saved synthetic disclosure ledger's opening/closing allocations and audit metadata.
Defaults to latest saved completed period, of any cadence. Pin report_id for reproducibility. This is not actual member holdings or the executable strategy portfolio.
Inputs: as_of, report_id. Returns: object
get_portfolio_changesBRead-only
Get purchases, sales, and weight changes for a saved report period; inspect coverage warnings.
Pass the portfolio result's report_id to use exactly the same period.
Inputs: as_of, report_id. Returns: object
search_disclosuresARead-only
Search House disclosures; dates use filing availability. Return source links and amount ranges.
Default window is 30 days. Maximum limit is 100. Reuse returned as_of when paging. Timestamps must include a UTC offset; side is purchase, sale, or exchange.
Inputs: side, as_of, limit, offset, +2 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
get_portfolio and get_portfolio_changes both operate on saved report periods, but one returns allocations/audit metadata while the other returns purchases, sales, and weight changes. search_disclosures is clearly distinct. The boundary is mostly clear, with only mild potential confusion between the two portfolio tools.
All tool names use snake_case verb_noun patterns: get_portfolio, get_portfolio_changes, and search_disclosures. The get/search variation is semantically appropriate and predictable.
Three tools is on the lean side but reasonable for the apparent scope: retrieve a saved portfolio, inspect its changes, and search disclosures. Each tool earns its place, though the surface feels slightly minimal.
The set covers saved portfolio retrieval and House disclosure search, but notably omits Senate disclosures despite the 'Congressional' scope, and lacks operations for listing saved reports or fetching a specific disclosure/member detail. These gaps limit agent workflows that fall outside House disclosure search or existing saved reports.
Maintenance
Related MCP Connectors
Hosted MCP server for SEC, FRED, Polymarket, Deribit, OKX, and FMP.
Historical tick, order book and settlement data for Polymarket and Predict.fun crypto up/down markets, plus smart-money lists and backtest quotes, over a read-only MCP server.
JW3.ai remote MCP server for market reads and confirm-gated trading execution.
Query SEC EDGAR filings, XBRL financials, and company data via MCP. STDIO or Streamable HTTP.
Related MCP Servers
- AlicenseBqualityCmaintenanceA read-only MCP server that wraps the Scalable Capital CLI to expose broker data (portfolio, holdings, transactions, analytics, quotes, news) to any MCP-capable client.8MIT
- AlicenseAqualityDmaintenanceA read-only MCP server that connects to Interactive Brokers Gateway or TWS to expose account, contract, execution, and historical-data queries over stdio.915 npmMIT
- FlicenseNot gradedqualityDmaintenanceA local-first MCP server that connects Claude Code to your Robinhood account, enabling read-only portfolio insights, tax analysis, and natural language queries, with optional human-in-the-loop trading actions.-
- AlicenseAqualityDmaintenanceMCP server exposing ATLAS research capabilities: live tokenized stock market data, on-chain source-of-truth reads, and published research atlases. Connects to MCP clients over stdio with no API keys required for public testnet endpoints.9MIT