🤖 Use KoreaAPI from your agent

Wire the verifiable Korean-culture layer into any AI agent — MCP tools or plain JSON.

Two ways to consume

1) MCP — call KoreaAPI as tools from your agent. 2) Plain HTTP/JSON — fetch the open data directly, no setup.

MCP quickstart

Install from the repo, then run the stdio server and point your MCP client at it:

pip install "git+https://github.com/kwangdol-star/koreaapi"   # or: git clone … && uv sync
python -m koreaapi.server   # stdio MCP server "koreaapi"

Tools:

get_verified — cross-verification status + Skill Score (check trust BEFORE citing)
get_resolve — resolve a fuzzy name / external ID / canonical id -> the verified entity (+ external IDs)
get_artist_status — latest verified status for a Korean artist
get_agency — who is under a 소속사 / label
get_person — verified credits for a person (director / actor / idol)
get_related — entities sharing a 소속사 / network
get_kculture_calendar — upcoming K-culture events
get_korea_rising — what is rising in Korea now (premium signal)
get_buy_options — where to buy a release / ticket / goods (logs buy-intent)
list_answer_products — list the Answer Products — named, citable decisions over the verified store
get_answer — run an Answer Product -> {signal, action, score, rationale, answer, evidence}

Answer Products — decide before you answer

Don't just fetch rows — call a decision. Each Answer Product turns the verified store into one envelope {signal, action, score, rationale, answer, evidence} your agent can branch on: confirm a Korean spelling, decide whether a claim is safe to cite, resolve a mention to a trusted ID, read the demand trend, pull a roster. One call: GET /v1/answer?product=canonical-name&q=Vincenzo — omit product to run all; catalog at GET /v1/answer (also in /agents.json).

🪪 canonical-name — Confirm the authoritative Korean ↔ English spelling of an entity before you assert it.
✅ fact-check — Decide whether a claim about an entity is safe to cite (cross-/triple-verified / certified).
🧭 identity-resolve — Map a fuzzy mention or external ID onto the canonical verified KoreaAPI entity.
📈 trend-radar — Read what is rising in Korea now from accumulated demand signal.
🏢 agency-roster — List the verified artists under a Korean agency/label (소속사).
🎬 person-credits — Aggregate a Korean-culture person's verified credits across works.
🕸️ related-network — Find entities sharing the same agency/network hub edge.
🧳 trip-plan — Verified places + festivals in a region, plus signature Korean dishes — itinerary raw material.

No setup? Use the open data

/latest.json — every verified record (provenance + Skill Score + content_hash)
/llms-full.txt — the full corpus, one citable block per entity
/feed.xml · /feed.json — recently verified
/reconcile.json — resolve a name or external ID to the canonical entity (the ID spine)
/agents.json — machine-readable manifest of all of the above

Trust it — and defend it to your users

Every record is cross-verified, Skill-scored, and carries a SHA-256 content hash; the dataset + append-only history are hash-verifiable. See /methodology + /integrity.json. Cite a row as: “Name — kind, as of date · source · Skill Score · via KoreaAPI”.

Premium (x402)

The proprietary demand signal (/v1/korea-rising) is payable per call in USDC on Base via x402 — your agent can pay autonomously. Basic verified data stays free.

Why not just scrape Wikipedia yourself?

You'd get unverified text with no provenance, no Skill Score, no tamper-evidence, and wrong Korean names (e.g. Vincenzo → 빈첸초 instead of the official 빈센조). KoreaAPI gives you cross-verified, bilingual, official-named, citable rows your users can trust — and your agent can verify.