Ultrade

You run a self-contained MCP server for Ultrade tools that lets you manage wallets, markets, and system information through a consistent API. This server sits between your client and Ultrade services, offering a focused set of tools you can call to perform common trading operations.

How to use

Connect your MCP client to the Ultrade MCP Server to access wallet, market, and system tools. You can generate signed messages, create and manage orders, fetch market data, and review system information through the available endpoints. Use the client to perform common tasks such as signing in to trading accounts, querying balances and trades, placing orders, retrieving market depth and history, and checking the system version and status.

When you make calls, you will specify the tool name (for example, a wallet or market operation) along with the required data payload. The server returns structured results that you can pass directly to your UI or workflow. If you need to inspect or adjust behavior, you can review system details and maintenance status to plan upgrades or downtime accordingly.

How to install

Prerequisites you must have before installing the Ultrade MCP Server: a Node.js runtime installed and a working shell to run commands.

Check your Node.js version to ensure it is 23.6.1 or later.

Prepare a local path on your machine for the MCP server. You will place the server under a dedicated mcp-servers folder inside your MCP client environment (for example Claude or Cursor). Create the folder if it does not exist.

Clone the Ultrade MCP repository under the mcp-servers folder, install dependencies, and build the project.

Edit the environment configuration to set your API endpoints, network, and account-specific values.

Add the server to your MCP client configuration by specifying the runtime command, arguments, and environment variables, so the client can launch the MCP server when needed.

Below is a complete example you can adapt to your environment. Adjust the paths to match your local setup.

Configuration and example setups

{
  "mcpServers": {
    "ultrade-mcp": {
      "command": "node",
      "args": [
        "PATH_ON_YOUR_MACHINE/Claude/mcp-servers/ultrade-mcp/dist/index.js"
      ],
      "env": {
        "ALGORAND_NETWORK": "mainnet",
        "ALGORAND_ALGOD_API": "https://mainnet-api.algonode.cloud/v2",
        "ALGORAND_ALGOD": "https://mainnet-api.algonode.cloud",
        "ALGORAND_ALGOD_PORT": "",
        "ALGORAND_TOKEN": "",
        "ALGORAND_AGENT_WALLET_ACTIVE": "problem aim online jaguar upper oil flight stumble mystery aerobic toy avoid file tomato moment exclude witness guard lab opera crunch noodle dune abandon broccoli",
        "ULTRADE_API_URL": "https://api.ultrade.io",
        "ITEMS_PER_PAGE": "10"
      }
    }
  }
}

Make sure you adjust the paths to match your local system setup.

Notes and tips

The Ultrade MCP Server is designed as a standalone service. You run it as a local process and connect via your MCP client using the configuration shown above. Ensure you provide valid environment values for your Algorand network, API endpoints, and any required tokens. Keep sensitive credentials secure and avoid exposing them in client-side code or logs.

If you need to start the server in development mode, use the development command provided by your setup and verify the server starts without errors before connecting your client.

Available tools

ultrade_wallet_signin_message

Generate message from the sign in data

ultrade_wallet_signin

Sign in to trading account

ultrade_wallet_key_message

Generate message from the trading key data

ultrade_wallet_add_key

Add a trading key

ultrade_wallet_keys

Get trading keys

ultrade_wallet_revoke_key

Revoke a trading key

ultrade_wallet_withdraw

Withdraw token

ultrade_wallet_trades

Get filtered wallet trades

ultrade_wallet_transactions

Get filtered wallet transactions

ultrade_wallet_withdraw_message

Generate message from the withdrawal data

ultrade_market_chains

Get blockchain chains

ultrade_market_withdrawal_fee

Get withdrawal fee

ultrade_market_operation_details

Get operation details

ultrade_market_markets

Get markets

ultrade_market_balances

Get account balances

ultrade_market_order_message

Generate message from the order data

ultrade_market_create_orders

Create new orders

ultrade_market_create_order

Create new order

ultrade_market_cancel_orders

Cancel multiple open orders

ultrade_market_cancel_order

Cancel open order

ultrade_market_price

Get last market price by pair symbol

ultrade_market_depth

Get order book depth

ultrade_market_last_trades

Get last trades

ultrade_market_symbols

Get market symbols

ultrade_market_settings

Get market settings

ultrade_market_details

Get market details

ultrade_market_order_by_id

Get order by ID

ultrade_market_orders

Get orders

ultrade_market_open_orders

Get open orders

ultrade_market_history

Get market history

ultrade_market_assets

Get trading assets

ultrade_market_fee_rates

Get fee rates

ultrade_system_time

Get current system time

ultrade_system_maintenance

Get system maintenance status

ultrade_system_version

Get system version