← Back to directory
D

DartLab

Community
Korean DART + US SEC EDGAR filings as structured Python data for company analysis.
Category
Dev Tools #147 of 438
Stars
★ 223 Popular
Transport
stdio (local process) · SSE
Runtime
Python
Credentials
Optional API key
License
Apache-2.0
Last commit
Tools
22
58FMRS · C

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.

Strongest · Maintenance 14/20 Weakest · Reliability 8/20

Reliability
8/20
Security and permissions
12/20
Maintenance
14/20
Documentation
12/20
Setup experience
12/20
Why each score
Reliability 8/20
The README describes a feature-rich MCP server with a `dartlab mcp` entry point and multiple tools (EngineCall, RunPython, etc.). It claims tools are advertised via `tools/list` and that legacy tools are deprecated. However, since actual source code or tests were not inspected, we cannot verify that tools truly match implementation, and error handling was not reviewed. There are signs of CI workflows and tests, but no execution evidence was provided. Therefore, reliability is limited to 8 (below the static review cap of 12) due to lack of evidence.
Security and permissions 12/20
No obvious red flags in terms of security. API key handling seems minimal (prebuilt data download, DART API only needed for re-collection). README describes wrapping external content in [EXTERNAL CONTENT START - untrusted ...] markers to prevent prompt injection, which is a good practice. The tool RunPython that executes arbitrary Python is a risk, but it's clearly scoped to DartLab and Polars code with execution limits. No malware, credential theft, or unconfirmed dangerous operations were found. Security score is 12 rather than higher because permission and confirmation mechanisms are not fully documented.
Maintenance 14/20
The project is active with 206 stars and only 4 open issues, and is not archived. There are CI workflows (ci-fast.yml) and a detailed changelog. License is Apache-2.0, which is permissive. There are release indications on GitHub. Maintenance score of 14 reflects active maintenance, but not higher because we didn't directly inspect commits and issue responses, and release cadence couldn't be verified.
Documentation 12/20
Documentation is extensive, including installation instructions, CLI/MCP configuration examples, tool surface description, stability tiers, and limitations. README provides numerous examples. However, documentation is largely in Korean, which may limit audience. Also, there are some contradictions, such as the north star scoring table showing MCP server score 7.0, but detailed sub-scores indicate some weaknesses. Overall, documentation is good, but deductions for language barrier and some operational details (like troubleshooting) not being detailed. Hence 12.
Setup experience 12/20
Installation steps are clearly described: via `uvx dartlab mcp` or installing entry point `dartlab mcp`, with config file examples for Claude Desktop, Claude Code, and Codex. Remote SSE option is also provided. Instructions mention cold start issues and recommend pre-installation to avoid timeouts. Platform compatibility is addressed with absolute paths for Windows and Unix. Overall, install path is clear but requires pre-installation step and has dependency on Python environment, so score is 12.

Static review · not runListed 2026-08-07

Read the FMRS scoring method →

Fit and risk

What it can accessRuns commands or codeUses the network

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.

Setup

Before you start

Runtime:Python

Other optional settings (2)
PYTHONUNBUFFERED optional Keeps Python output unbuffered so MCP stdio messages arrive in real time; set in the client config, nothing to obtain.
PYTHONUTF8 optional Enables Python UTF-8 mode for correct handling of Korean filing text; set in the client config, nothing to obtain.

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" }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "dartlab": {
      "command": "dartlab",
      "args": [
        "mcp"
      ],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONUTF8": "1"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add dartlab -e PYTHONUNBUFFERED=1 -e PYTHONUTF8=1 -- dartlab mcp

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

After installing (`uv tool install dartlab` or `pipx install dartlab`), add the MCP config (`dartlab mcp` entry point). Once connected, tools like ask, EngineCall, and RunPython should appear in the client's tool list; asking about Samsung Electronics' income statement with ref-backed numbers confirms it works.

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.

Things to try

Once connected, you can ask your AI assistant things like:

  • Analyze Samsung Electronics (005930) financial health with supporting evidence.
  • Compare Samsung Electronics and SK Hynix income statements over recent years.
  • Run a DCF valuation on Apple (AAPL) and show the key assumptions.
  • Run the credit scorecard for this company and assess its debt capacity.

Tools 22

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

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 Desktop
Claude Code
Codex
Cursor

Listed from the project's documentation, not tested by this site.

Overview

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.

Similar servers

Context7 80 · B

Upstash's official server providing up-to-date third-party library docs for AI coding assistants

★ 62.9k · Tools 2 Compare with this →

Source revision 0a570038b13f Data synced 2026-10-12 Read the FMRS scoring method