Skip to main content
Glama
Nobitex MCP Server

Nobitex MCP Server

by arashjfz

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
NOBITEX_ENVNoTarget environment: `mainnet` or `testnet`.mainnet
NOBITEX_HOSTNoHost binding for HTTP transport.127.0.0.1
NOBITEX_PORTNoPort binding for HTTP transport.8000
NOBITEX_TOKENNoUser token used for `Authorization: Token <token>` authentication.
NOBITEX_DRY_RUNNoPaper-trading mode: when `true`, simulates account and trading calls locally.false
NOBITEX_TIMEOUTNoHTTP timeout in seconds.30
NOBITEX_BASE_URLNoExplicit API base URL. Overrides `NOBITEX_ENV`.
NOBITEX_AUTH_MODENoAuthentication mode when both credential types are set: `token` or `key`.auto
NOBITEX_READ_ONLYNoWhen `true`, blocks all mutating operations.false
NOBITEX_TRANSPORTNoTransport mode: `stdio`, `sse`, or `streamable-http`.stdio
NOBITEX_PUBLIC_KEYNoEd25519 public key, corresponding to the `key` field of an API key.
NOBITEX_USER_AGENTNoUser-Agent sent on every request.TraderBot/nobitex-mcp-1.0.0
NOBITEX_PRIVATE_KEYNoEd25519 private key, URL-safe base64 encoded.
NOBITEX_PAPER_BALANCESNoStarting paper balances as a JSON object.{"usdt":"10000","rls":"100000000","btc":"0.5","eth":"5"}
NOBITEX_PAPER_FEE_RATENoPaper trading fee rate.0.001

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for the Nobitex cryptocurrency exchange (Iranian market). Public market-data tools work without credentials. Trading, wallet, withdrawal, address-book, security and API-key tools require NOBITEX_TOKEN or an Ed25519 API key. Use NOBITEX_ENV=testnet (https://testnetapiv2.nobitex.ir) to exercise the agent safely. Monetary values are strings; send amounts and prices as decimal strings. Always confirm the active environment with nobitex_server_info before trading.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

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".

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).

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).

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".

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.

nobitex_get_system_optionsA

Get exchange system options: currencies, networks, tags and withdrawal limits.

nobitex_get_profileA

Get the authenticated user's profile (KYC level, bank accounts, cards).

nobitex_get_walletsC

List the user's wallets and balances.

Args: type: Optional wallet type filter.

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.

nobitex_get_wallet_balanceB

Get the balance of one currency wallet.

Args: currency: Currency symbol, e.g. "btc" or "rls".

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.

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.

nobitex_list_depositsC

List crypto deposits.

Args: wallet: Optional wallet id; all wallets when omitted. page: Page number. page_size: Items per page.

nobitex_get_limitationsB

Get the user's account limitations and verification limits.

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".

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.

nobitex_add_bank_accountB

Add a bank account (IBAN/SHABA) to the user's profile.

Args: shaba: SHABA/IBAN number. number: Optional account number.

nobitex_delete_bank_cardC

Delete a bank card by id.

nobitex_delete_bank_accountC

Delete a bank account by id.

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.

nobitex_generate_deposit_address_v2C

Generate a new deposit address (multi-address API).

Args: coin: Coin symbol. network: Network name. title: Optional address title.

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.

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.

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.

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.

nobitex_cancel_orderB

Cancel a single open order.

Args: order: Server order id. client_order_id: Client order id.

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.

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.

nobitex_list_margin_marketsB

List margin markets.

Args: details: Include extra market details such as delegation limits.

nobitex_list_liquidity_poolsB

List active liquidity/delegation pools.

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".

nobitex_get_margin_delegation_limitC

Get the delegation limit for a margin market.

Args: market: Market symbol, e.g. "BTCIRT".

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.

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.

nobitex_get_position_statusC

Get one margin position by id.

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.

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).

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.

nobitex_confirm_withdrawB

Confirm a pending withdrawal.

Args: withdraw: Withdrawal id returned by the request step. otp: SMS one-time code when required.

nobitex_cancel_withdrawC

Cancel a pending crypto withdrawal.

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.

nobitex_get_withdrawalC

Get details of one withdrawal by id.

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).

nobitex_get_rial_withdrawalA

Get details of one rial withdrawal (id prefixed CW/WJ/W).

nobitex_list_rial_withdraw_banksA

List banks supported for instant rial withdrawal.

nobitex_cancel_rial_withdrawalC

Cancel a pending rial withdrawal.

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.

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.

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.

nobitex_list_address_bookB

List address-book entries, optionally filtered by network.

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.

nobitex_delete_address_bookC

Delete an address-book entry by id.

nobitex_activate_whitelistB

Enable secure-withdrawal (whitelist) mode.

nobitex_deactivate_whitelistB

Disable secure-withdrawal (whitelist) mode.

Args: otp_code: SMS/email one-time code. tfa_code: TOTP two-factor code.

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.

nobitex_get_emergency_cancel_codeC

Get an emergency withdrawal-cancel code.

nobitex_activate_emergency_cancelC

Activate emergency withdrawal cancellation.

nobitex_get_anti_phishingA

Get the account anti-phishing code.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

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.

nobitex_list_referral_linksA

List the user's referral links.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

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.

nobitex_get_referral_statusB

Get the user's referrer status.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

nobitex_set_referrerB

Register a referrer code for the user.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

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.

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.

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.

nobitex_logoutA

Log out the current user token.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

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.

nobitex_list_api_keysA

List the user's API keys.

Requires a user token; Nobitex does not accept API-key auth for this endpoint.

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.

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.

nobitex_get_last_week_daily_profitB

Get last week's daily profit/loss.

Args: monthly: Return the last 30 days instead of one week.

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.

nobitex_get_last_month_total_profitB

Get last month's total profit/loss.

nobitex_get_websocket_tokenB

Get a token for a private websocket connection.

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.

nobitex_paper_resetA

Reset paper-trading balances, orders, trades and positions.

Only available when the server runs with NOBITEX_DRY_RUN=true.

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.

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.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

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
ResponsivenessOutdated data