Docs

Followin MCP integration guide and tool reference

Quickstart

Get integrated in 5 minutes — no code required.

1
Get your API Key
After signing up for a Followin account, copy your API Key from the dashboard page.
2
Pick a client and add the config
Pick your AI client, apply the config shown for it, and replace YOUR_API_KEY_HERE with your own key.

Standard for the latest clients (new Claude Desktop, claude.ai connector, Codex).

Paste this to any coding agent (Claude Code, Cursor, Codex …) and it'll wire up the connection for you — just swap in your API key first.

Install the Followin MCP server for me: https://mcp.followin.io/v2/mcp
It's a Streamable HTTP endpoint that needs the header  x-api-key: YOUR_API_KEY_HERE
3
Restart or reconnect
Restart or reconnect your AI client and the Followin MCP tools become available.

What you can ask

Once you're connected, just ask in plain language. Here's what you can do and how to phrase it — most answers come from one question.

7000+ US stocks, ETFs and Treasuries, plus fundamentals, ratings, and SEC-filing signals.

US-stock & crypto KOLs, live

Ask
  • What are US-stock KOLs talking about today?
  • How are KOLs reading NBIS this week?

You get Latest curated tweets from 230+ KOLs, multilingual.

Research & analyst reports

Ask
  • Any independent analyst research today?
  • Pull the research and deep dives on MU.

You get Independent analyst write-ups plus financial-media research.

Live quotes — stocks, ETFs, and Treasuries

Ask
  • What are AAPL, NVDA, and MU trading at right now?
  • Show me today’s Treasury yield curve.

You get Real-time price / change / volume, the full yield curve, and FX.

Fundamentals — statements, ratios, earnings

Ask
  • Give me NVDA’s full fundamentals.
  • When does MU next report, and what’s the estimate?

You get 3 statements, 22+ ratios, growth rates, beat/miss history, next-earnings estimate.

Analyst ratings — 20+ banks

Ask
  • What do the banks rate MU, and what’s the consensus price target?

You get Per-bank ratings plus consensus target (median / high / low).

Insider & 13F filings

Ask
  • Are NVDA insiders buying or selling?
  • How did TSLA’s 13F holdings change?

You get SEC Form 4 insider trades plus 13F institutional positions.

Macro calendar & FRED

Ask
  • What’s on the economic calendar this week?
  • Latest US CPI, fed funds rate, and unemployment?

You get FOMC / CPI / NFP with actual-estimate-previous, plus FRED time series.

Cross-market — crypto × equities × macro

Ask
  • How are BTC, MSTR, and US-stock KOLs reacting to Binance listing stocks?

You get One question fans out across news, both-side prices, and KOL takes.

Advanced — sharpen your agent’s routing

Paste this primer into your CLAUDE.md or project memory so your agent knows which tool to call for each intent, how to disambiguate crypto vs US stocks, and when to chain calls.

CLAUDE.md
# Followin MCP - when to call (routing primer)
You have Followin MCP connected: crypto + US-equity news / signal / market data. For the intents below, call the tools - don't answer from memory. Each tool's own description carries the full COVERS map and the cross-tool boundaries; this primer is only the orchestration overview.

## Routing (intent -> tool)
- Prices, quotes, OHLCV history, technicals, macro data, fundamentals (incl. analyst ratings/targets, earnings calendar, peers) -> metrics
- News / commentary / research / tweets / channel posts -> news
- Who's buying: KOL calls / whales / insiders / 13F holdings -> signal
- Raw Twitter ops on a named account or tweet -> twitter

## Conventions
- US stocks asset_type="tradfi"; crypto asset_type="crypto".

## Common orchestrations
- US-stock due diligence = metrics(["market"]) + metrics(["fundamentals"]) + news(["twitter"]) + news(["research"]) + signal(["insider_trading"])
- Crypto monitoring = metrics(["market"]) + signal(["kol_call"], query="consensus") + signal(["trader_position"]) + news(["media"])
Found a bug or have a feature request? Email us at feedback@followin.io