SkillFoxx

FINAM 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

  • 0 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • Can place and cancel real exchange orders immediately on a tool call
  • The API token grants access to the user's account, trades and transactions
All reasons and checks
Russian stack

mishgancheg/mcp-finam-trade-apiAuthor:mishgancheg

Install

Services

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/finam-trade-api-mcp-server

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • Can place and cancel real exchange orders immediately on a tool call
  • The API token grants access to the user's account, trades and transactions

This is third-party code. Review the repository files before installing.

What it does

The server wraps the FINAM Trade API with 19 tools across five areas: authentication and token permissions, account info with trades and transactions, an instrument list, server time, trading parameters and schedule, options chains, historical candles, current quotes, recent trades and the order book, plus placing, viewing, listing and cancelling orders. Exact instrument lookup by ticker, ISIN or symbol is a separate tool. Besides tools, the server exposes MCP resources with enum reference data like order types and account statuses, and a ready trading-agent prompt that sets the context for a trading assistant.

Who it is for. For traders with a FINAM brokerage account who want to check quotes and manage orders through an agent.

Good fit when

  • You want to quickly check a quote, order book or historical candles for an instrument
  • You want to place, view or cancel an order through an agent
  • You want a summary of the account's trades and transactions for a period

Not a fit when

  • You do not have a FINAM brokerage account and a trading API token
  • You do not want to grant an agent the ability to place orders on its own: PlaceOrder has no separate confirmation or preview mode
  • You need a finished production service rather than a hackathon project: the README explicitly warns this is educational material

Example request

Show the current quote and order book for SBER and place a limit buy order

MCP

Transport
stdio, http
Authentication
API key

Environment variables

API_SECRET_TOKEN required, secret
FINAM Trade API token, created at tradeapi.finam.ru/docs/tokens/.
ACCOUNT_ID required
Trading account ID, digits only without the КЛФ- prefix.
RETURN_AS
Response format for tools, for example string or json.

Limitations

The project was built at the Finam AI Trade Hack, and the author states plainly that the software is provided as is for educational purposes and trading involves risk. PlaceOrder places a real order immediately on the call, with no separate confirmation or dry-run mode among the tools. For remote HTTP connections via mcp-remote, the README notes a Windows Claude Desktop quirk with spaces in headers.

How to disable. Remove the finam entry from your Claude Desktop config.

FAQ

Can the agent place an order without confirmation?

Yes, the PlaceOrder tool immediately creates a real order on the call, with no separate confirmation step built into the server itself.

Can I connect to the server remotely instead of locally?

Yes, the README describes connecting via mcp-remote to a remote HTTP or SSE address with authorization headers.

How is the FINAM Trade API MCP server by mishgancheg different from other Finam servers?

The server wraps the FINAM Trade API with 19 tools in five areas: authorization and token rights, accounts with trades and transactions, an instrument list, server time and trading parameters, plus quotes, the order book and placing and cancelling orders.

Can the agent place an order without confirmation and can I connect remotely?

The server can place and cancel orders on a real account, so require confirmation in the client or use a token without trading rights. Locally through npx, there is also an HTTP mode, and a remote server connects through mcp-remote as the README shows. It works in Claude Desktop and Claude Code. Risk is high.

Discussion

No questions or reviews yet.

MCP servers

Finam MCP server

Finam MCP Server

Russian stack

An MCP server for the Finam TradeAPI: 18 tools for the account, orders, market data and exchange reference data

MCP serverBroad access
Russian stack

An MCP server with historical data from eight exchanges, including Moscow: sectors, tickers, market cap, trading volume and treemap visualizations

MCP serverExtended access15

Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance

MCP serverBroad access871

Financial Datasets MCP

Financial Datasets MCP Server

Official

An MCP server for the Financial Datasets API: company financials, stock and crypto prices and news for the agent

MCP serverExtended access2.3K

An MCP server for MetaTrader 5: the agent reads the account and quotes, opens, changes and closes trades; a skill, REST and quote stream included

MCP serverBroad access849

MCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains

MCP serverExtended access369

README in short

The English README explains the project's origin at the Finam AI Trade Hack, gives a quick start for users via npx and for developers building from source, three connection methods: local stdio, remote via mcp-remote and local Node, tables of 19 tools, 13 enums, two schemas and the trading-agent prompt. It ends with an explicit warning about trading risk and educational purpose.

README badge

Report a problem