DEV Community

Cover image for How to Track What Hedge Funds Are Buying — Directly From Your AI Agent
James from AlphaSMO
James from AlphaSMO

Posted on • Originally published at alphasmo.com

How to Track What Hedge Funds Are Buying — Directly From Your AI Agent

#mcp #ai #finance #tutorial

What if your AI agent could track what Warren Buffett is buying — in real time?

That is exactly what the AlphaSMO MCP server unlocks.

You have probably heard about the Model Context Protocol (MCP) — the open standard that lets AI agents like Claude, ChatGPT, and Cursor talk to external tools and APIs. Instead of hallucinating answers or being stuck with stale training data, an MCP-equipped agent can reach out to live data sources and pull back real, structured information mid-conversation.

But most MCP servers today are built for developer tools — file systems, databases, GitHub, Postgres. Few bring real-world financial intelligence to your AI agent.

That is where AlphaSMO comes in.

What is AlphaSMO?

AlphaSMO is a platform that processes SEC 13F filings — the quarterly reports that every hedge fund, mutual fund, and institutional investor managing over $100M must file with the SEC — and turns them into clean, queryable data.

Think of it as "Bloomberg Terminal data, but for AI agents".

The AlphaSMO MCP server exposes 7 tools that your AI agent can call directly:

Tool What It Does
search_institutions Search 5,000+ institutional investors by name (e.g. "Berkshire", "Bridgewater")
get_institution_profile Get an institution's AUM, holding count, and personality scores (concentration, turnover, sector conviction)
get_institution_holdings See exactly which stocks a fund holds — ticker, value, weight, and buy/sell action vs last quarter
get_stock_overview Full institutional ownership picture for any stock: holder count, net flow, top holders by value and conviction
get_stock_flows Stocks ranked by net institutional buy or sell flow in the latest quarter
get_insider_activity Form 4 insider trading: what officers, directors, and 10% owners are doing with their own shares
get_smart_money_convergence 🚀 The flagship signal: tickers where 13F institutions AND company insiders are buying at the same time

Why 13F Data Matters for AI Agents

Every quarter, over 5,000 institutional investors managing $45+ trillion in assets must disclose their holdings to the SEC. This is not speculation or rumor — it is legally mandated transparency.

The catch? Raw 13F filings are text-based, CUSIP-coded, and virtually unreadable without processing. That is why most retail investors never touch them.

AlphaSMO does the heavy lifting:

  • Resolves cryptic CUSIP identifiers to real ticker symbols
  • Calculates net institutional flow (who is buying vs selling)
  • Computes behavioral "personality scores" for each institution (concentration, turnover, sector conviction)
  • Cross-references 13F filings with Form 4 insider transactions

And now, through the MCP server, your AI agent gets all of this in a single function call.

The Secret Weapon: Smart Money Convergence

Most financial data APIs give you one signal at a time — either institutional flows or insider trading. AlphaSMO is the only MCP server that combines both into a single convergence signal.

get_smart_money_convergence returns tickers where:

  1. ✅ Multiple 13F institutions are increasing their positions, AND
  2. ✅ Company insiders are buying their own stock on the open market

When the people who manage billions and the people who run the company are both buying — that is a signal worth paying attention to.

{
  "ticker": "NVDA",
  "issuer": "NVIDIA CORP",
  "institutional_buy_score": 92,
  "insider_confidence": 85,
  "convergence_signal": "STRONG_BUY"
}
Enter fullscreen mode Exit fullscreen mode

Read more about the convergence methodology on the AlphaSMO website.

One Command to Get Started

No signup. No API key. No credit card. Just run:

npx alphasmo convergence --limit 5
Enter fullscreen mode Exit fullscreen mode

This prints a table of the top tickers where smart money is converging right now. Here is what real output looks like:

Ticker  Issuer                      Net Flow (USD)     Confidence
BRK-A   BERKSHIRE HATHAWAY INC-CL A  247,455,256,379    94
NVDA    NVIDIA CORP                   52,103,888,155    92
META    META PLATFORMS INC            38,033,517,696    90
AMZN    AMAZON COM INC                35,611,305,945    88
AVGO    BROADCOM INC                  31,209,512,395    87
Enter fullscreen mode Exit fullscreen mode

Your AI agent sees the EXACT same structured data.

Wiring It Into Your AI Agent

Claude Code (recommended) 

claude mcp add alphasmo -- npx -y alphasmo@latest mcp
Enter fullscreen mode Exit fullscreen mode

Claude Desktop / Cursor / Any MCP Client 

{
  "mcpServers": {
    "alphasmo": {
      "command": "npx",
      "args": ["alphasmo", "mcp"],
      "env": {
        "ALPHASMO_API_KEY": "your-free-key-here"
      }
    }
  }
}
Enter fullscreen mode Exit fullscreen mode

Programmatic Use (TypeScript) 

import { AlphasmoClient } from "alphasmo";

const client = new AlphasmoClient();
const convergence = await client.getSmartMoneyConvergence({ limit: 5 });
console.log(convergence);
Enter fullscreen mode Exit fullscreen mode

Python client also available — see alphasmo.com/developer.

Real-World Use Cases

Here is what you can ask your AI agent once the AlphaSMO MCP server is connected:

"What stocks are institutions buying the most right now?"

"Show me Berkshire Hathaway's latest 13F holdings, sorted by position size."

"Are insiders buying or selling NVDA? Give me the confidence score."

"Find tickers where BOTH hedge funds and company executives are accumulating."

"Which sectors is Bridgewater overweight in this quarter?"

Each question triggers a real API call behind the scenes — no hallucinated answers, no stale training data.

Why AlphaSMO Is Unique

There are plenty of financial data APIs. There are plenty of MCP servers. But AlphaSMO is the only MCP server that bridges institutional 13F data and insider trading into a unified, AI-ready interface.

Key differentiators:

  • 🆓 Free tier with no signup — run npx alphasmo right now, no account needed
  • 📊 13F + Form 4 combined — two independent signal sources, one API
  • 🤖 Built for MCP first — not a REST API with an MCP wrapper bolted on; the MCP tools are first-class
  • 🎯 Personality scores — know if an institution is a concentrated conviction investor or an index-hugging closet tracker
  • 📦 One dependency — npx alphasmo mcp. No database to run, no data to ingest

What is Under the Hood

The AlphaSMO MCP server is open source (MIT license):

Built with the official @modelcontextprotocol/sdk, Zod schema validation, and structured content support for both TypeScript and Python MCP clients.

Get Your Free API Key

Anonymous access works out of the box (rate-limited by IP). To raise your limit, grab a free key at alphasmo.com/developer.

Then set it and forget it:

export ALPHASMO_API_KEY=ask_live_...
Enter fullscreen mode Exit fullscreen mode

The Bottom Line

AI agents are only as good as the data they can access. MCP is the protocol that connects them to the real world. And AlphaSMO is the MCP server that connects them to the $45 trillion world of institutional money flows.

Stop asking your AI to guess what smart money is doing. Give it the tools to know.

npx alphasmo convergence --limit 10
Enter fullscreen mode Exit fullscreen mode

Disclaimer: This article is for informational and educational purposes only. It does not constitute investment advice. Past institutional behavior does not guarantee future results. 13F data has a 45-day filing delay. Always do your own research.

Top comments (0)