protogrid

Search / io.github.juh5ng/korea-stock-research-mcp

K-Data — Korean Sell-Side Research & Market Data

R0· no sign-in

Korean equity research, analyst revisions, kimchi premium and news via x402.

v0.3.0 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality69needs work
Trust94of 100
Uptime, 30 days97%
Latency p50296 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "korea-stock-research-mcp": {
      "type": "http",
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    }
  }
}
claude mcp add --transport http korea-stock-research-mcp https://k-data-x402-production.theblack1022.workers.dev/mcp
[mcp_servers.korea-stock-research-mcp]
url = "https://k-data-x402-production.theblack1022.workers.dev/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "korea-stock-research-mcp": {
      "type": "remote",
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "korea-stock-research-mcp": {
      "type": "http",
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=korea-stock-research-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vay1kYXRhLXg0MDItcHJvZHVjdGlvbi50aGVibGFjazEwMjIud29ya2Vycy5kZXYvbWNwIn0%3D"
}
{
  "servers": {
    "korea-stock-research-mcp": {
      "type": "http",
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    }
  }
}
{
  "mcpServers": {
    "korea-stock-research-mcp": {
      "httpUrl": "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    }
  }
}
extensions:
  "korea-stock-research-mcp":
    enabled: true
    name: "korea-stock-research-mcp"
    type: streamable_http
    uri: "https://k-data-x402-production.theblack1022.workers.dev/mcp"
    timeout: 300

Quality 69 / 100needs work

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene71 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • fail
    tools.annotationsno tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: kimchi_premium (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); research_company_ticker (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); news_headlines_en (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
  • pass
    tools.token_costabout 1,917 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability75 · weight 15
  • warn
    stability.changes7 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependencies50 · weight 15
  • warn
    deps.known_vulns1 advisory of lower severity or without a published fix: GHSA-5r4p-p66f-jhc7 in [email protected] (indirect, fixed in 4.13.11)
  • fail
    deps.mcp_sdk_version@modelcontextprotocol/sdk 1.30.1 has 3 known advisories (GHSA-22jm-h49p-29qw, GHSA-6prh-2h8m-c8cw, GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.32.0 or later
  • pass
    deps.resolvable[email protected] resolved: 116 packages

16 tools, about 1,917 tokens to load them all · tool set 590b4b6509ee · tools last changed 2026-10-03 · checked 2026-10-21 04:51 UTC

Tool changes

  • kimchi_premium_historychangeddescription, input schema
    before

    Time series of the kimchi premium from the continuous archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000). Archive depth is reported as first_recorded. Costs $0.08 in USDC per call, settled via x402.

    after · 59% of words in common

    Time series of the kimchi premium from the recorded archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000) &before=<next_before>. Each page is a separate paid request. Continue while has_more is true using next_before. Inspect actual archive depth and freshness through /api/preview/premium-coverage before buying. Costs $0.08 in USDC per call, settled via x402.

  • kimchi_premium_statschangeddescription
    before

    Where the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from a continuous archive that cannot be reconstructed from any free source. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official. Costs $0.12 in USDC per call, settled via x402.

    after · 80% of words in common

    Where the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from the recorded archive; inspect actual dates and freshness with the free coverage endpoint. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official. Costs $0.12 in USDC per call, settled via x402.

  • kimchi_premiumchangeddescription
    before

    Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — the margin actually realizable, since the KRW exit leg goes through USDT rather than banks). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10). Costs $0.03 in USDC per call, settled via x402.

    after · 59% of words in common

    Kimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — a gross spot-price comparison using KRW/USDT conversion, before spreads, fees, liquidity and transfer constraints). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10). Costs $0.03 in USDC per call, settled via x402.

  • preview_kimchi_premiumadded

    Free live BTC-only sample of the dual-basis kimchi premium. Use the paid endpoint for up to 10 symbols.

  • preview_researchadded

    Free, date-stamped archive-depth check for one 6-digit KRX ticker. Shows report and brokerage counts, not report content or consensus.

  • preview_research_coverageadded

    Free, date-stamped KRX research coverage. Lists the most-covered tickers with report count, brokerage count, and archive date range; it does not reveal report content.

  • preview_premium_coverageadded

    Free archive coverage and freshness for each recorded coin. Check sample count, first and latest timestamps, and stale flag before buying premium statistics or history.

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 94 / 100

provenance90
liveness99
freshness85
hygiene100

+repository +namespace-matches-repo +website +reachable +uptime-97% ~updated-45d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] npm115 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.30.1 · advisories checked 2026-10-20

advisoryseveritypackagefixed in
GHSA-22jm-h49p-29qwMCP TypeScript SDK: Experimental tasks were not tied to the session that created themhigh@modelcontextprotocol/[email protected]MCP SDK, directfixed in 1.32.0
GHSA-6qxp-vccf-f47hMCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP serverhigh@modelcontextprotocol/[email protected]MCP SDK, directfixed in 1.31.0
GHSA-6prh-2h8m-c8cwMCP TypeScript client SDK: HTTP client transports and OAuth requests followed cross-origin redirects and re-sent custom headers and request bodiesmoderate@modelcontextprotocol/[email protected]MCP SDK, directfixed in 1.32.0
GHSA-5r4p-p66f-jhc7Hono: `serveStatic` decodes the request path a second time, leading to bypass of middleware on static pathsmoderate[email protected]indirectfixed in 4.13.11

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://k-data-x402-production.theblack1022.workers.dev/mcp streamable-httpnoneyes97%296 ms2025-06-182026-10-21
packageregistryversionruntimesecrets
k-data-mcpnpm0.3.0–K_DATA_PRIVATE_KEY

Tools (16)

crypto_krw_marketsSnapshot of all Upbit KRW crypto markets: top by 24h traded value, top gainers, top losers. Optional ?limit=30 (max 100) for the volume ranking. Costs $0.01 in USDC per call, settled via x402.
crypto_krw_tickerLive quote for one Upbit KRW market by ticker symbol (e.g. BTC, ETH, XRP): price, 24h change, 24h high/low, 24h traded value in KRW. Costs $0.005 in USDC per call, settled via x402.
fx_usdkrwCurrent USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com). Costs $0.005 in USDC per call, settled via x402.
kimchi_premiumKimchi premium on two bases: premium_official_pct (official USD/KRW rate — the quoted figure) and premium_usdt_pct (Upbit KRW/USDT rate — a gross spot-price comparison using KRW/USDT conversion, before spreads, fees, liquidity and transfer constraints). The two frequently disagree in sign. Optional ?symbols=BTC,ETH (max 10). Costs $0.03 in USDC per call, settled via x402.
kimchi_premium_historyTime series of the kimchi premium from the recorded archive, both bases, newest-last. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &points=500 (max 2000) &before=<next_before>. Each page is a separate paid request. Continue while has_more is true using next_before. Inspect actual archive depth and freshness through /api/preview/premium-coverage before buying. Costs $0.08 in USDC per call, settled via x402.
kimchi_premium_statsWhere the current kimchi premium sits inside its own recent distribution: percentile, mean, stdev, z-score, min/max/median, and a plain-language read. Answers 'is this premium unusual right now?' in one call. Built from the recorded archive; inspect actual dates and freshness with the free coverage endpoint. Params: ?symbol=BTC &window=1h|6h|24h|7d|30d|90d &basis=usdt|official. Costs $0.12 in USDC per call, settled via x402.
korea_market_snapshotOne-call Korea briefing: dual-basis kimchi premium + top Upbit KRW markets + USD/KRW + latest economy headlines translated to English. Everything needed for a Korea market read in a single paid request. Costs $0.08 in USDC per call, settled via x402.
news_headlinesLatest Korean headlines from Yonhap, Maeil Business and Hankyung, deduplicated and newest-first. Titles stay in Korean — use /api/news/headlines/en for English. Optional ?category=top|economy|tech|politics and ?limit=30 (max 100). Costs $0.01 in USDC per call, settled via x402.
news_headlines_enLatest Korean headlines with English translations attached (title_en), from Yonhap, Maeil Business and Hankyung — deduplicated, newest first. Use this instead of the Korean-only route when the consuming agent does not read Korean. Optional ?category=top|economy|tech|politics and ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.
preview_kimchi_premiumFree live BTC-only sample of the dual-basis kimchi premium. Use the paid endpoint for up to 10 symbols.
preview_premium_coverageFree archive coverage and freshness for each recorded coin. Check sample count, first and latest timestamps, and stale flag before buying premium statistics or history.
preview_researchFree, date-stamped archive-depth check for one 6-digit KRX ticker. Shows report and brokerage counts, not report content or consensus.
preview_research_coverageFree, date-stamped KRX research coverage. Lists the most-covered tickers with report count, brokerage count, and archive date range; it does not reveal report content.
research_company_tickerEvery archived Korean brokerage report for one KRX ticker, newest first: target price, rating, brokerage, analyst, the Korean title with its English translation, and a one-line English summary. Params: ?limit=20 (max 50). Costs $0.05 in USDC per call, settled via x402.
research_consensus_tickerAnalyst consensus for one KRX ticker, built from the archived research history: mean/median/min/max target price across brokerages, the spread between them, the rating distribution, and a revision log of every target-price and rating change each house has made. Consensus uses each house's latest view, so a weekly publisher does not outvote a quarterly one. Params: ?window=30d|90d|180d|365d (default 90d). Costs $0.12 in USDC per call, settled via x402.
research_latestLatest Korean brokerage equity research across all covered companies, newest first — company and KRX ticker, target price, rating, brokerage, analyst, and a one-line English summary of each report. Facts and summaries only; the report PDF stays with its publisher and source_url links back to it. Optional ?limit=20 (max 50). Costs $0.02 in USDC per call, settled via x402.

Schemas: list_tools.

Also listed as

1 other active names share this repository: io.github.juh5ng/k-data-mcp

Similar MCP servers

More from io.github.juh5ng

Official server.json
{
  "name": "io.github.juh5ng/korea-stock-research-mcp",
  "title": "K-Data — Korean Sell-Side Research & Market Data",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "0.3.0",
  "packages": [
    {
      "version": "0.3.0",
      "transport": {
        "type": "stdio"
      },
      "identifier": "k-data-mcp",
      "registryType": "npm",
      "environmentVariables": [
        {
          "name": "K_DATA_PRIVATE_KEY",
          "isSecret": true,
          "description": "Private key of a dedicated wallet holding USDC on Base. Each tool call spends from it. No ETH needed - x402 settles off-chain and the facilitator pays gas."
        },
        {
          "name": "K_DATA_MAX_SPEND_USD",
          "default": "1",
          "description": "Hard cap on cumulative spend for the session. The server refuses any call that would exceed it."
        },
        {
          "name": "K_DATA_BASE_URL",
          "description": "Point at a different K-Data deployment."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/juh5ng/k-data-mcp",
    "source": "github"
  },
  "websiteUrl": "https://k-data-x402-production.theblack1022.workers.dev",
  "description": "Korean equity research, analyst revisions, kimchi premium and news via x402."
}