How do I use AlphaSMO Tools MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@AlphaSMO Tools MCP Server what is smart money buying right now" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

AlphaSMO Tools MCP Server

by alphasmo

Overview Schema Related Servers Score Discussions

TypeScript

AlphaSMO — The Ultimate Smart Money API for AI

npm version License: MIT

CLI + MCP server for AlphaSMO — SEC EDGAR 13F institutional holdings, Form 4 insider trading, and "smart money convergence" signals (tickers where hedge funds and company 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:

npx alphasmo stocks flows --limit 10

Example output:

┌────────┬──────────────────────────────┬────────────────────┬──────────────┬──────────────┐
│ 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         │
└────────┴──────────────────────────────┴────────────────────┴──────────────┴──────────────┘

Why AlphaSMO

📊 13F institutional holdings — every hedge fund and asset manager's quarterly SEC filings: AUM, positions, and behavioral "personality scores" (concentration, turnover, sector conviction).
🕵️ Insider trading (Form 4) — officer/director/10%-owner buys and sells, with a confidence score per ticker.
🚀 Smart money convergence — the flagship signal: tickers where 13F institutions and company 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 key any time to raise your rate limit.

Related MCP server: edgar-mcp

Use cases

"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 (see below) and ask these in plain English — no code required.

CLI

npx alphasmo institutions search "Berkshire"
npx alphasmo stocks get AAPL
npx alphasmo convergence -l 5

No install step required — npx fetches and runs it. Or install globally:

npm install -g alphasmo
alphasmo --help

Commands

Command	What it returns
`alphasmo institutions search <query> [-l\|--limit]`	Search 13F institutions by name
`alphasmo institutions list [-l\|--limit] [-o\|--offset]`	Paginate the full institution universe (no query)
`alphasmo institutions get <slug>`	Full institution detail, sector weights
`alphasmo institutions holdings <slug>`	Latest 13F holdings for one institution
`alphasmo stocks get <identifier>`	Full stock detail — holder count, flows, top holders (identifier = ticker or CUSIP)
`alphasmo stocks flows [-d\|--direction buy\|sell] [-l\|--limit]`	Stocks ranked by net institutional buy/sell flow
`alphasmo insider trades <ticker>`	Recent individual Form 4 insider trades for one ticker
`alphasmo insider summary <ticker>`	Insider confidence scores (30d/90d) for one ticker
`alphasmo convergence [-l\|--limit] [--min-confidence] [--days]`	Tickers where 13F institutions and insiders are both buying — the flagship signal
`alphasmo mcp`	Start the MCP server over stdio

Global flags on every command: --api-key <key> (env ALPHASMO_API_KEY), --base-url <url> (env ALPHASMO_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 into jq or feed to an agent.
--format/--json/--csv always 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 (2 not found, 3 auth, 4 rate limit, 5 unexpected response shape, 1 other), so scripts can branch without string-matching.

Get an API key

Anonymous requests are rate-limited by IP. Sign up and mint a free key at alphasmo.com/developer, then:

alphasmo convergence --api-key ask_live_...
# or
export ALPHASMO_API_KEY=ask_live_...

MCP server

Option 1: `claude mcp add` (recommended)

If you're using Claude 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. Run claude mcp list to confirm it's connected.

Option 2: manual MCP client config

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.

Programmatic use

import { AlphasmoClient } from "alphasmo";

const client = new AlphasmoClient(); // no apiKey needed to try it
console.log(await client.getSmartMoneyConvergence({ limit: 5 }));

npm install alphasmo

A Python client + MCP server is also available — see alphasmo.com/developer for setup.

Learn more

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

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

EdgarTools MCP
Finance Search Research & Data
sareegpt
A
license
-
quality
C
maintenance
Enables LLMs to download, parse, and analyze SEC EDGAR filings, including 10-K/Q reports, XBRL financial statements, and insider trading data. It provides structured access to institutional holdings, corporate events, and financial facts for comprehensive investment research.
Last updated 2026-02-18
1
MIT
edgar-mcp
Finance Search Open Data
henrysouchien
A
license
A
quality
B
maintenance
Provides access to SEC EDGAR financial data, enabling AI agents to fetch company filings, financial metrics, and narrative sections. It supports natural-language metric searching and extracts structured data from 10-K, 10-Q, and 8-K reports.
Last updated 2026-07-15
6
MIT
Signal8 MCP Serverofficial
Finance Research & Data Legal & Compliance
signal8ai
A
license
A
quality
D
maintenance
Provides AI agents with direct access to SEC filing intelligence, company fundamentals, dilution risk scoring, and cross-company analytics for financial research.
Last updated 2026-07-30
87
149
1
MIT
mcp-edgar
Finance Government Data Open Data
cmanohar
A
license
-
quality
C
maintenance
Enables LLMs to access SEC EDGAR data: search filings, extract sections, pull structured financials, and track insider transactions.
Last updated 2026-04-28
32
MIT

View all related MCP servers

Related MCP Connectors

ko-mcp
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Drillr — The financial MCP for AI agents
The financial MCP for AI agents - 90+ financial tables, SEC filings, signals, alt-data.
plainyogurt21-sec-edgar-mcp
Provide AI assistants with real-time access to official SEC EDGAR filings and financial data. Enab…

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/alphasmo/alphasmo-tools'

If you have feedback or need assistance with the MCP directory API, please join our Discord server