How do I use StockDrifts MCP Server?

1. Click on "Deploy 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., "@StockDrifts MCP Server Which 5-star 13F funds hold NVDA and their average buy prices?" 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.

StockDrifts MCP Server

Official

by Stockdrifts

Overview Schema Source Related Servers Discussions Admin

Remote

StockDrifts MCP Server

Ownership data for AI agents: rated US 13F funds and their average buy prices, normalized company KPIs, Japanese large-shareholder filings with investor ratings, and Korean insider buys.

Hosted endpoint: https://mcp.stockdrifts.io/mcp/ (Streamable HTTP)
Tools: 32, all read-only
Auth: API key sent as a bearer header
Docs: https://www.stockdrifts.io/api-docs
Registry name: io.stockdrifts/mcp

This repository holds the connection configs, the registry manifest and an agent skill. The server itself is hosted by StockDrifts; there is nothing to build or run.

What is different about the data

Dataset	What you get	Source
Rated 13F funds	13F filers with star ratings, holdings by quarter, quarter-over-quarter changes, sector exposure, and each fund's average buy price per position	SEC 13F filings
Company KPIs	Company-specific operating metrics per ticker, such as segment revenue, customer counts, net revenue retention and backlog, as quarterly and yearly series	Company filings
Japanese investors	Large-shareholding (5%-rule) reports per stock and per investor, an investor leaderboard with star ratings, and stocks where several investors are filing at once	EDINET
Korean insiders	Executive and major-shareholder trades, top insider buys and sells, an insider leaderboard, and pre-disclosed trading plans matched to their executions	DART

Japanese 5%-rule reports are filings by large shareholders. They are not the same thing as US director and officer trade reports.

Related MCP server: Equibles Agent Terminal

Connect

You need an API key. Create one at https://app.stockdrifts.io/settings/api-keys (API and MCP access is part of the Ultra plan, see pricing).

Replace sd_live_... in the snippets below with your key, and keep any file that contains it out of version control.

Claude Code

claude mcp add --transport http stockdrifts https://mcp.stockdrifts.io/mcp/ \
  --header "Authorization: Bearer sd_live_..."

Or install this repository as a plugin (server plus skill). Claude Code asks for the key once and keeps it in your system's secure credential store:

/plugin marketplace add Stockdrifts/stockdrifts-mcp
/plugin install stockdrifts@stockdrifts

Claude Desktop, Cursor and other JSON-config clients

{
  "mcpServers": {
    "stockdrifts": {
      "type": "http",
      "url": "https://mcp.stockdrifts.io/mcp/",
      "headers": { "Authorization": "Bearer sd_live_..." }
    }
  }
}

Codex CLI

In ~/.codex/config.toml (Codex spells the field http_headers):

[mcp_servers.stockdrifts]
url = "https://mcp.stockdrifts.io/mcp/"
http_headers = { Authorization = "Bearer sd_live_..." }

One-command installer

The @stockdrifts/cli package registers a local stdio server with Claude Code, Claude Desktop, Cursor or Codex and stores the key in ~/.stockdrifts/config.json (mode 600), so no secret is written into the agent's own config:

npx -y @stockdrifts/cli@latest install all --key sd_live_...
npx -y @stockdrifts/cli@latest doctor

Example prompts

"Which 5-star 13F funds hold NVDA in their top positions, and what is each fund's average buy price?"
"What did this fund add and cut last quarter?"
"Show Korean open-market insider buys above ₩1bn in the last 30 days."
"Which pre-disclosed Korean insider buy plans have not been executed yet?"
"Which Japanese stocks have several investors filing 5% reports at the same time?"
"Give me the KPI history for this ticker."

Tools

US 13F funds

Tool	What it returns
`search_investors_us`	Fuzzy-search investors by name; resolves to CIKs ordered by AUM
`screen_investor_sector_exposure_us`	Screen investors by sector concentration (e.g. top biotech specialists)
`screen_investor_catalyst_record_us`	Screen funds by their track record on binary events (any sector)
`get_investor_holdings_us`	Latest 13F holdings for one investor (or for a specific period)
`list_investor_periods_us`	All 13F periods on file for one investor
`get_investor_changes_us`	QoQ position diff for one investor between two periods
`get_investor_sector_exposure_us`	Sector-exposure history for one investor (newest quarter first)
`get_investor_catalyst_record_us`	One fund's binary-event track record per sector, with best/worst calls
`list_ticker_holders_us`	Investors with `ticker` in their top-50 positions, sorted by position size
`screen_holdings_us`	Screen 13F holdings by period, ticker, value, and rating; returns each matched fund with only the position(s) that matched

Company KPIs

Tool	What it returns
`get_kpi`	Latest normalized KPI snapshot for one ticker

Japan (EDINET large-shareholding filings)

Tool	What it returns
`list_insider_filings_jp`	Shareholding-report filings for one JP ticker
`get_insider_summary_jp`	Pre-aggregated shareholding summary for one JP ticker
`list_recent_filings_jp`	Recent JP filings across all tickers
`list_top_buys_jp`	Top JP tickers by aggregated buying over a window
`list_top_sells_jp`	Top JP tickers by aggregated selling over a window
`list_investor_filings_jp`	All JP filings made by one investor (EDINET code)
`list_opportunities_jp`	Recent JP BUY/INITIAL filings whose price hasn't moved much yet
`list_leaderboard_jp`	Top JP investors by star rating + avg return
`list_convergence_jp`	JP tickers with multiple distinct investors filing on the same name
`search_companies_jp`	Search JP companies by stock_code, Japanese name, or English name

Korea (DART insider filings)

Tool	What it returns
`list_insider_trades_kr`	Insider trades for one KR ticker
`get_insider_summary_kr`	Pre-aggregated insider summary for one KR ticker
`list_recent_trades_kr`	Recent KR insider trades across all tickers
`list_top_buys_kr`	Top KR tickers by aggregated insider buying over a window
`list_top_sells_kr`	Top KR tickers by aggregated insider selling over a window
`list_opportunities_kr`	Recent KR open-market BUYs whose price hasn't moved much yet
`list_plans_kr`	KR pre-disclosure (D005) plans: announced but not yet executed trades
`get_plan_executions_kr`	Cross-reference one D005 plan against its actual executions
`search_companies_kr`	Search KR companies by stock_code, Korean name, or English name
`list_leaderboard_kr`	Top KR insiders by historical avg return on their buys

Cross-market screen

Tool	What it returns
`screen_insiders`	Screen insider activity by country, date, value, role, and ticker

Security

Send the key only in the Authorization header. Do not put it in the URL, where it can end up in logs and shell history.
The MCP server stores no keys. Your bearer token is forwarded to api2.stockdrifts.io, where authentication, rate limits and usage are enforced.
Every tool is read-only. Nothing in this server writes, trades or changes account state.
Without a key the server lists its tools and returns an unauthorized error for every call. No data is served.
Rotate or revoke keys at https://app.stockdrifts.io/settings/api-keys.
Report a security issue to hk@stockdrifts.io.

Rate limits and errors

Limits are enforced per key in one-minute windows, and responses carry X-RateLimit-* headers. Errors use one shape: {"error": {"code", "message", "hint"}}. See the API reference.

Data notes

Value fields carry their currency in the name (value_usd, value_krw, value_jpy). Nothing is converted silently.
13F periods are quarter-end dates such as 2026-06-30. Leave the period out to get the latest quarter on file.
13F filings are quarterly and published up to 45 days after quarter end.
The data is for research. It is not investment advice.

License

The files in this repository are MIT licensed. Access to the StockDrifts API and the data it returns is a separate paid service under the StockDrifts Terms and Privacy Policy.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

ko-mcp A
io.github.SharpLu
Real SEC, 13F, insider, congress & macro data your AI agent can cite. Hosted MCP, 24 tools.
Finance Government Data
242
EvidInvestOAuth
io.github.EvidInvest
SEC filings and financial data for AI agents: 59 tools for statements, valuation and supply chains.
Finance Open Data Data Platforms
1
Stockfacts AOAuth
io.github.AAAZZZR
US stock market data for AI agents: SEC filings, financials, insider trades, 13F, options, macro.
Finance Research & Data
182
Rockmoon Financial Data B
ai.rockmoon
Cross-market (US/JP/KR) structured financials, segments, ownership & metrics, traceable to filings.
Finance Open Data
192

Related MCP Servers

ROIC.ai Financial Data MCPofficial
Finance Search
roicai
A
license
A
quality
C
maintenance
Enables AI assistants to access stock prices, financial statements, earnings call transcripts, and fundamental data for 60,000+ public companies via 25 read-only tools.
Updated 2 months ago (2026-08-07 10:58 UTC)
25
2
MIT
Equibles Agent Terminal
Finance Research & Data
clauxel
F
license
Not graded
quality
F
maintenance
Provides financial data and market filings via Streamable HTTP tools. Enables AI agents to resolve equity entities, fetch SEC filings, compare institutional holders, and export finance receipts.
Updated 4 months ago (2026-05-27 16:06 UTC)
-
xoomar-mcp
Finance Open Data Government Data
xoomar-dev-cloud
A
license
A
quality
C
maintenance
Enables AI agents to query free public market data through 21 tools spanning 29 datasets sourced from SEC EDGAR/XBRL, FINRA, CFTC, the Federal Reserve, USAspending and exchange APIs. Covers short interest, insider and fund holdings, company financials, macro and policy rates, funding rates, crypto market metrics, IPOs and federal contracts, with no API key required to start.
Updated 19 days ago (2026-09-20 12:48 UTC)
22
355 npm
Apache 2.0
financial-datasets
Finance Research & Data
pipeworx-io
A
license
Not graded
quality
B
maintenance
Enables AI agents to query financial datasets, including institutional holders, insider transactions, investor portfolios, and SEC filings, via MCP tools.
Updated 13 days ago (2026-09-26 12:27 UTC)
233 npm
MIT

StockDrifts MCP Server

What is different about the data

Connect

Claude Code

Claude Desktop, Cursor and other JSON-config clients

Codex CLI

One-command installer

Example prompts

Tools

Security

Rate limits and errors

Data notes

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

ROIC.ai Financial Data MCPofficial

Equibles Agent Terminal

xoomar-mcp

financial-datasets