Back to Browse

K Data MCP Server

by Juh5ng
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

Korean market data for agents: tradeable-basis kimchi premium, history/percentiles, translated news.

About

Korean market data for agents: tradeable-basis kimchi premium, history/percentiles, translated news.

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 4 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

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

Environment variable: K_DATA_PRIVATE_KEY

Hard cap on cumulative spend for the session. The server refuses any call that would exceed it.Optional

Environment variable: K_DATA_MAX_SPEND_USD

Point at a different K-Data deployment.Optional

Environment variable: K_DATA_BASE_URL

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-juh5ng-k-data-mcp": {
      "env": {
        "K_DATA_BASE_URL": "your-k-data-base-url-here",
        "K_DATA_PRIVATE_KEY": "your-k-data-private-key-here",
        "K_DATA_MAX_SPEND_USD": "your-k-data-max-spend-usd-here"
      },
      "args": [
        "-y",
        "k-data-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

k-data-mcp

MCP server for Korean market data, metered per call in USDC over x402. No account, no API key, no signup — the server pays each request from a wallet you supply.

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.
  • 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 K_DATA_MAX_SPEND_USD. The server refuses any call that would push cumulative spend past it.
VariableRequiredDefaultMeaning
K_DATA_PRIVATE_KEYyesPrivate key of the paying wallet (USDC on Base)
K_DATA_MAX_SPEND_USDno1Hard cap on cumulative spend for the session
K_DATA_BASE_URLnohosted servicePoint at a different K-Data deployment

Tools

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

ToolPriceReturns
list_endpointsfreeCatalog, current prices, wallet address, remaining budget
kimchi_premium$0.03Dual-basis premium (official + USDT) for up to 10 coins
kimchi_premium_stats$0.12Percentile, mean, stdev, z-score of the premium over 1h–90d
kimchi_premium_history$0.08Premium time series, both bases
korea_market_snapshot$0.08One-call briefing: premium + markets + FX + translated headlines
news_headlines_en$0.05Korean headlines with English translations
crypto_krw_markets$0.01All Upbit KRW markets — volume leaders, gainers, losers
news_headlines$0.01Korean headlines, untranslated
crypto_krw_ticker$0.005One Upbit KRW quote
fx_usdkrw$0.005USD/KRW rate

Prices are read from the provider's catalog at startup, so this table reflects whatever the service currently charges.

How payment works

Every paid endpoint answers an unpaid request with HTTP 402 and a PAYMENT-REQUIRED header describing the price, asset and recipient. This server signs an EIP-3009 authorization for that exact amount and retries; the facilitator settles it on Base. Nothing is held on account — you pay per call, and stop paying when you stop calling.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

K Data MCP Server - Korean market data for agents: tradeable-basis kimchi | MCP Marketplace