AlphaSMO
About
CLI + MCP server for SEC 13F institutional holdings, insider trading, and smart money convergence signals. Free anonymous tier, no signup required.
Details
- Author
- alphasmo
- Categories
- Finance, Other
Jump to
Setup
Install AlphaSMO in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/alphasmo/alphasmo-tools
Follow the installation instructions in the repository README, then restart your MCP client.
AlphaSMO — The Ultimate Smart Money API for AI
CLI +MCP serverforAlphaSMO— SEC EDGAR 13F institutional holdings, Form 4 insider trading, and "smart money convergence" signals (tickers where hedge fundsandcompany insiders are buying at the same time), queryable from your terminal, your scripts, or any MCP-compatible AI agent (Claude, ChatGPT, Cursor, etc.).
No signup, no API key, no setup — try it right now:
┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐ │ ticker │ issuer │ net flow (USD) │ avg weight % │ institutions │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ BRK-A │ BERKSHIRE HATHAWAY INC-CL A │ 247,455,256,379 │ 1.42 │ 1418 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ AZN │ AstraZeneca PLC │ 148,465,847,587.12 │ 0.47 │ 1309 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ XOM │ EXXON MOBIL CORP │ 138,784,059,363.77 │ 0.78 │ 4716 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ CVX │ CHEVRON CORP │ 77,783,933,645.44 │ 0.6 │ 4261 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ JNJ │ JOHNSON & JOHNSON │ 64,498,075,844.9 │ 0.76 │ 4603 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ SNDK │ SANDISK CORP │ 58,662,972,096.01 │ 0.65 │ 1172 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ MU │ MICRON TECHNOLOGY INC │ 55,374,569,969.23 │ 0.7 │ 2993 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ AMAT │ APPLIED MATERIALS INC │ 48,790,109,328.41 │ 0.52 │ 2931 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ EEM │ ISHARES MSCI EMERGING MARKET │ 48,211,222,155.7 │ 0.59 │ 1637 │ ├────────┼──────────────────────────────┼────────────────────┼──────────────┼──────────────┤ │ CAT │ CATERPILLAR INC │ 46,035,710,179.58 │ 0.5 │ 3724 │ └────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘
- 📊13F institutional holdings— every hedge fund and asset manager's quarterly SEC filings: AUM, positions, and behavioral "personality scores" (concentration, turnover, sector conviction). Read our guide onWhat Is a 13F Filing?andHow to Read Institutional Holdings Changes.
- 🕵️Insider trading (Form 4 & 144)— officer/director/10%-owner buys and sells, with a confidence score per ticker. Learn more inWhat Is a Form 4 Filing?andWhat Is a Form 144 Filing?.
- 🚀Smart money convergence— the flagship signal: tickers where 13F institutionsandcompany insiders are both buying right now.
- 🤖Built for AI agents— an MCP server out of the box, so Claude, ChatGPT, Cursor, or any MCP client can pull real financial data mid-conversation.
- 🆓Free anonymous tier— no signup required to try it;get a free API keyany time to raise your rate limit.
"What is smart money buying right now?" → alphasmo convergence "What does Berkshire Hathaway hold?" → alphasmo institutions holdings berkshire-hathaway-inc "Are insiders buying or selling NVDA?" → alphasmo insider summary NVDA "Which stocks are institutions dumping?" → alphasmo stocks flows --direction sell
Wire the MCP server into Claude Desktop, Claude Code, Cursor, or any MCP client (seebelow) and ask these in plain English — no code required.
npx alphasmo institutions search "Berkshire" npx alphasmo stocks get AAPL npx alphasmo convergence -l 5
No install step required —npxfetches and runs it. Or install globally:
Global flags on every command:--api-key <key>(envALPHASMO_API_KEY),--base-url <url>(envALPHASMO_BASE_URL),-f/--format json|compact|table|csv,--json(shorthand for--format json),--csv(shorthand for--format csv).
Output format auto-detects your context— no flag needed in the common case:
- Typed directly in a terminal → a readable table, with numbers comma-formatted (263,095,703,570).
- Piped, redirected, or spawned by a script/AI agent (stdout isn't a TTY) → JSON, safe to pipe intojqor feed to an agent.
- --format/--json/--csvalways override the auto-detection either way.
alphasmo stocks flows --csv > flows.csv alphasmo insider trades AAPL --csv | column -s, -t
Errors go to stderr with a distinct exit code (2not found,3auth,4rate limit,5unexpected response shape,1other), so scripts can branch without string-matching.
Anonymous requests are rate-limited by IP. Sign up and mint a free key atalphasmo.com/developer, then:
alphasmo convergence --api-key ask_live_... # or export ALPHASMO_API_KEY=ask_live_...
If you're usingClaude Code, register the server with one command:
claude mcp add alphasmo -- npx -y alphasmo@latest mcp
Add-e ALPHASMO_API_KEY=ask_live_...before the--to raise your rate limit. Runclaude mcp listto confirm it's connected.
For Claude Desktop, Cursor, or any other MCP client, add this to your config file directly:
{ "mcpServers": { "alphasmo": { "command": "npx", "args": ["alphasmo", "mcp"], "env": { "ALPHASMO_API_KEY": "optional-your-key-here" } } } }
Both options work anonymously out of the box, at lower rate limits than with a key. Tools exposed:search_institutions,get_institution_profile,get_institution_holdings,get_stock_overview,get_stock_flows,get_insider_activity,get_smart_money_convergence.
Full endpoint reference:alphasmo.com/developer/docs.
import { AlphasmoClient } from "alphasmo"; const client = new AlphasmoClient(); // no apiKey needed to try it console.log(await client.getSmartMoneyConvergence({ limit: 5 }));
A Python client + MCP server is also available — seealphasmo.com/developerfor setup.
- alphasmo.com— the full web app: institution profiles, stock screeners, insider-trading leaderboards
- alphasmo.com/developer— get a free API key
- alphasmo.com/developer/docs— full public API reference
Educational Guides & SEC Filings Deep Dives
Deepen your understanding of institutional holdings and SEC filing dynamics:
- What Is a 13F Filing?— Beginner's guide to institutional holdings disclosures.
- What Is a Form 4 Filing?— How insider buying & selling gets reported.
- What Is a Form 144 Filing?— Understanding SEC pre-sale notices before insider dumps.
- 13D vs. 13G Beneficial Ownership— Uncovering 5% ownership filings and activist investor intent.
- How to Read Institutional Holdings Changes— Navigating 13F portfolio changes without being misled by stock splits or option mechanics.
Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp
Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT.
Live Polymarket prediction market data — whale trades, market odds, trader profiles, leaderboards, and AI-citable summaries.
Operate the AgentPump agent economy: read the live market and create, fund, tune, and run autonomous on-chain trading agents.
Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEs
Independent statistical validation for trading signals and backtests: deflated Sharpe, out-of-sample and leakage forensics, signed replayable verdicts; a methodology audit, not investment advice.
Hosted MCP server for Chinese A-share and ETF market data, including prices, fundamentals, capital flows, financial statements, real-time quotes, and news.
可转债高级策略 MCP Server — 双低/三低/YTM/强赎/下修6大策略引擎
Portfolio & trading-strategy stress diagnostics for AI agents: multi-asset stress with hedge-break detection, a daily preregistered regime outlook and deflated-Sharpe backtest-integrity checks. Remote streamable HTTP, free tier, no auth.
Real-time crypto whale intelligence MCP server with 54 tools across 14 blockchains. No auth required.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



