Finam MCP: Documentation
Updated:
Connection
uvx finam-mcp-server@latest (stdio). Env vars: FINAM_API_KEY and FINAM_ACCOUNT_ID from the FINAM Trade API dashboard (api.finam.ru), "Tokens" section — the same place you can spin up a free demo account. Requirements: Python 3.12+, the uv package manager. Ready-made configs for Claude Desktop, Cursor and VS Code are in the repo README.
Capabilities
16 tools across 4 groups:
- Account and positions:
get_account_info(),get_transactions(),get_trades(). - Assets:
get_assets(),get_asset_params(),get_exchanges(),get_exchange_info(),get_option_boards(),get_trade_schedule(). - Market data:
get_candles(),get_quotes(),get_order_book(),get_last_trades(). - Trading:
get_orders(),place_order()(market/limit/stop),cancel_order(),cancel_all_orders().
Agent flow
"What's my Finam balance and open positions?", "buy 10 Sberbank shares at market price", "sell 5 Gazprom shares with a 150 RUB limit order", "show me 5-minute Sberbank candles for the last 2 hours", "cancel all open orders".
Pricing
The MCP server is free (MIT); Trade API usage is billed per FINAM's plans (the demo account is free for testing).