io.github.LJaysk/kr-dart-events
Real-time Korean corporate disclosure (DART) events. Pay per call in USDC via x402. No API key.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4claude mcp add kr-dart-events -e 'X402_PRIVATE_KEY=<your x402_private_key>' -- docker run -i --rm ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4
{
"mcpServers": {
"kr-dart-events": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4"
],
"env": {
"X402_PRIVATE_KEY": "<your x402_private_key>"
}
}
}
}
Variables d'environnement
X402_PRIVATE_KEYobligatoire secret EVM private key (0x...) of a wallet holding a few cents of USDC on Base. Used to sign x402 micro-payments. Gas is not needed.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
KR-DART Events — Korean corporate disclosures for AI agents
Real-time DART (Korea's SEC EDGAR equivalent) filing events, structured for machines. Pay per call with USDC via x402 — no account, no API key, no subscription.
Base URL: https://dartapi.ljaysk.com (machine docs: /llms.txt, /openapi.json)
Korea's exchanges publish ~2,500 corporate filings every trading day, in Korean. This service polls DART every 15 seconds, classifies each filing into 31 machine-readable categories, scores importance 0–1, and serves structured JSON with English labels and English company names.
Endpoints
| Endpoint | Price | What you get |
|---|---|---|
GET /v1/events | $0.002 | Full filing stream, cursor-based delta |
GET /v1/events/material | $0.005 | Material filings only (supply contracts, capital raises, CB/BW, control changes, delisting risk, M&A…) |
GET /v1/events/{rcept_no} | $0.01 | Single filing detail |
GET /v1/events/{rcept_no}/document | $0.02 | Full original text, parsed to clean plain text (not charged on retrieval failure) |
GET /v1/company/{code}/events | $0.005 | Per-company timeline (6-digit ticker) |
GET /v1/bids | $0.005 | KONEPS government procurement bid notices (goods/service/construction/foreign), cursor delta |
GET /v1/bids/search | $0.005 | Bid search by keyword, type, minimum budget (KRW) |
GET /v1/bids/{bid_ntce_no} | $0.01 | Bid notice full detail (all raw KONEPS fields) |
GET /v1/awards | $0.005 | Award results — winner and amount |
GET /v1/prespecs | $0.01 | Early signal: pre-spec notices, before bid notices |
GET /v1/orderplans | $0.01 | Earliest signal: agency order plans for the fiscal year |
GET /v1/match/{bizno} | $0.05 | Personalized matching — company profile + biddable notices, scored |
GET /v1/company-awards/{bizno} | $0.02 | Company award history — competitor intel |
Free: /v1/health, /, /llms.txt, /openapi.json.
Payment: x402 exact scheme, USDC on Base or Solana (Solana fees sponsored by
the facilitator — buyer wallets need zero SOL).
Quickstart (see the 402)
curl https://dartapi.ljaysk.com/v1/events/material
# -> HTTP 402 with payment requirements (accepts: base / solana)
Python client (pay + fetch in ~60 lines)
See client_example.py. Fund any EVM wallet with a few cents
of USDC on Base, then:
X402_PRIVATE_KEY=0x... python client_example.py /v1/events/material
Standard x402 SDKs (x402-fetch, x402-axios, x402 python) work as-is.
MCP server (use from Claude / any MCP client)
mcp_server.py wraps the API as MCP tools
(kr_dart_material_events, kr_dart_all_events, kr_dart_company_timeline,
kr_dart_filing_detail).
{
"mcpServers": {
"kr-dart-events": {
"command": "uv",
"args": ["run", "--with", "mcp,eth-account", "python", "/path/to/mcp_server.py"],
"env": { "X402_PRIVATE_KEY": "0x..." }
}
}
}
Typical agent loop
Poll /v1/events/material?since_cursor=<last> every 60s during KST market hours.
New filings appear within ~15s of DART publication. Cost ≈ $2/day.
Notes
- Source: DART open data (attributed). Data only — not investment advice.
- Event index starts 2026-07-20; earlier filings are not indexed.
server/contains the full seller implementation (FastAPI + hand-rolled x402 middleware, CDP facilitator with JWT auth) — reference for building your own x402 seller.
License
MIT — see LICENSE. Operated by LJay AI Media Group · contact@ljaysk.com
Questions fréquentes
Qu'est-ce que io.github.LJaysk/kr-dart-events ?
Real-time Korean corporate disclosure (DART) events. Pay per call in USDC via x402. No API key.
Comment installer io.github.LJaysk/kr-dart-events ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add kr-dart-events -e 'X402_PRIVATE_KEY=<your x402_private_key>' -- docker run -i --rm ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.LJaysk/kr-dart-events ?
Oui. Il attend X402_PRIVATE_KEY, à renseigner dans sa configuration.
io.github.LJaysk/kr-dart-events est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.LJaysk/kr-dart-events ?
Il est publié par LJaysk. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.