Stockdrifts MCP Server

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

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

Company KPIs

Japan (EDINET large-shareholding filings)

Korea (DART insider filings)

Cross-market screen

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.