SET-MCP Server

Provides access to SET-listed companies' income statements, balance sheets, and cash flow statements via an MCP server.

python

4

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "batprem-set-mcp": {
      "command": "/path/to/bin/uvx",
      "args": [
        "set-mcp"
      ],
      "env": {
        "YOUR_TOKEN": "YOUR_TOKEN"
      }
    }
  }
}

SET-MCP provides tools to serve the Model Context Protocol for accessing financial data from the SET. It enables you to retrieve income statements, balance sheets, and cash flow statements for SET-listed companies, with options for historical ranges and convenient command-line usage.

How to use

You interact with SET-MCP through a local CLI or by running it via an MCP client. Start the MCP server locally, then connect your client to request financial statements for specific SET-listed companies. You can fetch current data or historical data over a chosen date range. Use the client to request one or more statement types (Income Statement, Balance Sheet, Cash Flow Statement) for a given company symbol.

From a client perspective, you should start the MCP process using the standard stdio transport, then issue requests to retrieve the financial data you need. The server is designed to integrate smoothly with MCP clients, enabling you to automate data retrieval as part of larger financial analysis workflows.

How to install

Prerequisites you need before installing SET-MCP: Python 3.11 or higher.

Install the package with pip:

pip install set-mcp

If you want to install using Smithery for Claude Desktop automation, run the following:

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

You can also run the MCP server via uvx or pipx. For uvx usage, start the MCP with the standard command:

uvx set-mcp

To run SET-MCP with pipx you can install and then execute the server:

pipx install set-mcp
pipx run set-mcp

If you prefer to wire SET-MCP into a MCP.json configuration, you can define the stdio-based entry as shown in an example configuration snippet.

{
  "mcpServers": {
    "set_mcp": {
      "command": "uvx",
      "args": [
        "set-mcp"
      ]
    }
  }
}

Available tools

get_financial_statement

Fetch financial statements for a specific SET-listed company, returning income statement, balance sheet, or cash flow data for a given date range.

start_server_cli

Start the MCP server using the command-line interface, selecting transport type and port for SSE or stdio interactions.