01
Connect
Free and open — no API key required. POST JSON-RPC 2.0 requests to the endpoint below. Rate-limited to 200 requests per 15 minutes per IP.
bash
POST https://stockslash.com/api/mcp
Content-Type: application/json02
Add to Claude
Pick your MCP client. No key or signup needed — paste and go.
Claude Code (CLI)
bash
claude mcp add --transport http stockslash \
https://stockslash.com/api/mcpAfter running, restart Claude Code and the
stockslash tools will appear. Verify with /mcp.Claude Desktop
Edit your config file:
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%/Claude/claude_desktop_config.json
json
{
"mcpServers": {
"stockslash": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://stockslash.com/api/mcp"
]
}
}
}Save and restart Claude Desktop. The server will appear in the MCP menu.
Cursor
Add to .cursor/mcp.json (per-project) or ~/.cursor/mcp.json (global):
json
{
"mcpServers": {
"stockslash": {
"url": "https://stockslash.com/api/mcp"
}
}
}03
Quick start
List every available tool — the simplest sanity check that the endpoint is reachable:
bash
curl -X POST https://stockslash.com/api/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Call a tool — for example, fetch the top-valued funds:
python
import requests
r = requests.post(
"https://stockslash.com/api/mcp",
json={
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_super_investors",
"arguments": {"type": "portfolio-value"}
}
},
)
print(r.json())04
Tools (16)
Institutional vs insider:
get_stock_holders returns funds (BlackRock, Vanguard); get_insider_trades returns executives and directors (Form 4).Investors
Tool
Purpose
Required
Optional
get_super_investors
List all tracked funds with portfolio snapshot (CIK, value, top holdings)
—
type, sort, limit
get_investor_current_holdings
All stocks owned by one fund for a quarter
cik
quarter
get_investor_fund_value
Total portfolio value for one fund (latest)
cik
—
get_investor_fund_value_history
Quarterly portfolio value history for one fund — AUM over time
cik
—
get_fund_activity
Buys and sells made by one fund in a quarter
cik
quarter
get_fund_distribution
Buy/sell distribution for one fund across quarters — trading cadence
cik
—
Stocks
Tool
Purpose
Required
Optional
get_stock_holders
Institutional funds holding a given stock (13F filers)
stockSymbol
quarter
get_stock_activity
Trading activity for a stock across all funds
stockSymbol
quarter
get_ownership_statistics
Institutional ownership percentages for one stock
stockSymbol
—
get_insider_trades
Form 4 insider trades (executives, directors) for a stock
stockSymbol
limit, transactionType
get_sp_stocks_by_holders
S&P 500 stocks ranked by number of institutional holders
—
limit
Market
Tool
Purpose
Required
Optional
get_latest_filings_updates
Most recent 13F-HR filings across all tracked funds
—
limit
get_filings_buy_status
Stocks being bought/added in recent filings
—
quarter, limit
get_filings_sell_status
Stocks being sold/exited in recent filings
—
quarter, limit
get_ownership_statistics_home
Homepage summary: top owned, most bought, most sold
—
—
get_latest_quarter
Latest quarter with available 13F data
—
—
All quarter filters use the form
Q4-2025. Omit to get the latest quarter.05
Common workflow — resolve a name to a CIK
Investor-specific tools take a cik, not a name. To go from "Warren Buffett" to holdings:
- Call
get_super_investorsand find the matching row. - Read its
cikfield. - Pass the CIK to
get_investor_current_holdings,get_fund_activity,get_fund_distribution, etc.
Known CIKs (handy for testing)
0001067983Berkshire HathawayWarren Buffett
0001037389Pershing SquareBill Ackman
0001649339Scion Asset ManagementMichael Burry
0001056831Fairholme CapitalBruce Berkowitz
0001167483Tiger GlobalChase Coleman
06
Errors & limits
429Rate limit (200 req / 15 min per IP)
-32601Unknown method (typo in
method field)-32602Invalid params (missing required arg, wrong type)
-32000Tool execution error (upstream data issue)
Protocol version
2024-11-05. New tools may be added without breaking existing ones — handle tools/list dynamically rather than hard-coding the set.