K Data MCP server

k-data-mcp

MCP server for Korean equity research and market data, metered per call in USDC over x402. Start it without a wallet to inspect the catalog and run free, date-stamped previews; add a dedicated wallet only when you want paid calls.

Try before funding a wallet

Run npx k-data-mcp with no environment variables to use these free tools:

• list_endpoints — paid catalog and prices.
• previewresearchcoverage — real per-ticker report/brokerage counts and archive date ranges.
• preview_research — a single ticker's actual archive depth; this does not disclose report content.
• previewkimchipremium — live BTC-only dual-basis sample.

Set KDATAPRIVATEKEY and KDATAMAXSPEND_USD only when you are ready to enable paid tools.

What you get

• Kimchi premium on a tradeable basis. Everyone quotes the premium against the official USD/KRW rate, but Korean capital controls mean the KRW exit leg actually goes through USDT — so that number is not something you can trade on. This returns both, and they routinely disagree in sign: official can read −0.27% while the realizable basis is +0.19%.
• Premium history and percentile context. A continuously recorded archive answers "is this premium unusual right now?" — percentile, mean, stdev, z-score over 1h–90d. No free source publishes this, and it cannot be reconstructed after the fact.
• Korean headlines translated to English, from Yonhap, Maeil Business and Hankyung. Korean myriad units (억 / 조) are expanded deterministically before translation, so "989억달러" comes back as $98.9 billion rather than the 10×-off answer language models produce unaided.
• Korean sell-side research as structured data. Target prices, ratings, brokerage and analyst per KRX ticker, each with an English summary, plus the consensus and revision history built from them — who raised, who cut, and how far apart the houses actually are. Only the facts of each report are sold, in our own words, with a link back to the publisher; the report PDF stays with the brokerage that wrote it. The listing source shows a rolling recent window only, so this series cannot be reconstructed after the fact either.
• Upbit KRW quotes and market summaries, USD/KRW.

Install

npx k-data-mcp

Claude Desktop / Claude Code

{
  "mcpServers": {
    "k-data": {
      "command": "npx",
      "args": ["-y", "k-data-mcp"],
      "env": {
        "K_DATA_PRIVATE_KEY": "0xYOUR_DEDICATED_WALLET_KEY",
        "K_DATA_MAX_SPEND_USD": "1"
      }
    }
  }
}

Wallet setup

Each tool call spends real USDC, so the server will not start without a key and a budget.

1. Create a dedicated wallet — not your main one. The key sits in a config file and every call spends from it.
2. Fund it with the USDC you're willing to spend on Base. No ETH needed: x402 settles with an off-chain EIP-3009 signature and the facilitator pays the gas.
3. Set KDATAMAXSPENDUSD. The server refuses any call that would push cumulative spend past it.

Tools

listendpoints is free** — call it first to see current prices and decide what's worth buying.

Shortened. The full README is on GitHub.