StockDrifts MCP server for stock research

A hosted Model Context Protocol server that gives an AI agent ownership data most market-data tools do not carry: rated US 13F funds with average buy prices, Korean insider trades, Japanese large-shareholding reports and company KPIs. 32 tools, all read-only.

Server URL: https://mcp.stockdrifts.io/mcp/
Transport: Streamable HTTP
Authentication: API key as a bearer header: Authorization: Bearer sd_live_...
MCP registry name: io.stockdrifts/mcp
REST API: https://api2.stockdrifts.io, same operations, spec at /openapi.json

Connect

Create a key at app.stockdrifts.io/settings/api-keys. API and MCP access is part of the Ultra plan, see pricing.

Claude Code

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

Claude Desktop, Cursor and other JSON configs

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

Codex

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

One command for every agent on the machine

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

Connection configs and an agent skill are in the public repository github.com/Stockdrifts/stockdrifts-mcp. Per-endpoint parameters and sample responses are in the API reference.

What an agent can ask

Rated US 13F funds

Every 13F filer carries a 1 to 5 star rating, and each position comes with the fund's estimated average buy price, its portfolio weight and the change in the quarter. Covers each fund's 50 largest positions.

Which 5-star funds hold NVDA, and what did each pay on average?
What did Berkshire Hathaway add and exit last quarter?
Which biotech specialist funds have the best record through trial readouts?

Korean insider trades

Executive and major-shareholder trades on KOSPI and KOSDAQ from DART filings, searchable by English company name. Includes pre-disclosed trading plans (D005) matched to the trades that followed, which has no direct US equivalent.

Which Korean stocks had the most open-market insider buying this month?
Show CEO purchases above 100 million KRW in the last 30 days.
Which insiders have announced a plan to buy and have not executed yet?

Japanese large shareholders

Large-shareholding reports under Japan's 5% rule from EDINET, per stock and per investor, with English names, the stated purpose of each holding and a star rating for each investor. These are reports by holders of 5% or more, not trades by company officers.

Which Japanese stocks did activist investors file on this month?
List every stake above 5% that one investor holds in Japan.
Where are three or more large investors filing on the same stock?

Company KPIs

The operating metrics a company reports outside its financial statements, such as net revenue retention, customer counts, remaining performance obligations, deliveries and backlog, as quarterly and yearly series.

Show Snowflake's net revenue retention by quarter.
How has this company's backlog moved over the last eight quarters?

All 32 tools

US · 13F Holdings

search_investors_us: Fuzzy, case-insensitive manager-name search ordered by AUM. Use this to resolve a name to a CIK before calling the investor endpoints.
get_investor_holdings_us: One investor's top-50 13F positions. Defaults to the latest period on file; pass period for a historical quarter.
list_investor_periods_us: All 13F periods on file for one investor, newest-first.
get_investor_changes_us: Quarter-over-quarter position diff for one investor: new, exited, added to, and trimmed.
list_ticker_holders_us: Funds holding a ticker as one of their 50 largest positions, sorted by position size. Smaller positions are not surfaced. Scoped to the latest period unless period is passed.

Screeners

screen_insiders: Screen insider activity by market, date, value, role, and ticker. One market per call: country='KR' returns individual insider transactions, country='JP' returns 5%+ shareholding reports. Switch on the echoed country before reading results — the two markets return different record shapes. No US coverage; use the 13F screen for US institutional flows.
screen_holdings_us: Screen 13F holdings by period, ticker, value, and rating. Returns each matched fund carrying only the position(s) that matched — slimmed rows (no cusip or per-row dates), with null fields omitted. Without a tickers filter, each fund's 5 largest positions are returned instead. Requires the holdings scope.

KPI

get_kpi: Normalized, company-specific Unique KPI Metrics — the operating metrics a company actually reports (iPhone revenue, deliveries, subscribers, RPO), each with a quarterly and yearly series. One snapshot per ticker; unknown tickers 404. Currency metrics carry an ISO currency code alongside the unit.

Korea · Insiders

list_insider_trades_kr: Insider trades for one KR ticker, newest-first. Paginated.
get_insider_summary_kr: Pre-aggregated all-time insider activity for one KR ticker, split by open-market (om_*), program (prog_*), and other bookings.
list_recent_trades_kr: Recent insider trades across all KR tickers. Paginated.
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 open-market BUYs whose price hasn't moved much since the filing — insider conviction you can still buy near their price.
list_plans_kr: D005 pre-disclosure plans — trades announced but not yet executed. Korea-only forward signal. Paginated.
get_plan_executions_kr: Cross-reference one D005 plan against the trades that actually executed against it — did the insider follow through?
list_leaderboard_kr: Top KR insiders by historical average return on their buys.
search_companies_kr: Search KR companies by stock_code prefix, Korean name, or English name. Omit q to list all companies by trade volume.

Japan · Shareholders

list_insider_filings_jp: 5%-rule large-shareholding reports for one JP ticker, newest-first. Paginated.
get_insider_summary_jp: Pre-aggregated all-time shareholding activity for one JP ticker, including an investor quality score and purpose mix.
list_recent_filings_jp: Recent JP filings across all tickers. Paginated.
list_top_buys_jp: Top JP tickers by aggregated investor buying over a window.
list_top_sells_jp: Top JP tickers by aggregated investor selling over a window.
list_opportunities_jp: Recent BUY/INITIAL filings whose price hasn't moved much since the filing.
list_leaderboard_jp: Top JP investors by star rating and historical average return.
list_convergence_jp: JP tickers with multiple distinct investors filing on the same name — crowding as a signal.
list_investor_filings_jp: All JP filings made by one investor, keyed by EDINET code.
search_companies_jp: Search JP companies by stock_code prefix, Japanese name, or English name. Omit q to list all companies by filing volume.

US · 13F fund profiles

get_investor_sector_exposure_us: Per-quarter portfolio composition by sector for one 13F fund, to see whether it is a sector specialist and how its mix is shifting.
screen_investor_sector_exposure_us: Rank 13F funds by the share of their portfolio in one sector, for example biotech specialists.
get_investor_catalyst_record_us: One fund's record of holding stocks through binary events (single-day moves of roughly 25% or more), per sector, with best and worst calls.
screen_investor_catalyst_record_us: Rank 13F funds by how their positions resolved through binary events such as trial readouts, earnings and buyouts.

What it does not cover

Share prices, quotes, news and financial statements.
US insider trades from Form 4.
13F positions outside a fund's 50 largest, so a holder list is not complete.
Live returns: return fields on Korean and Japanese rows are measured when the row was last updated.

The data is for research and is not investment advice.

Questions

Is there an MCP server for 13F hedge fund holdings?

Yes. The StockDrifts MCP server returns the funds that hold a ticker, each fund's star rating, position size, portfolio weight, quarterly change and estimated average buy price. It covers each fund's 50 largest positions from quarterly 13F filings, which are filed up to 45 days after quarter end.

How can an AI agent get Korean insider trading data in English?

Connect the StockDrifts MCP server and call list_recent_trades_kr, list_top_buys_kr or list_insider_trades_kr. The data comes from DART filings by executives and major shareholders of KOSPI and KOSDAQ companies. Company search accepts English names; names and positions of individual insiders are returned in Korean. Pre-disclosed trading plans are available through list_plans_kr.

Does it cover Japan's large-shareholding (5% rule) reports?

Yes. Filings from EDINET are available per stock and per investor with English names for filers and issuers, the stated purpose of the holding, and a star rating for each investor. list_recent_filings_jp scans the market, and list_investor_filings_jp returns every filing made by one investor.

Which AI clients can use it?

Any MCP client that supports Streamable HTTP with a bearer header, including Claude Code, Claude Desktop, Cursor and Codex. The same operations are available as a REST API for agents that call HTTP directly.

Does it need an API key?

Listing the tools works without a key. Every tool call needs a StockDrifts API key sent as a bearer header. API and MCP access is part of the Ultra plan.

Can the tools change or write anything?

No. Every tool is read-only.