Nobitex MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Nobitex MCP Server what's the current BTC/IRT price and order book on Nobitex?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Nobitex MCP Server
A complete Model Context Protocol server for the Nobitex cryptocurrency exchange, built from the official API documentation at https://apidocs.nobitex.ir. It supports mainnet and testnet, both authentication schemes (user token and Ed25519 API key), and 80 tools covering every documented API section.
Testnet status: Nobitex support has confirmed that the public testnet (
https://testnetapiv2.nobitex.ir) is currently disabled. The server still supports it viaNOBITEX_ENV=testnetand will work when it is re-enabled. Until then, use the built-in paper-trading mode (NOBITEX_DRY_RUN=true) described below to test your agent safely.
Why a new server?
The community server at
xmannii/nobitex-mcp-server is not a
complete implementation:
Check | Result |
Tools exposed | 2 ( |
API coverage | Market stats only |
Base URL |
|
Authentication | None (no trading, wallet, withdrawal, or account access) |
Testnet support | None |
|
|
So the reference server cannot place orders, read balances, manage withdrawals, or target the testnet. This project replaces it with a full-coverage implementation generated from the 15 official OpenAPI specifications plus the documented paths in the API-key guide.
Related MCP server: GearTrade MCP Server
Coverage
Official API section | Tools |
Market data (public) |
|
User data / wallets |
|
Deposit addresses |
|
Spot trading |
|
Margin trading |
|
Crypto withdrawals |
|
Rial withdrawals |
|
Address book / whitelist |
|
Security |
|
Referral |
|
Authentication |
|
API keys |
|
Portfolio / P&L |
|
Websocket |
|
Paper trading |
|
Escape hatch |
|
All tools are prefixed with nobitex_ (e.g. nobitex_place_spot_order). The full list is
available at runtime via MCP tools/list.
Install
Requires Python 3.10+.
Run directly from GitHub without cloning:
uvx --from git+https://github.com/arashjfz/nobitex-mcp.git nobitex-mcpOr install locally:
git clone https://github.com/arashjfz/nobitex-mcp nobitex-mcp
cd nobitex-mcp
uv sync --extra dev # or: python -m venv .venv && pip install -e ".[dev]"Run the server over stdio:
uv run nobitex-mcp
# or
uv run python -m nobitex_mcpConfiguration
Copy .env.example to .env and fill it in. Environment variables always win over .env.
Variable | Default | Description |
|
|
|
| derived | Explicit API base URL (overrides |
| — | User token for |
| — | Ed25519 public key ( |
| — | Ed25519 private key (URL-safe base64) |
| auto |
|
|
| Block all mutating operations when |
|
| Paper-trading mode: simulate account/trading calls locally |
|
| Starting paper balances (JSON) |
|
| Paper trading fee rate |
|
|
|
|
| HTTP transport binding |
|
| Sent on every request |
|
| HTTP timeout in seconds |
Paper trading (recommended while testnet is disabled)
Nobitex support confirmed the testnet is currently down. NOBITEX_DRY_RUN=true makes the
server simulate every account and trading call in memory while still fetching real public
market data for prices:
NOBITEX_DRY_RUN=true
NOBITEX_ENV=mainnet # only public orderbook/stats are fetched
NOBITEX_PAPER_BALANCES={"usdt":"10000","rls":"100000000","btc":"0.5"}What is simulated:
spot order placement (market fills at the live best bid/ask; limit fills when crossing)
order status, list, cancel, bulk cancel
trades, wallets/balances, profile, limitations, transactions, portfolio
spot ↔ margin transfers, margin order/position/close/collateral
paper helpers:
nobitex_paper_reset,nobitex_paper_match_open_orders
What is not simulated (returns PaperModeUnsupported): withdrawals, address book,
API keys, security, referral, authentication. Public market data always goes to the live API.
Every paper response includes "paper": true, so your agent (and you) can tell it apart from
a live response. No order or withdrawal ever leaves the machine.
Testnet (when re-enabled)
The official FAQ lists the test environments:
Website: https://testnet.nobitex.ir
API:
https://testnetapiv2.nobitex.irWebsocket:
wss://ws.testnet.nobitex.ir
When Nobitex re-enables the testnet, set:
NOBITEX_ENV=testnetEvery tool then targets https://testnetapiv2.nobitex.ir. Public market-data tools need no
credentials. Testnet credentials are created from the testnet website, not the mainnet panel.
Verify the active environment at any time:
{ "tool": "nobitex_server_info", "arguments": {} }{
"environment": "testnet",
"base_url": "https://testnetapiv2.nobitex.ir",
"is_testnet": true,
"has_credentials": false,
"read_only": false
}Authentication
Option A — user token (simplest for testing):
NOBITEX_TOKEN=your-tokenOption B — Ed25519 API key (recommended for bots; supports per-key permissions and IP
allow-lists). Create a key in the Nobitex panel (Profile → API services) or with
nobitex_create_api_key, then set:
NOBITEX_PUBLIC_KEY=...
NOBITEX_PRIVATE_KEY=...
NOBITEX_AUTH_MODE=keyThe client signs exactly what Nobitex documents:
message = timestamp + METHOD + full_path + raw_body
signature = url_safe_base64(Ed25519_sign(message))where full_path includes the query string and raw_body is the exact JSON bytes sent.
Headers: Nobitex-Key, Nobitex-Signature, Nobitex-Timestamp.
Iranian IP required. The FAQ states that API requests must originate from an Iranian IP. Paper mode only needs public market data, but that data also comes from the mainnet API, so the same network rule applies.
API-key coverage. Nobitex accepts API keys on most endpoints, but these paths are
token-only (the server returns code=TokenAuthRequired when only a key is configured):
/apikeys/*, /security/anti-phishing, /users/login-attempts, /users/referral/*,
/security/validate-address-network, /auth/logout.
Other endpoints additionally require the matching key permission (for example DEPOSIT for
deposit-address listing, ADDRESS_BOOK for address-book writes, TRADE for orders).
Client configuration
Claude Desktop / Claude Code
claude_desktop_config.json:
{
"mcpServers": {
"nobitex": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/nobitex-mcp", "run", "nobitex-mcp"],
"env": {
"NOBITEX_ENV": "mainnet",
"NOBITEX_DRY_RUN": "true"
}
}
}
}Cursor / VS Code / generic MCP client
{
"mcpServers": {
"nobitex": {
"command": "/absolute/path/to/nobitex-mcp/.venv/bin/nobitex-mcp",
"env": {
"NOBITEX_ENV": "mainnet",
"NOBITEX_DRY_RUN": "true",
"NOBITEX_PUBLIC_KEY": "...",
"NOBITEX_PRIVATE_KEY": "...",
"NOBITEX_AUTH_MODE": "key"
}
}
}
}HTTP transport
NOBITEX_TRANSPORT=streamable-http NOBITEX_PORT=8000 uv run nobitex-mcp
# MCP endpoint: http://127.0.0.1:8000/mcpAgent workflow example
A safe first session using paper mode (NOBITEX_DRY_RUN=true):
nobitex_server_info— confirmdry_run: trueand inspect paper balances.nobitex_get_system_options— discover currencies, networks, and limits.nobitex_get_market_statswithsrc_currency="btc",dst_currency="usdt".nobitex_get_orderbookwithsymbol="BTCUSDT".nobitex_get_ohlc_historywithsymbol="BTCUSDT",resolution="60",to=<now>.nobitex_get_wallets— inspect balances.nobitex_place_spot_order— e.g. buy 0.001 BTC/USDT at a limit price.nobitex_list_orders/nobitex_get_order_status— verify the order.nobitex_cancel_order— clean up.
All monetary values (amount, price, stop_price, collateral, leverage) are
strings to preserve decimal precision.
Run the included demo
examples/agent_demo.py drives the MCP server through a complete agent loop.
# Paper mode: live prices, simulated balances, no real orders
uv run python examples/agent_demo.py
# Live read-only: real credentials, verifies reads and the trade guard
NOBITEX_PUBLIC_KEY=... NOBITEX_PRIVATE_KEY=... \
uv run python examples/agent_demo.py --mode readonlyPaper output: orderbook → market buy → two limit orders → list → cancel → trades →
balances → reset. Read-only output: profile, wallets, open orders, positions,
transactions, and a blocked place_spot_order.
Extra endpoints (escape hatch)
The API-key guide references paths that are not part of the public OpenAPI bundle. Use
nobitex_request for those, with the same authentication and signing:
Path | Purpose |
| Request an OTP (e.g. |
| Convert between wallet balances |
| Batch place spot orders |
| Batch cancel spot orders |
| User preferences |
| KYC verification status |
| Notifications |
| VIP credit |
| VIP credit operations |
| Credit calculators |
| Public deposit identifier |
| Margin metadata |
| Active position count |
Example:
{
"tool": "nobitex_request",
"arguments": {
"method": "POST",
"path": "/v2/otp/request",
"body": { "usage": "address_book" }
}
}Pass "auth": "none" for public paths when no credentials are configured.
Safety
Use paper mode while developing.
NOBITEX_DRY_RUN=truesimulates all trading locally and is the safest option while the testnet is disabled.Use testnet when available.
NOBITEX_ENV=testnettargets the official test environment.NOBITEX_READ_ONLY=trueblocks every mutating request (orders, cancels, transfers, withdrawals, address-book changes, API-key changes) while leaving read-only POST endpoints such as wallet listing and order status working.Tools return the raw Nobitex response, including
status,code, andbackOffon errors. Rate-limit errors surfaceretry_afterso the agent can back off.Withdrawals require the correct wallet id, network, and (when applicable)
X-TOTP. Double-check the environment and destination before calling them.Never commit
.envor private keys..gitignoreexcludes them.
Testing
uv run pytest # 24 unit tests (signing, auth, errors, read-only, paper, tools)
NOBITEX_LIVE_TEST=1 uv run pytest # + 4 live public-endpoint testsThe unit tests verify the Ed25519 signature against the documented
timestamp + METHOD + full_path + raw_body construction using a real key pair, exercise the
client through httpx.MockTransport (no network), and cover the paper broker (fills,
balances, limits, cancels, transfers, unsupported paths).
Architecture
src/nobitex_mcp/
├── config.py # env/.env settings, mainnet/testnet base URLs
├── errors.py # NobitexError hierarchy (API, auth, read-only)
├── client.py # HTTP client, Token + Ed25519 auth, signing, read-only guard
├── paper.py # in-memory paper broker for NOBITEX_DRY_RUN=true
├── server.py # 80 MCP tools + entry point
└── __main__.py # python -m nobitex_mcp
examples/
└── agent_demo.py # paper + live read-only agent loopThe client is transport-agnostic and can be reused directly:
from nobitex_mcp import NobitexClient
with NobitexClient(base_url="https://testnetapiv2.nobitex.ir") as client:
print(client.get("/v3/orderbook/BTCUSDT", auth=False))Disclaimer
This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement.
Use at your own risk. Cryptocurrency trading involves substantial risk and you can lose some or all of your funds. Nothing in this project is financial, investment, or trading advice.
The author and contributors are not responsible or liable for any loss, damage, missed profit, API misuse, account restriction, or other harm arising from the use of this software, whether caused by bugs, incorrect data, network failures, exchange behavior, or user error. You are solely responsible for every order, transfer, withdrawal, and API key used with this server.
Always start in paper mode (NOBITEX_DRY_RUN=true) or on the exchange testnet, use
read-only or IP-restricted API keys where possible, and never trade more than you can
afford to lose.
This project is not affiliated with or endorsed by Nobitex.
License
MIT — see LICENSE.
Built from the official Nobitex API documentation (https://apidocs.nobitex.ir) and the FAQ test-environment details (https://apidocs.nobitex.ir/faq).
Available Tools
80 toolsnobitex_activate_emergency_cancelC
Activate emergency withdrawal cancellation.
Inputs: no named parameters.
nobitex_activate_whitelistB
Enable secure-withdrawal (whitelist) mode.
Inputs: no named parameters.
nobitex_add_address_bookC
Add an address-book entry in one step (legacy flow).
Args: title: Address title. network: Network name. address: Destination address. otp_code: SMS/email one-time code. tfa_code: TOTP two-factor code. tag: Optional tag/memo.
Inputs: title (required), address (required), network (required), otp_code (required), +2 more.
nobitex_add_bank_accountB
Add a bank account (IBAN/SHABA) to the user's profile.
Args: shaba: SHABA/IBAN number. number: Optional account number.
Inputs: shaba (required), number.
nobitex_add_bank_cardC
Add a bank card to the user's profile.
Args: number: Card number. bank: Bank name; defaults to "سایر" on the server.
Inputs: number (required), bank.
nobitex_cancel_old_ordersC
Cancel old open orders in bulk.
Args: hours: Cancel orders older than this many hours. execution: Filter by execution type. trade_type: Filter by spot or margin. src_currency: Filter by source currency. dst_currency: Filter by destination currency.
Inputs: hours, execution, trade_type, dst_currency, +1 more.
nobitex_cancel_orderB
Cancel a single open order.
Args: order: Server order id. client_order_id: Client order id.
Inputs: order, client_order_id.
nobitex_cancel_rial_withdrawalC
Cancel a pending rial withdrawal.
Inputs: withdraw_id (required).
nobitex_cancel_withdrawC
Cancel a pending crypto withdrawal.
Inputs: withdraw (required).
nobitex_close_positionC
Close (settle) a margin position.
Args: position_id: Position id. execution: Close execution type; "market" closes at best price. amount: Amount to settle as a decimal string. price: Limit price for limit/stop_limit closes. stop_price: Trigger price for stop closes. stop_limit_price: Paired stop-limit price. client_order_id: Optional client order id.
Inputs: position_id (required), price, amount, execution, +3 more.
nobitex_confirm_address_book_itemA
Confirm an address-book item (step 2 of 2).
Args: id: address_book_item_id from the create step. otp_code: OTP obtained from /v2/otp/request with usage=address_book.
Inputs: id (required), otp_code (required).
nobitex_confirm_withdrawB
Confirm a pending withdrawal.
Args: withdraw: Withdrawal id returned by the request step. otp: SMS one-time code when required.
Inputs: withdraw (required), otp.
nobitex_create_address_book_itemB
Create an inactive address-book item (step 1 of 2).
Args: title: Address title. network: Network name. address: Destination address. tfa_code: TOTP two-factor code. tag: Optional tag/memo.
Inputs: title (required), address (required), network (required), tfa_code (required), +1 more.
nobitex_create_api_keyA
Create an API key. The private key is returned only once.
Args: name: Key name. permissions: Comma-separated permissions: READ,TRADE,WITHDRAW,DEPOSIT,ADDRESS_BOOK,OTP,VIP_CREDIT. description: Optional description. ip_whitelist: Optional list of allowed IPv4/IPv6 addresses (max 15). expiration_date: Optional ISO-8601 expiry in the future. totp: TOTP two-factor code (required, sent as X-TOTP).
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: name (required), permissions (required), totp, description, +2 more.
nobitex_create_referral_linkB
Create a referral link.
Args: friend_share: Commission share granted to the invited friend. agenda: Referral program/scenario identifier.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: agenda, friend_share.
nobitex_deactivate_whitelistB
Disable secure-withdrawal (whitelist) mode.
Args: otp_code: SMS/email one-time code. tfa_code: TOTP two-factor code.
Inputs: otp_code (required), tfa_code (required).
nobitex_delete_address_bookC
Delete an address-book entry by id.
Inputs: address_id (required).
nobitex_delete_api_keyB
Delete an API key.
Args: public_key: Public key of the API key. totp: TOTP two-factor code (required, sent as X-TOTP).
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: public_key (required), totp.
nobitex_delete_bank_accountC
Delete a bank account by id.
Inputs: id (required).
nobitex_delete_bank_cardC
Delete a bank card by id.
Inputs: id (required).
nobitex_edit_position_collateralC
Set the total collateral of an open margin position.
Args: position_id: Position id. collateral: New total collateral as a decimal string (not a delta).
Inputs: collateral (required), position_id (required).
nobitex_generate_deposit_addressB
Generate a blockchain deposit address.
Args: wallet: Spot wallet id. currency: Currency code when wallet is omitted. network: Network name. address_type: Address type, "default" or "legacy".
Inputs: wallet, network, currency, address_type.
nobitex_generate_deposit_address_v2C
Generate a new deposit address (multi-address API).
Args: coin: Coin symbol. network: Network name. title: Optional address title.
Inputs: coin (required), network (required), title.
nobitex_get_anti_phishingA
Get the account anti-phishing code.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_get_emergency_cancel_codeC
Get an emergency withdrawal-cancel code.
Inputs: no named parameters.
nobitex_get_last_month_total_profitB
Get last month's total profit/loss.
Inputs: no named parameters.
nobitex_get_last_week_daily_profitB
Get last week's daily profit/loss.
Args: monthly: Return the last 30 days instead of one week.
Inputs: monthly.
nobitex_get_last_week_daily_total_profitB
Get last week's daily total profit/loss.
Args: monthly: Return the last 30 days instead of one week.
Inputs: monthly.
nobitex_get_limitationsB
Get the user's account limitations and verification limits.
Inputs: no named parameters.
nobitex_get_login_attemptsA
Get the user's login attempt history.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_get_margin_delegation_limitC
Get the delegation limit for a margin market.
Args: market: Market symbol, e.g. "BTCIRT".
Inputs: market (required).
nobitex_get_market_depthB
Get aggregated market depth for a single market.
Args: symbol: Market symbol such as BTCIRT or BTCUSDT ("all" is not supported).
Inputs: symbol (required).
nobitex_get_market_statsB
Get 24h market statistics (price, volume, change) for markets.
Args: src_currency: Source currency or comma-separated list, e.g. "btc,eth". dst_currency: Destination currency or comma-separated list, e.g. "rls,usdt".
Inputs: dst_currency, src_currency.
nobitex_get_ohlc_historyB
Get OHLC candle history for a market.
Args:
symbol: Market symbol such as BTCIRT or BTCUSDT.
resolution: Candle timeframe: minutes (1,5,15,30,60,180,240,360,720) or days (D,1D,2D,3D).
to: End time as a Unix timestamp in seconds.
from_ts: Start time as a Unix timestamp in seconds.
countback: Number of candles before to (max 500); takes priority over from_.
page: Page number for older candles.
Inputs: to (required), symbol (required), resolution (required), page, +2 more.
nobitex_get_orderbookB
Get the level-2 order book for one market or all markets.
Args: symbol: Market symbol such as BTCIRT or BTCUSDT, or "all".
Inputs: symbol.
nobitex_get_order_statusC
Get the status of one order by id or client order id.
Args: id: Server order id. client_order_id: Client order id.
Inputs: id, client_order_id.
nobitex_get_position_statusC
Get one margin position by id.
Inputs: position_id (required).
nobitex_get_profileA
Get the authenticated user's profile (KYC level, bank accounts, cards).
Inputs: no named parameters.
nobitex_get_recent_tradesB
Get the most recent public trades for a single market.
Args: symbol: Market symbol such as BTCIRT or BTCUSDT ("all" is not supported).
Inputs: symbol (required).
nobitex_get_referral_statusB
Get the user's referrer status.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_get_rial_withdrawalA
Get details of one rial withdrawal (id prefixed CW/WJ/W).
Inputs: withdraw_id (required).
nobitex_get_selected_walletsC
List selected wallets, optionally filtered by currencies.
Args: currencies: Comma-separated currency list, e.g. "btc,usdt". type: Optional wallet type filter.
Inputs: type, currencies.
nobitex_get_system_optionsA
Get exchange system options: currencies, networks, tags and withdrawal limits.
Inputs: no named parameters.
nobitex_get_transactions_historyC
Get the user's transaction history across wallets.
Args: currency: Optional currency filter. tp: Transaction type list (API-specific string). from_ts: Start time as Unix timestamp (seconds). to_ts: End time as Unix timestamp (seconds). from_id: Minimum transaction id. page: Page number. page_size: Items per page. details: Detail level. download: Request a downloadable export when supported.
Inputs: tp, page, to_ts, details, +5 more.
nobitex_get_wallet_balanceB
Get the balance of one currency wallet.
Args: currency: Currency symbol, e.g. "btc" or "rls".
Inputs: currency (required).
nobitex_get_walletsC
List the user's wallets and balances.
Args: type: Optional wallet type filter.
Inputs: type.
nobitex_get_websocket_infoA
Describe the Nobitex websocket endpoint and available channels.
MCP tools are request/response, so this returns connection details rather than streaming. Use the token tool for private channels.
Inputs: no named parameters.
nobitex_get_websocket_tokenB
Get a token for a private websocket connection.
Inputs: no named parameters.
nobitex_get_withdrawalC
Get details of one withdrawal by id.
Inputs: withdraw_id (required).
nobitex_legacy_loginB
Log in through the legacy endpoint.
Args: username: Username/email. password: Password. captcha: Captcha value; "api" for bots. remember: "yes" to issue a persistent token.
Inputs: password (required), username (required), captcha, remember.
nobitex_list_address_bookB
List address-book entries, optionally filtered by network.
Inputs: network.
nobitex_list_api_keysA
List the user's API keys.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_list_deposit_addressesA
List generated deposit addresses for a coin/network.
Args: network: Network name, e.g. "ETH". coin: Coin symbol, e.g. "eth". ordering: Sort by creation time, newest first by default. is_disabled: true = disabled only, false = active only. search: Substring search on address title. page: Page number. page_size: Items per page.
Inputs: coin (required), network (required), page, search, +3 more.
nobitex_list_depositsC
List crypto deposits.
Args: wallet: Optional wallet id; all wallets when omitted. page: Page number. page_size: Items per page.
Inputs: page, wallet, page_size.
nobitex_list_liquidity_poolsB
List active liquidity/delegation pools.
Inputs: no named parameters.
nobitex_list_margin_marketsB
List margin markets.
Args: details: Include extra market details such as delegation limits.
Inputs: details.
nobitex_list_ordersB
List the user's orders with optional filters.
Args: status: all, open, done or close. type: buy or sell. execution: Order execution type. trade_type: spot or margin. src_currency: Source currency, e.g. "btc". dst_currency: Destination currency, e.g. "rls". details: Detail level, 1 or 2. from_id: Only orders with id >= from_id (do not combine with page). order: Sort order. page: Page number. page_size: Items per page.
Inputs: page, type, order, status, +7 more.
nobitex_list_positionsC
List margin positions.
Args: src_currency: Base currency filter. dst_currency: Quote currency filter. status: "active" (open) or "past" (settled/closed/liquidated). page: Page number. page_size: Items per page.
Inputs: page, status, page_size, dst_currency, +1 more.
nobitex_list_referral_linksA
List the user's referral links.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_list_rial_withdraw_banksA
List banks supported for instant rial withdrawal.
Inputs: no named parameters.
nobitex_list_user_tradesB
List the user's executed trades.
Args: src_currency: Source currency (must be paired with dst_currency). dst_currency: Destination currency (must be paired with src_currency). from_id: Minimum trade id. trade_type: buy or sell. trade_order: asc or desc (default desc). page: Page number. page_size: Items per page.
Inputs: page, from_id, page_size, trade_type, +3 more.
nobitex_list_wallet_transactionsC
List transactions for a single wallet.
Args: wallet: Wallet id. page: Page number. page_size: Items per page. details: Detail level.
Inputs: wallet (required), page, details, page_size.
nobitex_list_withdrawalsB
List crypto withdrawals.
Args: wallet: Wallet id or "all". from_date: Start date, YYYY-MM-DD. to_date: End date, YYYY-MM-DD. page: Page number. page_size: Items per page.
Inputs: page, wallet, to_date, from_date, +1 more.
nobitex_loginA
Log in and obtain a user token (handles MFA second step).
Args: username: Username/email. password: Password (first step). captcha: Captcha value; "api" for bots. remember: "yes" to issue a persistent token. mfa_token: Temporary token from the first step (MFA step). device: Device id from the first step (MFA step). otp: OTP for MFA methods 3/4.
Inputs: username (required), otp, device, captcha, +3 more.
nobitex_logoutA
Log out the current user token.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: no named parameters.
nobitex_paper_match_open_ordersA
Re-check open paper limit orders against the live order book and fill crossing ones.
Only available when the server runs with NOBITEX_DRY_RUN=true.
Inputs: no named parameters.
nobitex_paper_resetA
Reset paper-trading balances, orders, trades and positions.
Only available when the server runs with NOBITEX_DRY_RUN=true.
Inputs: no named parameters.
nobitex_place_margin_orderB
Place a margin (leverage) order.
Args: type: Order side, "buy" or "sell". src_currency: Base currency, e.g. "btc". dst_currency: Quote currency, e.g. "usdt". amount: Order size as a decimal string. execution: "limit", "market", "stop_limit" or "stop_market". price: Limit price (required for limit/stop_limit). stop_price: Trigger price (required for stop orders / OCO). stop_limit_price: Paired stop-limit price (required for OCO). leverage: Leverage multiplier as a string, e.g. "2". client_order_id: Optional unique client id. mode: Set "oco" for an OCO order.
Inputs: type (required), amount (required), dst_currency (required), src_currency (required), +7 more.
nobitex_place_spot_orderB
Place a spot order.
Args: type: Order side, "buy" or "sell". src_currency: Source/base currency, e.g. "btc". dst_currency: Destination/quote currency, e.g. "usdt" or "rls". amount: Order size in src_currency, as a decimal string. execution: "limit" (default), "market", "stop_limit" or "stop_market". price: Unit price; required for limit/stop_limit. Decimal string. client_order_id: Optional unique client id (max 32 chars). pro: Disable the 10-second duplicate-order check. mode: Set "oco" for an OCO order. stop_price: Trigger price for stop orders / OCO. stop_limit_price: Paired stop-limit price for OCO.
Inputs: type (required), amount (required), dst_currency (required), src_currency (required), +7 more.
nobitex_requestA
Call any Nobitex API path with correct authentication and signing.
Use this for documented endpoints that do not yet have a dedicated tool, for example /v2/otp/request, /users/wallets/convert, /credit/*, /market/orders/batch-add, /market/orders/cancel-batch, /users/preferences.
Args: method: HTTP method. path: API path beginning with "/", e.g. "/v2/otp/request". params: Query parameters. body: JSON request body. auth: "auto" (use configured credentials), "none", "token" or "key". totp: Optional X-TOTP code.
Inputs: path (required), method (required), auth, body, +2 more.
nobitex_request_rial_withdrawalC
Request a rial withdrawal to a verified bank account.
Args: destination_bank_account_id: Verified bank account id. amount: Total amount in rial as a decimal string (fee is deducted).
Inputs: amount (required), destination_bank_account_id (required).
nobitex_resend_login_otpB
Resend the MFA OTP for a pending login.
Args: username: Username/email. mfa_token: Temporary token from the first step. device: Device id from the first step.
Inputs: device (required), username (required), mfa_token (required).
nobitex_server_infoA
Report the active Nobitex environment, base URL and credential status.
Call this first to confirm whether the server is pointed at mainnet or testnet and whether trading credentials are configured.
Inputs: no named parameters.
nobitex_set_anti_phishingB
Create or change the anti-phishing code.
Args: code: New anti-phishing code. otp_code: One-time code sent to the user.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: code (required), otp_code (required).
nobitex_set_referrerB
Register a referrer code for the user.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: referrer_code (required).
nobitex_transfer_between_walletsC
Transfer funds between the spot and margin wallets.
Args: currency: Currency name. amount: Amount as a decimal string. src: Source wallet, "spot" or "margin". dst: Destination wallet, "spot" or "margin".
Inputs: dst (required), src (required), amount (required), currency (required).
nobitex_update_api_keyB
Update an API key's name, description or IP whitelist.
Args: public_key: Public key of the API key. totp: TOTP two-factor code (required, sent as X-TOTP). name: New name. description: New description. ip_whitelist: New IP whitelist (max 15).
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: public_key (required), name, totp, description, +1 more.
nobitex_update_deposit_address_titleA
Update the title of a deposit address.
Args: address_id: Address id from the list/generate endpoints. title: New title; empty/null clears it.
Inputs: address_id (required), title.
nobitex_validate_address_networkB
Validate a destination address (and optional tag) for a network.
Args: network: Network name, e.g. "BSC". address: Destination wallet address. tag: Optional tag/memo.
Requires a user token; Nobitex does not accept API-key auth for this endpoint.
Inputs: address (required), network (required), tag.
nobitex_withdraw_cryptoB
Request a crypto withdrawal.
Args: wallet: Spot wallet id. amount: Amount as a decimal string (omit for Lightning invoices). address: Destination address (omit for Lightning invoices). network: Network name; required for multi-network assets such as USDT. tag: Destination tag/memo where supported. no_tag: Set true to withdraw without a tag. invoice: Lightning invoice (BTCLN), replaces amount/address. explanations: Optional note. totp: 2FA code when the destination is not whitelisted.
Inputs: wallet (required), tag, totp, amount, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 80 tools
Most tools target distinct resources/actions, but several clusters overlap: get_wallet_balance vs get_wallets vs get_selected_wallets, generate_deposit_address vs _v2, add_address_book vs create/confirm_address_book_item, and login vs legacy_login. Descriptions help, but an agent can still misselect among these similar-looking operations.
Nearly all tools use a consistent nobitex_ prefix with snake_case and verb_noun structure. Minor deviations such as server_info, request, paper_reset, and get_websocket_info keep it from being perfect.
80 tools is far beyond a typical well-scoped MCP surface and creates a heavy selection burden. The broad exchange domain justifies many operations, but the set is still over-scoped and would benefit from consolidation.
The surface covers market data, spot and margin trading, wallets, deposits, withdrawals, bank/address book, security settings, API keys, referrals, websocket info, paper trading, and a generic request escape hatch. No obvious lifecycle gaps remain for the stated exchange domain.
Maintenance
Related MCP Connectors
Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.
Live crypto + IDX stock market intelligence for AI agents — 19 tools, no API key.
Warden MCP lets AI agents find tokens, quote swaps and trade onchain on Base, BNB Chain, Robinhood Chain, Arc and Solana, within limits you set. Market tools need no credential: list_chains, search_tokens, trending_tokens, price_history, quote_swap and swap_status. Search by name, ticker or contract address, read USD price candles, and price a swap before committing to it, including cross-chain swaps. Wallet tools act for the wallet whose owner connected the agent, by OAuth sign-in or a wk_ key. agent_permissions shows what the agent may do and its daily limits. prepare_swap builds a trade and hands the owner a review link to sign. With request_session the owner turns on hands-free trading in one tap, and execute_swap then trades within the limits they set. swap_status tracks gasless and cross-chain trades. get_wallet shows holdings on every chain. Gasless trading is available on Base, BNB Chain and Robinhood Chain. Built by Warden Protocol, the team behind Warden Token Terminal.
Web search, point-in-time crypto market data, verified strategy track records and 160+ agent tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perform cryptocurrency trading operations on Binance exchange through 30 comprehensive tools supporting spot trading, futures contracts, options, account management, market data analysis, and risk control features. Provides enterprise-grade security with local encrypted API key storage and supports multiple account types with sandbox environment testing.9MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.7MIT
- AlicenseAqualityCmaintenanceEnables AI agents to trade forex, metals, indices, and cryptocurrencies via the Model Context Protocol using the XBTFX Trading API. It provides comprehensive tools for managing account balances, retrieving market data, and executing trade operations like opening, modifying, or closing positions.1514 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables LLM agents to access BingX cryptocurrency exchange market data and execute trades through the official API, with support for account management, order creation, and technical indicators.-