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

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "K-Data — Korean Sell-Side Research & Market Data": {
      "url": "https://k-data-x402-production.theblack1022.workers.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (16)

• preview_premium_coverage

  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.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• preview_research_coverage

  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.

  Parameters:

  • limit — integer — How many tickers to show (default 25, max 50)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• preview_research

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

  Parameters:

  • ticker (required) — string — 6-digit KRX code, e.g. 005930

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• preview_kimchi_premium

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

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kimchi_premium

  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.

  Parameters:

  • symbols — string — Comma-separated coin tickers, e.g. BTC,ETH,XRP. Default: BTC,ETH,XRP,SOL,DOGE

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kimchi_premium_stats

  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.

  Parameters:

  • basis — string — Which premium basis to analyse (default usdt)
  • symbol — string — Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT
  • window — string — Lookback window (default 24h)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• kimchi_premium_history

  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.

  Parameters:

  • before — integer — Unix-second cursor from next_before; returns older rows strictly before it
  • points — integer — Max points returned (default 500, max 2000)
  • symbol — string — Archived tickers: BTC, ETH, XRP, SOL, DOGE, USDT
  • window — string — Lookback window (default 24h)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• research_consensus_ticker

  Analyst 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.

  Parameters:

  • ticker (required) — string — 6-digit KRX code, e.g. 005930
  • window — string — Lookback window (default 90d)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• research_company_ticker

  Every 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.

  Parameters:

  • ticker (required) — string — 6-digit KRX code, e.g. 005930
  • limit — integer — Max reports (default 20, max 50)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• research_latest

  Latest 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.

  Parameters:

  • limit — integer — Max reports (default 20, max 50)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• news_headlines_en

  Latest 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.

  Parameters:

  • limit — integer — Max items (default 20, max 50)
  • category — string — Filter by category

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• korea_market_snapshot

  One-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.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• crypto_krw_markets

  Snapshot 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.

  Parameters:

  • limit — integer — How many top-volume markets to return (default 30, max 100)

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• news_headlines

  Latest 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.

  Parameters:

  • limit — integer — Max items (default 30, max 100)
  • category — string — Filter by category

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• crypto_krw_ticker

  Live 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.

  Parameters:

  • ticker (required) — string — Coin ticker symbol, e.g. BTC

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• fx_usdkrw

  Current USD/KRW exchange rate (ECB reference via Frankfurter, fallback open.er-api.com). Costs $0.005 in USDC per call, settled via x402.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.