{
  "markdown": "# k-data-mcp\n\nMCP server for **Korean equity research and market data**, metered per call in USDC over [x402](https://x402.org). 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.\n\n## Try before funding a wallet\n\nRun `npx k-data-mcp` with no environment variables to use these free tools:\n\n- `list_endpoints` — paid catalog and prices.\n- `preview_research_coverage` — real per-ticker report/brokerage counts and archive date ranges.\n- `preview_research` — a single ticker's actual archive depth; this does not disclose report content.\n- `preview_kimchi_premium` — live BTC-only dual-basis sample.\n\nSet `K_DATA_PRIVATE_KEY` and `K_DATA_MAX_SPEND_USD` only when you are ready to enable paid tools.\n\n## What you get\n\n- **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%.\n- **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.\n- **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.\n- **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.\n- Upbit KRW quotes and market summaries, USD/KRW.\n\n## Install\n\n```bash\nnpx k-data-mcp\n```\n\n### Claude Desktop / Claude Code\n\n```json\n{\n  \"mcpServers\": {\n    \"k-data\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"k-data-mcp\"],\n      \"env\": {\n        \"K_DATA_PRIVATE_KEY\": \"0xYOUR_DEDICATED_WALLET_KEY\",\n        \"K_DATA_MAX_SPEND_USD\": \"1\"\n      }\n    }\n  }\n}\n```\n\n## Wallet setup\n\nEach tool call spends real USDC, so the server will not start without a key and a budget.\n\n1. Create a **dedicated** wallet — not your main one. The key sits in a config file and every call spends from it.\n2. 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.\n3. Set `K_DATA_MAX_SPEND_USD`. The server refuses any call that would push cumulative spend past it.\n\n| Variable | Required | Default | Meaning |\n|---|---|---|---|\n| `K_DATA_PRIVATE_KEY` | yes | — | Private key of the paying wallet (USDC on Base) |\n| `K_DATA_MAX_SPEND_USD` | no | `1` | Hard cap on cumulative spend for the session |\n| `K_DATA_BASE_URL` | no | hosted service | Point at a different K-Data deployment |\n\n## Tools\n\n`list_endpoints` is **free** — call it first to see current prices and decide what's worth buying.\n\n| Tool | Price | Returns |\n|---|---|---|\n| `list_endpoints` | free | Catalog, current prices, wallet address, remaining budget |\n| `kimchi_premium` | $0.03 | Dual-basis premium (official + USDT) for up to 10 coins |\n| `kimchi_premium_stats` | $0.12 | Percentile, mean, stdev, z-score of the premium over 1h–90d |\n| `kimchi_premium_history` | $0.08 | Premium time series, both bases |\n| `korea_market_snapshot` | $0.08 | One-call briefing: premium + markets + FX + translated headlines |\n| `research_consensus_ticker` | $0.12 | Analyst consensus for one KRX ticker — target price mean/median/range and spread, rating mix, and every house's revision history |\n| `research_company_ticker` | $0.05 | Archived Korean brokerage reports for one ticker, summarised in English |\n| `research_latest` | $0.02 | Latest Korean equity research across all covered companies |\n| `news_headlines_en` | $0.05 | Korean headlines with English translations |\n| `crypto_krw_markets` | $0.01 | All Upbit KRW markets — volume leaders, gainers, losers |\n| `news_headlines` | $0.01 | Korean headlines, untranslated |\n| `crypto_krw_ticker` | $0.005 | One Upbit KRW quote |\n| `fx_usdkrw` | $0.005 | USD/KRW rate |\n\nPrices are read from the provider's catalog at startup, so this table reflects whatever the service currently charges.\n\n## How payment works\n\nEvery 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.\n\n## License\n\nMIT\n",
  "bytes": 5176,
  "sha": "1e5ff34d7e019a247b6e6e4e0cc422a52906de6466ee527d96e098e201df0882",
  "repo_slug": "juh5ng/k-data-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_juh5ng_k_data_mcp_813a30fd/readme"
}