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.

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 [email protected].

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.

StockDrifts MCP Server