SkillFoxx

Type a name, a task or a service

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

MCP server

High risk

We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.

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

In your terminal, with SkillFoxx CLI

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

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

This entry is high risk, so there is no one-click install. Review the code and add the config by hand.

Run in a terminal

claude mcp add --transport stdio --env 'API_SECRET_TOKEN=<your API_SECRET_TOKEN>' --env 'ACCOUNT_ID=<ACCOUNT_ID value>' finam -- npx -y mcp-finam-trade-api

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

code --add-mcp '{"name":"finam","type":"stdio","command":"npx","args":["-y","mcp-finam-trade-api"],"env":{"API_SECRET_TOKEN":"<your API_SECRET_TOKEN>","ACCOUNT_ID":"<ACCOUNT_ID value>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "finam": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add finam --env 'API_SECRET_TOKEN=<your API_SECRET_TOKEN>' --env 'ACCOUNT_ID=<ACCOUNT_ID value>' -- npx -y mcp-finam-trade-api

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.finam]
command = "npx"
args = ["-y", "mcp-finam-trade-api"]
env = { API_SECRET_TOKEN = "<your API_SECRET_TOKEN>", ACCOUNT_ID = "<ACCOUNT_ID value>" }

If the file already exists, append the block to the end.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "finam": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "mcp-finam-trade-api"
      ],
      "environment": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-finam-trade-api"
      ],
      "env": {
        "API_SECRET_TOKEN": "<your API_SECRET_TOKEN>",
        "ACCOUNT_ID": "<ACCOUNT_ID value>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

API_SECRET_TOKENsecret, required
ACCOUNT_IDrequired
RETURN_ASoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 73eb5ab.

Text for your agent

Generate API_SECRET_TOKEN at tradeapi.finam.ru/docs/tokens/, get ACCOUNT_ID from your personal account (digits only, no КЛФ- prefix), then add the finam server to your Claude Desktop config using npx -y mcp-finam-trade-api with these environment variables.

Other ways from the author
{
  "mcpServers": {
    "finam": {
      "command": "npx",
      "args": ["-y", "mcp-finam-trade-api"],
      "env": {
        "API_SECRET_TOKEN": "your_token",
        "ACCOUNT_ID": "your_account_id",
        "RETURN_AS": "string"
      }
    }
  }
}

The main method from the README for Claude Desktop.

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

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.

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.

Security check

  • 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

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.

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.

Editors’ pick

A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice

SkillMedium riskNo VPN needed16.6K
Official

Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data

MCP serverHigh riskNeeds a VPN1.8K
Official

Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language

MCP serverHigh risk995
Editors’ pick

An open-source skill that checks a Russian company by tax ID across EGRUL, bailiffs, courts, bankruptcy and sanctions, and returns a dated risk verdict

SkillLow riskRussian stackNo VPN needed4
Foxx AIFINAM Trade API MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.