dart-mcp

# DART MCP Server [](https://smithery.ai/server/@2geonhyup/dart-mcp) ## Introduction The DART MCP Server is a tool that utilizes the Financial Supervisory Service's electronic disclosure system (DART) API to search and analyze financial and business information of Korean companies. This project is designed to allow users to easily query corporate disclosure information and extract necessary financial data. ## Installation Instructions ### Prerequisites - Python 3.10 or higher - DART API key (can be obtained from the Financial Supervisory Service's OPEN DART) ### Installation Steps 1. Clone the repository ```bash git clone [repository URL] cd dart-mcp ``` 2. Create and activate a virtual environment ```bash python -m venv .venv source .venv/bin/activate # Linux/Mac # or .venv\Scripts\activate # Windows ``` 3. Install dependencies ```bash pip install -e . ``` ## Environment Variable Configuration Create a `.env` file in the project root and set the API key as follows: ``` DART_API_KEY=your_api_key_here ``` ## Available Tools ### 1. Search Company Financial Information Search for key financial information of a company (revenue, operating profit, net income, etc.). ### 2. Search Detailed Financial Information Analyze detailed financial information such as the balance sheet, income statement, and cash flow statement of a company. ### 3. Search Business Information Search for business-related information such as company overview, main products and services, and sales status. ### 4. Get Current Date Returns the current date in YYYYMMDD format. ## Detailed Description of Tools ### Financial Information Search ```python # Search for key financial information of a company search_disclosure( company_name="Samsung Electronics", # Company name start_date="20230101", # Start date (YYYYMMDD) end_date="20231231", # End date (YYYYMMDD) requested_items=["Revenue", "Operating Profit"] # Items to query (optional) ) ``` ### Detailed Financial Information Search ```python # Search for detailed financial information of a company search_detailed_financial_data( company_name="Samsung Electronics", # Company name start_date="20230101", # Start date (YYYYMMDD) end_date="20231231", # End date (YYYYMMDD) statement_type="Income Statement" # Type of financial statement (choose from balance sheet, income statement, cash flow statement, optional) ) ``` ### Business Information Search ```python # Search for business-related information of a company search_business_information( company_name="Samsung Electronics", # Company name start_date="20230101", # Start date (YYYYMMDD) end_date="20231231", # End date (YYYYMMDD) information_type="Business Overview" # Type of information ) ``` ### Get Current Date ```python # Returns the current date in YYYYMMDD format get_current_date() ``` ## Notes - Data is provided based on the latest 5 disclosure information. - The search end date may be automatically adjusted considering the disclosure submission period. - Some data extraction may fail during the XBRL parsing process. ## License This project is licensed under the [license information].