alphasmo tools

Name: alphasmo tools
Author: alphasmo

CommunityIncomplete39/100Beanspruchen

npm alphasmostdioMITupdated 27d ago

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.).

Quellcode Website Docs2

Was kannst du mit alphasmo tools machen?

AlphaSMO — The Ultimate Smart Money API for AI

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). Read our guide on What Is a 13F Filing? and How 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 in What Is a Form 4 Filing? and What Is a Form 144 Filing?.
🚀 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.

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

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.

License

MIT

Installation

alphasmo tools zu deinem Client hinzufügen. Wähl den, den du nutzt.

claude mcp add alphasmo -- npx -y alphasmo

codex mcp add alphasmo -- npx -y alphasmo

amp mcp add alphasmo -- npx -y alphasmo

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

code --add-mcp '{"name":"alphasmo","command":"npx","args":["-y","alphasmo"]}'

Or add the block manually to `.vscode/mcp.json` under `servers`.

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "alphasmo": {
      "type": "local",
      "command": "npx",
      "args": [
        "-y",
        "alphasmo"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "alphasmo": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "alphasmo"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

npx -y alphasmo

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

alphasmo tools

Was kannst du mit alphasmo tools machen?

AlphaSMO — The Ultimate Smart Money API for AI

Why AlphaSMO

Use cases

CLI

Commands

Get an API key

MCP server

Option 1: `claude mcp add` (recommended)

Option 2: manual MCP client config

Programmatic use

Learn more

Educational Guides & SEC Filings Deep Dives

License

Installation

Score

Versionsverlauf

Was kannst du mit alphasmo tools machen?

AlphaSMO — The Ultimate Smart Money API for AI

Why AlphaSMO

Use cases

CLI

Commands

Get an API key

MCP server

Option 1: claude mcp add (recommended)

Option 2: manual MCP client config

Programmatic use

Learn more

Educational Guides & SEC Filings Deep Dives

License

Installation

Score

Versionsverlauf

Option 1: `claude mcp add` (recommended)