mcpField
K
kr-dart-events

kr-dart-events

Local
dartapi.ljaysk.comFinance0Updated 14w ago
RepositoryVisit website

About kr-dart-events

kr-dart-events serves structured Korean corporate disclosure events and government procurement data for AI agents and financial-data users. It classifies filings and provides English labels, with per-call USDC payments through x402 and no API key.

Key features

  1. 01DART filing event stream with cursor deltas
  2. 0231 filing categories and importance scores
  3. 03Company timelines and filing documents
  4. 04KONEPS bids, awards, and order signals
  5. 05Keyword and company-profile matching
  6. 06Per-call USDC payments via x402

Use cases

  1. 01Monitor material Korean corporate filings
  2. 02Track disclosures for a specific company
  3. 03Search procurement bids and award results
  4. 04Match bid notices to a company profile

MCP support

The included MCP server wraps the API with tools for material events, all events, company timelines, and filing details. Access requires an x402 payment setup using the configured wallet.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "ljaysk-kr-dart-events": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "X402_PRIVATE_KEY",
        "ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4"
      ],
      "env": {
        "X402_PRIVATE_KEY": "<X402_PRIVATE_KEY>"
      }
    }
  }
}
Run commanddocker run -i --rm -e X402_PRIVATE_KEY ghcr.io/ljaysk/kr-dart-events-mcp:0.1.4
Environment variables to set
X402_PRIVATE_KEYSecretEVM private key (0x...) of a wallet holding a few cents of USDC on Base. Used to sign x402 micro-payments. Gas is not needed.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/ljaysk/kr-dart-events-mcp:0.1.4

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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)

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.