Skip to main content
Glama
enciyo

KAP MCP Tools

by enciyo
README.md
# KAP MCP Tools

This project contains MCP (Model Control Protocol) tools for accessing Public Disclosure Platform (KAP) data.

## Features

- Company list and details
- Company financial reports
- KAP announcements
- Stock market indices
- Sector information

## Installation

1. Install Python 3.11 or higher
2. Create a virtual environment:
```bash
python -m venv .venv
source .venv/bin/activate  # Unix/macOS
# or
.venv\Scripts\activate  # Windows
```
3. Install dependencies:
```bash
pip install -r requirements.txt
```

## Usage

To start the application:

```bash
python main.py
```

## API Functions

- `get_companies()`: Returns a list of all companies
- `get_company(company_code)`: Returns details of a specific company
- `get_company_info(company_code)`: Returns detailed information about a company
- `get_financial_report(company_code, year)`: Returns the financial report of a company
- `get_indices()`: Returns a list of all indices
- `get_announcements_by_company(company_code)`: Returns announcements of a specific company
- `get_announcements()`: Returns a list of all announcements
- `get_sectors()`: Returns a list of all sectors

## Error Handling

All API calls are protected with try-catch blocks and return meaningful error messages.

## License

This project is licensed under the MIT License.