Documentation

Everything you need to wire Korean Data MCP Hub into your agent stack.

What is MCP?

MCP (Model Context Protocol) is an open standard by Anthropic that lets AI agents (Claude, Cursor, ChatGPT) connect to external data sources and tools. Instead of fine-tuning models with your data, you expose your data as MCP tools that any compatible agent can call.

Learn more at modelcontextprotocol.io.

1. Quick Start

Claude Desktop integration in 3 minutes.

  1. Step 1
    Get your API key

    Subscribe to any plan and copy your key from the dashboard.

  2. Step 2
    Edit Claude Desktop config

    Open ~/Library/Application Support/Claude/claude_desktop_config.json and add:

    claude_desktop_config.json
    {
      "mcpServers": {
        "korean-data": {
          "command": "npx",
          "args": ["-y", "@korean-data/mcp"],
          "env": { "KOREAN_DATA_API_KEY": "kd_live_..." }
        }
      }
    }
  3. Step 3
    Restart Claude and ask

    "Show me the latest K-Pop comebacks this week." That's it.

2. API Reference

25 MCP tools across 11 categories.

ToolParameters
kpop.latestlimit?, lang?
kpop.comebackswindow?, lang?
kpop.chartschart?, date?
kdrama.latestlimit?, lang?
kdrama.castingshow?, lang?
kdrama.ratingsshow, range?
kmovie.trendswindow?, lang?
kmovie.festivalsyear?, lang?
kbeauty.brandsbrand?, lang?
kbeauty.productscategory?, lang?
kfood.trendsregion?, lang?
kgame.industrypublisher?, lang?
kgame.esportstitle?, lang?
ktech.startupsstage?, lang?
ktech.companiesticker?, lang?
kstock.kospirange?
kstock.entertainmentticker, range?
ktravel.destinationsregion?, lang?
ktravel.advisoriescountry?, lang?
kwebtoon.naverlimit?, lang?
kwebtoon.kakaolimit?, lang?
kwebtoon.adaptationslang?
ktrends.culturaltopic?, lang?
ktrends.searchq, lang?
ktrends.summarywindow?, lang?

3. Error Codes

UNAUTHORIZED

Missing or invalid API key. Check the Authorization header.

QUOTA_EXCEEDED

Monthly call quota reached. Upgrade plan or wait for reset.

COOLDOWN_ACTIVE

Too many requests in a short window. Back off and retry.

REALTIME_UNAVAILABLE

Realtime source temporarily degraded. Retry shortly.

4. Examples

cURL
curl https://api.korean-data.com/v1/kpop/latest \
  -H "Authorization: Bearer kd_live_..." \
  -G --data-urlencode "lang=en" --data-urlencode "limit=10"
Python
import requests

r = requests.get(
    "https://api.korean-data.com/v1/kpop/latest",
    headers={"Authorization": "Bearer kd_live_..."},
    params={"lang": "en", "limit": 10},
)
for cluster in r.json()["clusters"]:
    print(cluster["title"], cluster["score"])
JavaScript
const res = await fetch(
  "https://api.korean-data.com/v1/kpop/latest?lang=en&limit=10",
  { headers: { Authorization: "Bearer kd_live_..." } },
);
const { clusters } = await res.json();
console.log(clusters);