Skip to main content
Glama
ChainPulse Korea

ChainPulse Korea

by TROYESIVAN

ChainPulse Korea — MCP server

Korea market microstructure data for AI agents, exposed as MCP tools. No API key, no account, read-only.

Four tools, all free:

Tool

What it returns

korea_premium

Per asset on Upbit and Bithumb: KRW price, OKX USDT reference price, trade staleness, and three premiums — prem_usdt, prem_vs_btc, prem_fx (ECB reference rate)

usdt_krw_premium

USDT-KRW price on both Korean venues vs the ECB reference rate

upbit_caution_watchlist

Every KRW market currently carrying an Upbit investment caution / warning flag, with when the flag was first observed

krw_listing_changes

New listings and delistings across the full KRW market list of Upbit and Bithumb over the last N days

Install

uvx --from git+https://github.com/TROYESIVAN/mcp-korea-premium chainpulse-korea

or with pip:

pip install "git+https://github.com/TROYESIVAN/mcp-korea-premium"
chainpulse-korea

Related MCP server: krx-cli

Configure an MCP client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "chainpulse-korea": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/TROYESIVAN/mcp-korea-premium", "chainpulse-korea"]
    }
  }
}

Cursor / Cline / any stdio MCP client: same command and args.

Data sources

  • Upbit public API (market/all, ticker) — KRW markets, caution/warning flags

  • Bithumb public API (ALL_KRW, v1/ticker) — KRW markets

  • OKX public API (market/ticker) — USDT reference price

  • frankfurter.app — ECB reference rates (business days only; returned with fx_timestamp)

The upstream snapshot refreshes every 5 minutes. Responses carry snapshot_ts, snapshot_age_s and observed_since so a caller can judge freshness.

Notes on accuracy

  • mapping_status marks assets whose symbol mapping between venues has been verified (verified) versus still under observation (candidate). Candidate assets do not get a premium figure.

  • A token that trades in Korea but has no OKX reference price returns flags only.

  • A token that is not listed in Korea returns not_listed_in_korea.

  • stale_ticker / stale_ticker_inferred mark venues whose last trade is old.

Listing-change detection polls the open market list every 5 minutes. It is designed for data completeness, not for announcement-speed alerting — a dedicated news bot will usually be faster. Use it to check what changed, not to front-run an announcement.

Disclaimer

Measurements only. No investment advice, no price predictions, no trade execution. Trading decisions are yours.

License

MIT

Available Tools

4 tools
korea_premiumA

Korea premium snapshot: per asset on Upbit and Bithumb, the KRW price, the OKX USDT reference price, trade staleness and three premiums (prem_usdt, prem_vs_btc, prem_fx).

Args: venue: upbit | bithumb | both (default both) asset: single symbol such as BTC (optional) limit: max rows, default 20

Inputs: asset, limit, venue. Returns: result

krw_listing_changesA

KRW listing and delisting changes: new listings and removals across the full KRW market list of Upbit and Bithumb over the last N days.

Note: detection runs every 5 minutes on the open market list, so a change is reported within minutes of the pair becoming tradable — this is NOT the announcement-level latency of a dedicated news bot.

Args: days: lookback window in days, default 7, max 30 venue: upbit | bithumb | both (default both)

Inputs: days, venue. Returns: result

upbit_caution_watchlistA

Upbit caution and warning watchlist: every KRW market currently carrying an Upbit investment caution or warning flag (global price difference, deposit surge, volume surge, trading volume) and when the flag was first observed.

Args: flag: caution | warning | all (default all) asset: single symbol (optional) limit: max rows, default 50

Inputs: flag, asset, limit. Returns: result

usdt_krw_premiumB

USDT-KRW premium: the KRW price of USDT on Upbit and Bithumb against the ECB reference rate — how far Korean dollar demand deviates from the official rate.

Args: venue: upbit | bithumb | both (default both)

Inputs: venue. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 4 tools

    Disambiguation4/5

    Each tool targets a distinct data need: asset-level premiums, USDT-KRW premium, Upbit caution flags, and listing changes. The two premium tools both mention Upbit/Bithumb and KRW premiums, so an agent could momentarily confuse them, but their descriptions clearly separate asset-level premiums from the USDT-specific ECB comparison.

    Naming Consistency4/5

    All names are lowercase snake_case descriptive noun phrases with a consistent style. Prefixes vary slightly (korea_, usdt_krw_, upbit_, krw_), but the convention remains predictable and readable.

    Tool Count5/5

    Four tools is well-scoped for a focused Korea crypto premium analytics server. Each tool corresponds to a clear analytical question, with no redundant or filler tools.

    Completeness4/5

    The surface covers the main workflows: asset premiums, USDT-KRW premium, caution monitoring, and listing/delisting changes. Minor gaps exist—caution flags are only available for Upbit, and there is no historical premium time-series tool—but agents can work around these for snapshot-oriented analysis.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Korean crypto market data API for AI agents. Real-time Kimchi Premium (Upbit vs Binance), Korean exchange prices, USD/KRW FX rate. First verified Korean market data MCP server. Pay-per-use via x402 on Base.
      17
      2
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to query real-time and historical Korean stock market data from KRX (Korea Exchange) including indices, stocks, ETFs, bonds, derivatives, and commodities via MCP tools and resources.
      12 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides Korean stock market data (KOSPI, KOSDAQ, KONEX) including prices, fundamentals, investor trading, short selling, and indices via MCP protocol, enabling natural language queries from AI agents like ChatGPT and Claude.
      62 PyPI
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      MCP server for Korean market data with metered USDC payments, providing kimchi premium, translated headlines, Upbit KRW markets, and USD/KRW rates.
      85 npm
      MIT