Finam MCP server
Finam MCP Server
An MCP server for the Finam TradeAPI: 18 tools for the account, orders, market data and exchange reference data
- 0 ★ on the repository
- Last commit
Broad access
Why this level
- Tools can place and cancel exchange orders
- The token grants access to a real brokerage account
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/tikhonov-aleksei-finam-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Tools can place and cancel exchange orders
- The token grants access to a real brokerage account
This is third-party code. Review the repository files before installing.
What it does
The server wraps the Finam TradeAPI in MCP tools organized by clean-architecture layers: account info, trade and transaction history, instrument/exchange/schedule reference data, placing and cancelling orders, historical bars, quotes, the order book and recent trades. Authorization uses a Finam API token, which the server exchanges for a short-lived JWT and refreshes automatically. It runs as a regular stdio MCP server via uv or as a plain package.
Who it is for. For traders with a Finam brokerage account who want to fetch market data and manage orders through an agent.
Good fit when
- You want to check your Finam account balance, trades and transactions from a chat with an agent
- You need historical bars, the order book or quotes for Finam instruments
- You want to place or cancel an order without switching to the trading terminal
Not a fit when
- You do not have a Finam API token and account ID
- You are not ready to give an agent access to placing exchange orders
Example request
Show my last week of trades on my Finam account and the current quote for SBERMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
FINAM_API_TOKENrequired, secret- Finam API token from your account
FINAM_ACCOUNT_IDrequired- Trading account ID
Limitations
You need Python 3.12, the uv package manager, and a FINAM_API_TOKEN plus FINAM_ACCOUNT_ID from your Finam account. The README points installation at the mdmeldon/finam-mcp repository sharing the same codebase; there is no separate PyPI release for this project. Interface stability is not guaranteed.
How to disable. Remove the finam block from your MCP client config and revoke the API token in your Finam account.
FAQ
Do I need a separate key for each tool?
No, the token and account ID are set once when configuring the MCP server and used across all 18 tools.
How long does the access token last?
The API token is exchanged for a JWT valid for about 15 minutes, refreshed automatically by the client.
Discussion
No questions or reviews yet.
Related
MCP serversFINAM Trade API MCP server
FINAM Trade API MCP Server
An MCP server for FINAM brokerage trading: quotes, order book, placing and cancelling orders, accounts and trade history
Finmap MCP server with exchange data, including MOEX
Finmap MCP Server
An MCP server with historical data from eight exchanges, including Moscow: sectors, tickers, market cap, trading volume and treemap visualizations
Financial Datasets MCP
Financial Datasets MCP Server
An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
An MCP server for personal stock analysis: market data, technical indicators, screening and portfolio tracking, no keys for the core
MCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
README in short
The Russian README gives two install paths: via MCP configuration with a uvx command, and running from source with uv sync. It lists all 18 tools in groups: account and portfolio, reference data, orders, market data. It shows tool call examples and explains that the token is only used to obtain a short-lived JWT.