← Back to directory
D

DartLab

Community
Korean DART + US SEC EDGAR filings as structured Python data for company analysis.
GitHub source repository ↗
★ 209 Stars Category · Dev Tools Popular Source revision 9e3f276f03de
58FMRS · C
Reliability
8/20
Security and permissions
12/20
Maintenance
14/20
Documentation
12/20
Setup experience
12/20

DartLab is a powerful financial data MCP server designed for Korean DART and US EDGAR disclosure data. It offers rich data interfaces and AI analysis capabilities, suitable for deep financial research. Installation requires pre-installing the Python package and configuring MCP clients. It currently supports Claude Desktop, Claude Code, Codex, and Cursor. Note that it requires significant local disk space and network resources, and provides limited depth for US stocks. Overall, it is an extremely valuable tool for researchers focused on the Korean market.

Read the FMRS scoring method →

DartLab is an open-source research system that turns Korean DART and US SEC EDGAR disclosures into comparable corporate data. It provides financial statements, business report full text, filing lists, ratios, credit risk, industry maps, and macro context through a unified Company interface. The core is horizontalizing each company's differing account names and disclosure tables into topic × period and account × period grids, enabling comparisons across years, across companies (e.g., Samsung vs Apple), and across the entire market. The system offers a Python library, CLI, and AI assistant (via MCP) with five analysis lenses (Analysis, Credit, Industry, Quant, Macro), plus scan, screener, story, and simulation features. Data is prebuilt on HuggingFace, and no API keys are required to get started.

Tools

ask
Ask a natural language analysis request, integrating autonomous AI tool calls and reference verification.
EngineCall
Call a single executable capability from DartLab's public API.
RunPython
Execute dartlab and Polars code, returning traceable reference values.
ReadSkill
Search for skill specs in the official Skill OS.
GetSkillBody
Retrieve the body content of a specific skill.
ReadSkillMarket
Query the community skill market.
ReadCapability
Look up DartLab public API or docstrings.
Read
Read local documents or files.
WebSearch
Search external up-to-date information.
ExternalReachDoctor
Check external connection status or health.
SaveArtifact
Save analysis artifacts such as files or charts.
CompileVisual
Generate visualization charts or images.
CreateUserSkill
Create user-defined skills.
PeerCompareN
Compare financial or operational metrics of multiple peer companies.
DCFValuation
Perform discounted cash flow valuation.
CompileFinancialDashboard
Generate a financial dashboard.
RegressionForecast
Perform regression analysis or forecasting.
SensitivityAnalysis
Conduct sensitivity analysis.
CreditScorecard
Generate credit scorecard or credit assessment.
ScenarioCompareN
Compare outcomes under multiple scenarios.
ScenarioOverlay
Overlay scenarios onto existing data or charts.
SearchPastSessions
Search past sessions or records.

Setup

Install the Python package: pip install dartlab or uv add dartlab. Then, for Claude Desktop, add an MCP server config in your settings file using command dartlab mcp (pre-install with uv tool install dartlab). For Claude Code, run claude mcp add dartlab -- dartlab mcp. For Codex CLI, run codex mcp add dartlab -- dartlab mcp. You can also connect via remote SSE: https://eddmpython-dartlab.hf.space/mcp/sse (note: Claude Desktop does not support remote endpoints).

claude_desktop_config.json
{
  "mcpServers": {
    "dartlab": {
      "command": "dartlab",
      "args": ["mcp"],
      "env": { "PYTHONUNBUFFERED": "1", "PYTHONUTF8": "1" }
    }
  }
}

Fit and risk

Best for

  • Quantitative analysts and investors with deep research needs in the Korean stock market (KOSPI/KOSDAQ).
  • Developers needing structured financial data in Python environments.
  • Those who want to integrate financial analysis capabilities into AI assistants like Claude or Codex via MCP.

Not for

  • Those needing real-time stock price or high-frequency trading data (data is prebuilt, potentially with some latency).
  • Those focused only on US small-cap companies or deep EDGAR data (EDGAR support is limited).
  • Users seeking a lightweight, single-purpose data source (it's feature-rich but heavy).

Required permissions

  • Network access to download prebuilt data from HuggingFace, and access to DART and SEC APIs (EDGAR).
  • Local file system permissions for caching data (default in user directory).
  • For MCP configuration, need to modify config files for Claude Desktop or CLI.
  • Optional: DART API key (for raw data re-collection, not needed for regular use).

Risks and side effects

  • External disclosure content (e.g., news, filings) may be wrapped as untrusted when serialized, but AI should use it only as analysis basis, not execute any instructions within.
  • Prebuilt data may not be up-to-date; be aware of time lags.
  • When using remote MCP endpoint, ensure stable internet connection.
  • Installation issues could arise if Python path is not set properly, affecting MCP configuration.

Troubleshooting

  1. If the `dartlab` command is not found, check that the Python scripts directory is in your PATH, or use an absolute path in config.
  2. For MCP connection failures, ensure you pre-installed via `uv tool install dartlab` and set environment variables `PYTHONUNBUFFERED=1` and `PYTHONUTF8=1`.
  3. If data download is slow or fails, check network connection or view HuggingFace dataset status.
  4. For AI analysis issues, make sure you first run `dartlab agent status --refresh` and connect to a supported agent (e.g., Codex).
  5. If CLI commands don't work, try `dartlab --help` for help, or use `dartlab mcp --config claude-desktop` to generate config.

Use cases

Investors or analysts need quick access to Korean listed company financials and cross-period comparison.
Simultaneously research Korean and US company financial reports with a unified interface.
Automate bulk scanning of market-wide financial ratios or specific accounts.
Use AI assistants for natural language financial analysis and verify computation results.
Generate financial analysis reports or company stories for blogs or research.

Supported clients

Claude DesktopFull support
Claude CodeFull support
Codex CLIFull support
CursorFull support