Finam

You run a specialized MCP server that connects Finam Trade API to MCP clients, letting you perform trading actions, fetch market data, and manage accounts through natural-language assisted workflows. This guide shows you how to use, install, and configure Finam MCP Server so you can work with Claude Desktop, Cursor, VS Code, or other MCP clients with confidence.

How to use

Use the Finam MCP Server to access account information, assets, market data, and order management from your MCP client. You can ask your assistant to check balances, list positions, fetch historical candles, retrieve quotes, place market or limit orders, cancel orders, and view active requests. Each operation maps to Finam Trade API capabilities, exposed through clear functions you can invoke from your MCP client. Start by configuring your client to connect to the local MCP server, then issue natural-language requests like “show my balance,” “buy 10 SBER@MOEX at market price,” or “get last trades for Газпром.” The server authenticates requests using your API key and account ID you provide in the environment. Tip: Keep your API credentials secure and avoid sharing your environment with unauthorized users. Use dedicated demo accounts when exploring trading actions.

How to install

Prerequisites you must prepare before installing Finam MCP Server include a supported terminal, Python 3.12 or newer, the uv utility, Finam Trade API keys, and an MCP client like Claude Desktop, Cursor, or VS Code.

Step 1: Install uvx from PyPI using the following command:

uvx finam-mcp-server@latest

Step 2: Ensure uv is available in your terminal session. If you don’t have uv yet, install it following the uv installation instructions and restart your terminal so uv/uvx become available.

Step 3: Prepare your MCP client configuration by adding the Finam server to your client’s config. Use the provided environment variables to supply your API key and account ID.

Example environment for the client configuration (shown in your client’s config file):

{
  "mcpServers": {
    "finam": {
      "command": "uvx",
      "args": ["finam-mcp-server@latest"],
      "env": {
        "FINAM_API_KEY": "your-api-key",
        "FINAM_ACCOUNT_ID": "your-account-id"
      }
    }
  }
}

Additional installation methods

If you prefer building from source or using a local development workflow, you can clone the project and install dependencies with uv or pip. Follow the provided structure to set up a virtual environment, install requirements, and run the server locally.

git clone https://github.com/Alexander-Panov/finam-mcp.git
cd finam-mcp
uv sync
# or
pip install -e .

Available tools

get_account_info

View balance and account status

get_transactions

History of transactions

get_trades

History of trades

get_assets

List all trading instruments with filtering

get_asset_params

Parameters for a specific instrument

get_exchanges

List exchanges

get_exchange_info

Information about a specific exchange

get_option_boards

Information about option boards

get_trade_schedule

Trading session schedules

get_candles

Historical candles with various timeframes

get_quotes

Current quotes

get_order_book

Order book depth

get_last_trades

Last trades shown

get_orders

Retrieve all or filtered orders

place_order

Place market, limit, or stop orders

cancel_order

Cancel a specific order

cancel_all_orders

Cancel all open orders