What is Set Mcp

SET-MCP is a Python package designed to access financial statements of companies listed on the Securities Exchange of Thailand (SET). It serves as a tool for AI agents to retrieve comprehensive financial data including income statements, balance sheets, and cash flow statements.

Use cases

Use cases include financial analysis, investment research, automated reporting, and integration into financial applications for real-time data retrieval.

How to use

SET-MCP can be used via a command-line interface or programmatically in Python. To use it from the command line, you can run ‘set-mcp --transport stdio’. For programmatic access, you can import the package and use the ‘get_financial_statement’ function.

Key features

Key features include retrieval of various financial statements (income statements, balance sheets, cash flow statements), support for historical data retrieval with customizable date ranges, a command-line interface for easy integration, and FastMCP integration for enhanced functionality.

Where to use

SET-MCP is primarily used in the finance and investment sectors, particularly for analysts, investors, and developers who need to access and analyze financial data of SET-listed companies.

SET-MCP

SET-MCP is a Python package that provides tools for serving Model Context Protocol which can access the Securities Exchange of Thailand (SET). It allows AI agents to retrieve comprehensive financial statements including income statements, balance sheets, and cash flow statements for listed companies.

Features

• Retrieve financial statements for SET-listed companies
• Support for multiple financial statement types:
  • Income Statement
  • Balance Sheet
  • Cash Flow Statement
• Historical data retrieval with customizable date ranges
• Command-line interface for easy integration
• FastMCP integration for enhanced functionality

Installation

The package requires Python 3.11 or higher. You can install it using pip:

pip install set-mcp

Installing via Smithery

To install set-mcp for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install set-mcp --client claude

Usage

Command Line Interface

The package provides a command-line interface for easy access to financial data:

set-mcp --transport stdio

Using with uvx

Run

uvx set-mcp

Using with pipx

pipx install set-mcp
pipx run set-mcp

MCP.json example

Vercel

Coming soon

Available options:

• --port: Port to listen on for SSE (default: 8000)
• --host: Host to listen on (default: 0.0.0.0)
• --transport: Transport type (choices: stdio, sse, default: stdio)

Note: SSE is not yet implemented

Python API

You can also use the package programmatically in your Python code:

from set_mcp import get_financial_statement

# Get financial statements for a specific company
result = await get_financial_statement(
    symbol="PTT",  # Company symbol
    from_year=2023,
    to_year=2024
)

Development

Setup Development Environment

1. Clone the repository:

git clone https://github.com/yourusername/set-mcp.git
cd set-mcp

2. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

3. Install development dependencies:

pip install -e ".[dev]"

Running Tests

python test_client.py

The output should be no error

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

• Prem Chotipanit ([email protected] | [email protected])