Kr Dart Events

io.github.LJayskPublished by GitHub account LJayskv0.1.4Updated Oct 25, 2026

Real-time Korean corporate disclosure (DART) events. Pay per call in USDC via x402. No API key.

The publisher's own server: Events.Aero

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that gives an assistant real-time Korean DART corporate filing events and KONEPS procurement notices, paid per call in USDC via x402.

What you can do
Fetch the full DART filing stream or only material filings, with cursor-based deltas and importance scores in English labels and company names. Look up a single filing's detail or its full original text parsed to plain text. Retrieve a company's filing timeline by six-digit ticker. Query KONEPS government procurement bid notices, keyword or budget searches, award results, pre-spec notices and agency order plans. Match a company profile against biddable notices and pull a company's award history for competitor intelligence.
When to use it
Useful when an assistant needs timely Korean corporate disclosure or public procurement signals, such as monitoring material filings during KST market hours or tracking bid and award activity for a company. Best suited to agents that can pay small per-call USDC fees.
Requirements
Runs as a local process (stdio) via the published container image or the bundled Python script, which needs uv and Python with the mcp and eth-account packages. Requires an EVM wallet private key supplied in the X402_PRIVATE_KEY environment variable, funded with a few cents of USDC on Base (or Solana via x402). Network access to the remote API endpoint is needed.
Before you install
The server requires a wallet private key in X402_PRIVATE_KEY, which signs payments; use a dedicated low-balance wallet, never a main one. Every call spends real USDC, roughly $2 per day for a 60-second polling loop, so costs accumulate. Data comes from DART and KONEPS and is not investment advice; the event index only starts from 2026-07-20.

Installation

In SourceWeft

  1. Open Kr Dart Events in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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)

bash
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:

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

json
{  "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 · [email protected]

Source: README.md at commit c13eba8

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.4LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Events integrations