Developers
Coldpine for AI assistants and agents
Coldpine publishes a read-only Model Context Protocol (MCP) server over every U.S. Congressional stock-trade disclosure it has parsed. Connect it to Claude, ChatGPT, Cursor or any MCP client and ask questions in plain language; every answer carries the coldpine.io page and the original government filing it came from. No API key.
https://coldpine.io/api/mcp
01What it is
The same public data as the site, reachable by an AI assistant instead of a browser. Today that is 1,837 STOCK Act filings from 226 members of Congress, January 2023 through September 2026, parsed into individual trades within hours of hitting the House Clerk and Senate eFD portals. Transport is Streamable HTTP, stateless, free during early access: three taster tools work with no key at all, and a free account’s agent token (from your settings page) unlocks the other eight. The server is read-only: nothing you ask it can change anything.
It is built to be cited. Every payload includes the coldpine.io URL it mirrors, a link to the source filing where one exists, and an attribution line. The server’s own instructions tell the connected model to present results descriptively and never to quote a pre-disclosure price move without the paired S&P 500 figure, the same discipline as our methodology.
02Connect a client
Pick your client. Each snippet points at the same endpoint; nothing else is required.
Claude Code
One command from any terminal.
claude mcp add --transport http coldpine https://coldpine.io/api/mcp
Claude.ai and Claude Desktop
Settings, then Connectors, then Add custom connector. Name it Coldpine and paste the URL. Leave authentication blank.
Cursor
Add to .cursor/mcp.json in your project, or the global file in your home directory.
{
"mcpServers": {
"coldpine": { "url": "https://coldpine.io/api/mcp" }
}
}VS Code
Add to .vscode/mcp.json.
{
"servers": {
"coldpine": { "type": "http", "url": "https://coldpine.io/api/mcp" }
}
}ChatGPT
Settings, then Connectors. Under Advanced, turn on Developer mode, then Create a connector with the URL above. For the full toolset, add a custom header: Authorization: Bearer <your agent token>.
Any client that only speaks stdio
Bridge with mcp-remote. This is the shape Claude Desktop's config file and most older clients expect.
{
"mcpServers": {
"coldpine": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://coldpine.io/api/mcp"]
}
}
}No client at all
The endpoint is plain JSON-RPC over HTTP. Initialize, then list or call tools. Responses arrive as a server-sent event stream with one message.
curl -s -X POST https://coldpine.io/api/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_members","arguments":{"query":"Pelosi"}}}'03The eleven tools
Each tool mirrors a public page, so anything the assistant tells you can be checked on the site and in the original filing.
whats_newKeylessThe newest filings with parsed trades, newest first, with a `since` date parameter for agents that poll. Filer, buy/sell mix, tickers, late-filing flag.
Mirrors Filings.
search_membersKeylessMembers of the House or Senate matching part of a name, with trade and filing counts, buy/sell split and disclosed volume range.
Mirrors Members.
get_memberFree accountOne member's profile and trading stats, 20 most recent disclosed trades, latest Periodic Transaction Reports, and the one sample scored trade the public page shows.
Mirrors Member pages.
get_stockKeylessEvery member who disclosed trading a ticker: totals, buy/sell split, first and last trade dates, most active members, 20 most recent trades.
Mirrors Stock pages.
list_transactionsFree accountDisclosed trades newest first, filterable by ticker and member, up to 50 per page. Each row links the original House Clerk PDF or Senate eFD filing.
Mirrors Stock and member pages.
list_recent_filingsFree accountThe newest Periodic Transaction Reports with parsed trades, 25 per page: filer, filed date, trade count, tickers and how many trades were reported past the 45-day window.
Mirrors Filings.
get_filingFree accountA single STOCK Act filing parsed in full: the roll-up, every trade it disclosed, the disclosure-lag check, and a link to the original government document.
Mirrors Filing pages.
cluster_tradesFree accountStocks several members traded in the same direction inside a rolling window, with member count, trade count, date span and summed amount range.
Mirrors Biggest cluster buys.
congress_leaderboardFree accountMembers ranked by trade count, disclosed volume, average trade size or disclosure speed, with chamber and party filters.
Mirrors Leaderboard.
members_vs_marketFree accountPer-member 90-day return on disclosed purchases versus the S&P 500 over the same windows, with hit rate. Most members do not beat the market.
Mirrors Members who beat the market.
stock_act_complianceFree accountSite-wide disclosure-lag summary and the per-member late-filer board. Pre-disclosure moves always ship paired with the S&P 500 over the same windows.
Mirrors STOCK Act late filers.
04Questions it answers well
- Which members of Congress disclosed buying NVDA in the last 90 days, and how late were the filings?
- Pull Nancy Pelosi's most recent Periodic Transaction Report and list every trade in it with a link to the source PDF.
- Which stocks did three or more members buy in the same 60-day window this year?
- Rank the Senate by median disclosure lag and show who was past the 45-day STOCK Act window most often.
- Of members with at least five priced purchases, how many beat the S&P 500 over 90 days?
The assistant chains tools on its own: search a member, open the filing, pull the stock, check the compliance board. You ask the question; the citations come back with the answer.
05What it returns, and what it does not
- Source-linked, always. Every trade row carries the House Clerk or Senate eFD document it was parsed from. Every payload carries the coldpine.io page and an attribution line.
- Score-free in bulk.Trade lists, filings and aggregates omit Coldpine’s signal score. The only score returned is the one sample scored trade each public member, stock and filing page already shows.
- Paired, never alone.Where a pre-disclosure price move is reported, the S&P 500 move over the identical windows is in the same object. Quoting one without the other is misleading, and the server says so.
- Cached, not real-time.Responses share the site’s one-hour public cache. New filings appear on the site and in the server together.
- Also available as a feed. The 50 newest parsed filings are published as RSS 2.0 at /feeds/filings.xml and JSON Feed 1.1 at /feeds/filings.json, one descriptive item per report with the member, trade count, buy and sale split, tickers and the 45-day check. Same one-hour cache; poll hourly.
- Descriptive, never advisory. Coldpine is a publisher of intelligence on public disclosures, informational only, not investment advice. The server does not know who you are and returns nothing personalized.
Please link back to coldpine.io when you republish figures. If you build something on it, we would like to see it: @coldpine_io.
06Frequently asked questions
- Is there an MCP server for Congressional stock trades?
- Yes. Coldpine runs a read-only Model Context Protocol server at https://coldpine.io/api/mcp over Streamable HTTP. It exposes eleven tools covering disclosed trades, members, stocks, STOCK Act filings, cluster buys, the activity leaderboard, members' returns versus the S&P 500 and disclosure-lag compliance. Any MCP client, including Claude, ChatGPT, Cursor and VS Code, can connect to it.
- Does the Coldpine MCP server need an API key?
- Three taster tools (whats_new, search_members, get_stock) are keyless: add the URL to your client and they work. The other eight need a free Coldpine account's agent token, sent as an Authorization: Bearer header. Everything is free during early access, no card; the token is on your settings page after signup.
- Where does the data come from?
- Official government disclosures: the U.S. House Clerk's financial disclosure portal and the U.S. Senate's electronic Financial Disclosure system, the public records required by the STOCK Act. Every trade the server returns links back to the original filing, and every payload carries the coldpine.io page it mirrors.
- Does the server return Coldpine's signal scores?
- Not in bulk. The tools return the same public data as coldpine.io's pages: trade rows, filings and aggregates are score-free, and the only score present is the one sample scored trade each public member, stock or filing page already shows.
- Is a REST API available?
- Not yet. The MCP endpoint is the supported programmatic surface today. It speaks plain JSON-RPC over HTTP, so it can be called from any language without an MCP client; a curl example is on this page. For a plain poll of new filings without MCP, the same data is published as RSS (/feeds/filings.xml) and JSON Feed (/feeds/filings.json).
- Is this investment advice?
- No. Coldpine is a publisher of intelligence on public Congressional disclosures. The server's own instructions tell connected assistants to present results descriptively, cite the source filing, and never quote a pre-disclosure move without the paired S&P 500 figure. Nothing it returns is a recommendation.