[](https://smithery.ai/server/@ultrade-org/ultrade-mcp)
# Ultrade MCP Server
A standalone MCP server implementation for Ultrade tools. This server provides a set of tools to interact with the Ultrade API, allowing users to manage wallets, markets, and system information.
## System Status
- Version: 2.0.54
- Maintenance Mode: 0 (System Operational)
## Project Structure
```
ultrade-mcp/
├── src/
│ ├── tools/
│ │ ├── utils/
│ │ │ └── responseProcessor.ts
│ │ ├── index.ts
│ │ ├── market.ts
│ │ ├── system.ts
│ │ └── wallet.ts
│ ├── env.ts
│ └── index.ts
├── .env
├── .env.example
├── Dockerfile
├── package.json
├── package-lock.json
├── README.md
├── smithery.yaml
└── tsconfig.json
```
## Installation
To install or update the Algorand MCP implementation, clone the repository, install the dependencies and build the project":
First check node version to be 23.6.1 or later:
```bash
node -v
```
Upgrade to 23.6.1 or later if needed!
Then check the Claude or Cursor container folders to have mcp-servers folder (if not create one):
```bash
mkdir PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
mkdir PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
```
Then clone this repository under mcp-servers folder and install dependencies:
```bash
cd PATH_ON_YOUR_MACHINE/Claude/mcp-servers
# or for Cursor
cd PATH_ON_YOUR_MACHINE/Cursor/mcp-servers
# Clone the repository
git clone https://github.com/ultrade-org/ultrade-mcp.git
cd ultrade-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Edit the .env file to set your configurations
```
And you are done! Now you can open you MCP config and add the server as :
```json
{
"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 yopu change the paths to match your local system's paths.
For example on MACOS and Claud, the path would be something like this:
```json
{
"mcpServers": {
"ultrade-mcp": {
"command": "node",
"args": [
" /Users/YOUR_USERNAME/Library/Application\ Support/Claude/mcp-servers/ultrade-mcp/dist/index.js"
]
}
}
}
```
## Available Tools
### Wallet 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
### Market Tools
- `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
### System Tools
- `ultrade_system_time`: Get current system time
- `ultrade_system_maintenance`: Get system maintenance status
- `ultrade_system_version`: Get system version
## Development
To run in development mode with hot reloading:
```bash
npm run dev
```
## License
MIT License
Built with ❤️ by @GoPlausible (@emg110).
