io.github.LJaysk/kr-dart-events

Registre officiel Autres

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 »).

OCI package ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4
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
Configuration JSON (Claude Desktop, Cursor, VS Code)
{
    "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_KEY obligatoire 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
  1. KR-DART Events — Korean corporate disclosures for AI agents
  2. Endpoints
  3. Quickstart (see the 402)
  4. Python client (pay + fetch in ~60 lines)
  5. MCP server (use from Claude / any MCP client)
  6. Typical agent loop
  7. Notes
  8. License

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

EndpointPriceWhat you get
GET /v1/events$0.002Full filing stream, cursor-based delta
GET /v1/events/material$0.005Material filings only (supply contracts, capital raises, CB/BW, control changes, delisting risk, M&A…)
GET /v1/events/{rcept_no}$0.01Single filing detail
GET /v1/events/{rcept_no}/document$0.02Full original text, parsed to clean plain text (not charged on retrieval failure)
GET /v1/company/{code}/events$0.005Per-company timeline (6-digit ticker)
GET /v1/bids$0.005KONEPS government procurement bid notices (goods/service/construction/foreign), cursor delta
GET /v1/bids/search$0.005Bid search by keyword, type, minimum budget (KRW)
GET /v1/bids/{bid_ntce_no}$0.01Bid notice full detail (all raw KONEPS fields)
GET /v1/awards$0.005Award results — winner and amount
GET /v1/prespecs$0.01Early signal: pre-spec notices, before bid notices
GET /v1/orderplans$0.01Earliest signal: agency order plans for the fiscal year
GET /v1/match/{bizno}$0.05Personalized matching — company profile + biddable notices, scored
GET /v1/company-awards/{bizno}$0.02Company 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.