Dzengi MCP server
@alexbuzo/dzengi-mcp
An MCP server for the Dzengi trading platform: market and account data are read-only, trading stays behind safety gates until you turn it on
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
- With the flags enabled, the agent can place and cancel trading orders
- Needs an API key with account access; start with demo and read-only mode
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/alexbuzo-dzengi-mcpDetects 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 'DZENGI_MAX_LEVERAGE=<DZENGI_MAX_LEVERAGE value>' --env 'DZENGI_ALLOWED_SYMBOLS=<DZENGI_ALLOWED_SYMBOLS value>' dzengi -- npx -y @alexbuzo/dzengi-mcp@0.1.0Or add to the file .mcp.json, in the project
{
"mcpServers": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS 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
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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":"dzengi","type":"stdio","command":"npx","args":["-y","@alexbuzo/dzengi-mcp@0.1.0"],"env":{"DZENGI_MAX_LEVERAGE":"<DZENGI_MAX_LEVERAGE value>","DZENGI_ALLOWED_SYMBOLS":"<DZENGI_ALLOWED_SYMBOLS value>"}}'Or add to the file .vscode/mcp.json, in the project
{
"servers": {
"dzengi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the servers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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 dzengi --env 'DZENGI_MAX_LEVERAGE=<DZENGI_MAX_LEVERAGE value>' --env 'DZENGI_ALLOWED_SYMBOLS=<DZENGI_ALLOWED_SYMBOLS value>' -- npx -y @alexbuzo/dzengi-mcp@0.1.0Or add to the file ~/.codex/config.toml, for all projects
[mcp_servers.dzengi]
command = "npx"
args = ["-y", "@alexbuzo/dzengi-mcp@0.1.0"]
env = { DZENGI_MAX_LEVERAGE = "<DZENGI_MAX_LEVERAGE value>", DZENGI_ALLOWED_SYMBOLS = "<DZENGI_ALLOWED_SYMBOLS value>" }If the file already exists, append the block to the end.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS 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
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS 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
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"type": "local",
"command": [
"npx",
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"environment": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the mcp key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the context_servers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
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": {
"dzengi": {
"command": "npx",
"args": [
"-y",
"@alexbuzo/dzengi-mcp@0.1.0"
],
"env": {
"DZENGI_MAX_LEVERAGE": "<DZENGI_MAX_LEVERAGE value>",
"DZENGI_ALLOWED_SYMBOLS": "<DZENGI_ALLOWED_SYMBOLS value>"
}
}
}
}If the file already exists, add the server inside the mcpServers key.
Keys and settings
DZENGI_ENVoptionalDZENGI_API_KEYsecret, optionalDZENGI_API_SECRETsecret, optionalDZENGI_ALLOW_TRADEoptionalDZENGI_ALLOW_LIVE_TRADINGoptionalDZENGI_MAX_ORDER_NOTIONALoptionalDZENGI_MAX_LEVERAGErequiredDZENGI_ALLOWED_SYMBOLSrequired
Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.
Install the MCP server with npx -y @alexbuzo/dzengi-mcp@0.1.0, set DZENGI_ENV=demo, DZENGI_API_KEY and DZENGI_API_SECRET, and keep DZENGI_ALLOW_TRADE=false until I explicitly ask to enable trading.
Other ways from the author
npx -y @alexbuzo/dzengi-mcp@0.1.0Runs the published package outside the project's source checkout.
This is third-party code. Review the repository files before installing.
What it does
The server sits on top of the official Dzengi REST adapter and gives an agent typed tools instead of an arbitrary HTTP proxy. Public market data reads without a key; signed account reads and any mutation need a key and secret. Trading tools (placing and cancelling orders) are disabled by default and turned on with separate environment flags, and live trading additionally needs an explicit flag plus an order notional limit. The server cannot withdraw, deposit or transfer funds and does not run a trading strategy. Secrets, signatures and auth headers never reach the logs, and response size is capped.
Who it is for. For traders who want to give an agent controlled access to their Dzengi account, and for developers who want a safe-by-default example of an MCP for a financial API.
Good fit when
- You want an agent to read Dzengi quotes, instruments and account state
- You want to test scenarios on the Dzengi demo adapter before going live
- You need an MCP with explicit safety flags before letting an agent place orders
Not a fit when
- You need withdrawals or transfers: the server does not do these
- You do not have a separate restricted Dzengi API key bound to an IP
- You want a ready trading strategy rather than access infrastructure
Example request
Show the current quote for an instrument and my Dzengi demo account balance, do not place any ordersLimitations
You need a Dzengi account and a separate restricted API key bound to an IP with two-factor authentication. Trading and live mode are off by default and turned on with separate environment variables. The README is in English, and the package is at an early 0.1.0 version with no stable release.
How to disable. Remove the dzengi block from your MCP client config, or unset the DZENGI_API_KEY and DZENGI_API_SECRET variables.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| DZENGI_ENV | demo or live, defaults to demo |
| DZENGI_API_KEY secret | Key for signed requests, not needed for public reads |
| DZENGI_API_SECRET secret | HMAC secret for the key |
| DZENGI_ALLOW_TRADE | Master mutation gate, defaults to false |
| DZENGI_ALLOW_LIVE_TRADING | Additional flag required for live trading |
| DZENGI_MAX_ORDER_NOTIONAL | Maximum order notional, mandatory when live trading is enabled |
Security check
- With the flags enabled, the agent can place and cancel trading orders
- Needs an API key with account access; start with demo and read-only mode
README in short
The README describes the safety boundary in detail: what the server does not do, secret redaction in logs, a response size cap and separate limits for signed broker HTTP requests. It then covers installing via npx or from source, creating a restricted Dzengi API key with permission and IP-binding guidance, a table of environment variables and a Codex configuration example where the MCP TOML forwards only variable names, not values.
FAQ
Can the agent withdraw money through this server?
No. The server does not implement withdrawals, deposits or transfers, even when the broker response contains such flags.
How do I enable real trading?
You need both DZENGI_ALLOW_TRADE and DZENGI_ALLOW_LIVE_TRADING flags, an order notional limit, and confirm true is still required on every mutation.
Related
A set of investment research skills for Claude Code and Codex built on four investors' methodologies. It is a research tool, not investment advice
Stripe's official MCP server, plugins and skills: the agent searches the API and docs, reads and changes account data
Alpaca's official MCP server: orders for stocks, ETFs, crypto and options, position management and market data in plain language
inn-check-ru: counterparty risk traffic light
inn-check-ru
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