Skip to main content
Glama
Nobitex MCP Server

Nobitex MCP Server

by arashjfz

Nobitex MCP Server

Listed on mcpservers.org

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 via NOBITEX_ENV=testnet and 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 (getMarketStats, getGlobalStats)

API coverage

Market stats only

Base URL

https://api.nobitex.ir — no longer resolves (the official base is https://apiv2.nobitex.ir)

Authentication

None (no trading, wallet, withdrawal, or account access)

Testnet support

None

getGlobalStats endpoint

POST /market/global-stats is not in the current docs (GET /market/stats is)

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)

get_orderbook, get_market_depth, get_recent_trades, get_market_stats, get_ohlc_history, get_system_options

User data / wallets

get_profile, get_wallets, get_selected_wallets, get_wallet_balance, list_wallet_transactions, get_transactions_history, list_deposits, get_limitations, generate_deposit_address, bank card/account add & delete

Deposit addresses

list_deposit_addresses, generate_deposit_address_v2, update_deposit_address_title

Spot trading

place_spot_order, get_order_status, list_orders, cancel_order, cancel_old_orders, list_user_trades

Margin trading

list_margin_markets, list_liquidity_pools, transfer_between_wallets, get_margin_delegation_limit, place_margin_order, list_positions, get_position_status, close_position, edit_position_collateral

Crypto withdrawals

withdraw_crypto, confirm_withdraw, cancel_withdraw, list_withdrawals, get_withdrawal

Rial withdrawals

request_rial_withdrawal, get_rial_withdrawal, list_rial_withdraw_banks, cancel_rial_withdrawal

Address book / whitelist

validate_address_network, create_address_book_item, confirm_address_book_item, list_address_book, add_address_book, delete_address_book, activate_whitelist, deactivate_whitelist

Security

get_login_attempts, get_emergency_cancel_code, activate_emergency_cancel, get_anti_phishing, set_anti_phishing

Referral

list_referral_links, create_referral_link, get_referral_status, set_referrer

Authentication

login, resend_login_otp, legacy_login, logout

API keys

create_api_key, list_api_keys, delete_api_key, update_api_key

Portfolio / P&L

get_last_week_daily_profit, get_last_week_daily_total_profit, get_last_month_total_profit

Websocket

get_websocket_token, get_websocket_info

Paper trading

paper_reset, paper_match_open_orders

Escape hatch

request — call any documented path with correct signing

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-mcp

Or 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_mcp

Configuration

Copy .env.example to .env and fill it in. Environment variables always win over .env.

Variable

Default

Description

NOBITEX_ENV

mainnet

mainnet or testnet

NOBITEX_BASE_URL

derived

Explicit API base URL (overrides NOBITEX_ENV)

NOBITEX_TOKEN

—

User token for Authorization: Token <token>

NOBITEX_PUBLIC_KEY

—

Ed25519 public key (key field of an API key)

NOBITEX_PRIVATE_KEY

—

Ed25519 private key (URL-safe base64)

NOBITEX_AUTH_MODE

auto

token or key when both credential types are set

NOBITEX_READ_ONLY

false

Block all mutating operations when true

NOBITEX_DRY_RUN

false

Paper-trading mode: simulate account/trading calls locally

NOBITEX_PAPER_BALANCES

{"usdt":"10000","rls":"100000000","btc":"0.5","eth":"5"}

Starting paper balances (JSON)

NOBITEX_PAPER_FEE_RATE

0.001

Paper trading fee rate

NOBITEX_TRANSPORT

stdio

stdio, sse, or streamable-http

NOBITEX_HOST / NOBITEX_PORT

127.0.0.1 / 8000

HTTP transport binding

NOBITEX_USER_AGENT

TraderBot/nobitex-mcp-1.0.0

Sent on every request

NOBITEX_TIMEOUT

30

HTTP timeout in seconds

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:

When Nobitex re-enables the testnet, set:

NOBITEX_ENV=testnet

Every 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-token

Option 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=key

The 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/mcp

Agent workflow example

A safe first session using paper mode (NOBITEX_DRY_RUN=true):

  1. nobitex_server_info — confirm dry_run: true and inspect paper balances.

  2. nobitex_get_system_options — discover currencies, networks, and limits.

  3. nobitex_get_market_stats with src_currency="btc", dst_currency="usdt".

  4. nobitex_get_orderbook with symbol="BTCUSDT".

  5. nobitex_get_ohlc_history with symbol="BTCUSDT", resolution="60", to=<now>.

  6. nobitex_get_wallets — inspect balances.

  7. nobitex_place_spot_order — e.g. buy 0.001 BTC/USDT at a limit price.

  8. nobitex_list_orders / nobitex_get_order_status — verify the order.

  9. 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 readonly

Paper 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

POST /v2/otp/request

Request an OTP (e.g. usage=address_book)

POST /users/wallets/convert

Convert between wallet balances

POST /market/orders/batch-add

Batch place spot orders

POST /market/orders/cancel-batch

Batch cancel spot orders

GET /users/preferences

User preferences

GET /users/verification/status

KYC verification status

GET /notifications/list

Notifications

GET /credit/plan, /credit/debt-detail, /credit/transactions

VIP credit

POST /credit/lend, /credit/repay

VIP credit operations

GET /credit/lend-calculator, /credit/withdraw-calculator

Credit calculators

POST /users/generate-public-id

Public deposit identifier

GET /margin/fee-rates, /margin/my-delegation-limit-details

Margin metadata

GET /positions/active-count

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=true simulates all trading locally and is the safest option while the testnet is disabled.

  • Use testnet when available. NOBITEX_ENV=testnet targets the official test environment.

  • NOBITEX_READ_ONLY=true blocks 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, and backOff on errors. Rate-limit errors surface retry_after so 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 .env or private keys. .gitignore excludes 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 tests

The 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 loop

The 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 tools
nobitex_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_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_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

    B3/5.0

    Scored across 80 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      9
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      7
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      15
      14 npm
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -