Alpha Arena MCP
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., "@Alpha Arena MCP Show my current positions and account balance."
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.
Alpha Arena MCP
An MCP server that delivers hyperliquid account data, perpetuals market context, and trading tools for AI agents — inspired by nof1.ai and open-nof1.ai.
Overview
Alpha Arena MCP bridges AI models with the Hyperliquid perpetual futures exchange, allowing LLMs to:
Analyze real-time market data (prices, indicators, open interest).
Fetch and format account positions and performance.
Execute trades with risk-managed orders (including auto-calculated take-profit/stop-loss).
Close positions or cancel orders programmatically.
Designed for algorithmic trading bots, this server supports both mainnet and testnet operations. It uses the CCXT library for exchange interactions and pandas_ta for technical analysis.
Key Use Case: Integrate with Claude Desktop or similar MCP clients to create an AI trading assistant that generates recommendations based on prompts and executes them via tools.
Related MCP server: Hyperliquid MCP Server
Features
Trading Tools:
Place limit/market orders with leverage, TP/SL (auto-calculated if omitted).
Close all positions for a symbol (reduce-only market orders).
Cancel all open orders for a symbol.
Retrieve formatted account info (balance, positions, PnL).
Get formatted market state (OHLCV, EMAs, MACD, RSI, volume, OI, funding rate).
MCP Prompts:
System prompt for expert crypto analysis.
User prompt template incorporating market/account data for LLM invocations.
Exchange Support: Hyperliquid perpetuals (sandbox/testnet configurable).
Risk Management: Built-in TP/SL calculation based on leverage (2:1 reward:risk ratio).
Error Handling: Graceful fallbacks for API errors.
Prerequisites
Python 3.10+
uv for dependency management (recommended; fallback to pip)
A Hyperliquid account with API credentials (wallet address and private key).
Installation
Clone the Repository:
git clone https://github.com/kukapay/alpha-arena-mcp.git cd alpha-arena-mcpInstall dependencies with uv:
uv syncInstall to Claude Desktop:
Install the server as a Claude Desktop application:
uv run mcp install main.py --name "Alpha Arena"Configuration file as a reference:
{ "mcpServers": { "Alpha Arena": { "command": "uv", "args": [ "--directory", "/path/to/alpha-arena-mcp", "run", "main.py" ], "env": { "MAIN_ACCOUNT_ADDRESS": "your_main_account_address", "API_ACCOUNT_PRIVATE_KEY": "your_api_account_private_key", "NETWORK": "testnet" /* testnet | main */ } } } }Replace /path/to/alpha-arena-mcp with your actual installation path, and update your_main_account_address and your_ai_account_private_key with your own account details.
Usage
Example Workflow
Set Up Analysis (via Prompt):
Use
nof1_system_prompt()to load the expert trader persona.
Generate Recommendation (via Prompt + Data):
Use
nof1_user_prompt("BTC/USDC:USDC")→ Injects market/account data into the user prompt for LLM analysis.
Execute Trade (via Tool):
place_order(symbol="BTC/USDC:USDC", side="buy", size=0.01, leverage=10)→ Places order with auto-TP/SL.
Manage Position:
close_position("BTC/USDC:USDC")→ Closes all positions.cancel_open_orders("BTC/USDC:USDC")→ Cancels pending orders.
Available Tools
place_order
Places a limit/market order with optional TP/SL. Auto-calculates TP/SL if not provided based on leverage (2:1 reward:risk).
Parameters:
symbol(str): Trading pair, e.g., "BTC/USDC:USDC".side(str: buy/sell): Order direction.size(float): Order size (quantity).price(float, optional): Limit price (defaults to current market price).leverage(float=10): Leverage multiplier.tp_price/sl_price(float, optional): Take-profit/stop-loss prices.
Returns: Dict: Order IDs or error.
Usage Example
Prompt:
Buy 0.01 BTC with 10x leverage on Hyperliquid, using market price.
Response:
{
"status": "success",
"result": {
"main_order_id": "abc123",
"tp_order_id": "def456",
"sl_order_id": "ghi789",
"status": "success"
}
}close_position
Closes all positions for a symbol using reduce-only market orders.
Parameters:
symbol(str): Trading pair, e.g., "BTC/USDC:USDC".
Returns: Dict: Close orders or no-action message.
Usage Example
Prompt:
Close my entire BTC position now.
Response:
{
"close_orders": [
{
"order_id": "jkl012",
"side": "sell",
"size": 0.01,
"status": "closed"
}
],
"status": "success"
}cancel_open_orders
Cancels all open orders for a symbol.
Parameters:
symbol(str): Trading pair, e.g., "ETH/USDC:USDC".
Returns: Dict: Canceled orders or no-action message.
Usage Example
Prompt:
Cancel all my pending orders for ETH.
Response:
{
"canceled_orders": [
{
"id": "mno345",
"status": "canceled"
},
{
"id": "pqr678",
"status": "canceled"
}
],
"status": "success"
}account_info
Fetches and formats account balance, positions, and performance summary.
Parameters: None.
Returns: str: Formatted account summary.
Usage Example
Prompt:
What's my current account status?
Response:
Current Total Return (percent): 2.5%
Available Cash: 1500.0
Current Account Value: 1525.0
Positions: {"symbol": "BTC/USDC:USDC", "quantity": 0.01, "unrealized_pnl": 25.0, ...}market_state
Fetches and formats market data, including technical indicators, volume, open interest, and funding rate.
Parameters:
symbol(str): Trading pair, e.g., "SOL/USDC:USDC".
Returns: str: Formatted market state.
Usage Example
Prompt:
Give me the latest market data for SOL.
Response:
Current Market State:
current_price = 150.25, current_ema20 = 148.50, current_macd = 1.20, current_rsi (7 period) = 65.3
Open Interest: Latest: 100000.0 Average: 100000.0
Funding Rate: 0.0001
Intraday series (by minute, oldest → latest):
Mid prices: [145.0, 146.2, ...]
...Available Prompts
nof1_system_prompt
Expert crypto analyst system prompt.
Parameters: None
Returns: str: System message.
Example:
You are an expert cryptocurrency analyst and trader with deep knowledge of blockchain technology, market dynamics, and technical analysis.
Your role is to:
- Analyze cryptocurrency market data, including price movements, trading volumes, and market sentiment
- Evaluate technical indicators such as RSI, MACD, moving averages, and support/resistance levels
- Consider fundamental factors like project developments, adoption rates, regulatory news, and market trends
- Assess risk factors and market volatility specific to cryptocurrency markets
- Provide clear trading recommendations (BUY, SELL, or HOLD) with detailed reasoning
- Suggest entry and exit points, stop-loss levels, and position sizing when appropriate
- Stay objective and data-driven in your analysis
[... full prompt continues ...]
Today is November 01, 2025.nof1_user_prompt
Data-enriched user prompt for analysis.
Parameters: symbol (str)
Returns: str: Prompt with market/account data.
It has been 45 minutes since you started trading. The current time is 2025-11-01T10:30:00 and you've been invoked 3 times. Below, we are providing you with a variety of state data, price data, and predictive signals so you can discover alpha. Below that is your current account information, value, performance, positions, etc.
ALL OF THE PRICE OR SIGNAL DATA BELOW IS ORDERED: OLDEST → NEWEST
Timeframes note: Unless stated otherwise in a section title, intraday series are provided at 3-minute intervals. If a coin uses a different interval, it is explicitly stated in that coin's section.
# HERE IS THE CURRENT MARKET STATE
## ALL SOL DATA FOR YOU TO ANALYZE
Current Market State:
current_price = 150.25, current_ema20 = 148.50, current_macd = 1.20, current_rsi (7 period) = 65.3
[... full formatted market data ...]
----------------------------------------------------------
## HERE IS YOUR ACCOUNT INFORMATION & PERFORMANCE
Current Total Return (percent): 2.5%
Available Cash: 1500.0
Current Account Value: 1525.0
Positions: {"symbol": "BTC/USDC:USDC", "quantity": 0.01, ...}License
MIT License. See LICENSE for details.
Available Tools
5 toolsaccount_infoA
Get and format the current account information.
Returns: Formatted string with account details.
Inputs: no named parameters. Returns: result
cancel_open_ordersA
Cancel all open orders for the specified trading pair on Hyperliquid.
Args: symbol: Trading pair, e.g., "BTC/USDC:USDC"
Returns: Dict with canceled orders details or error
Inputs: symbol (required). Returns: result
close_positionA
Close all positions for the specified trading pair on Hyperliquid.
Args: symbol: Trading pair, e.g., "BTC/USDC:USDC"
Returns: Dict with close order details or error
Inputs: symbol (required). Returns: result
market_stateA
Get and format the current market state for a given symbol.
Args: symbol: Trading pair, e.g., "BTC/USDC:USDC"
Returns: Formatted string with market state details.
Inputs: symbol (required). Returns: result
place_orderA
Place an order on Hyperliquid with optional market price, and auto-calculate TP/SL if not provided.
Args: symbol: Trading pair, e.g., "BTC/USDC:USDC" side: 'buy' or 'sell' size: Order size (quantity) price: Limit price for main order (default: None, uses current market price) leverage: Leverage to set (default: 10) tp_price: Take profit price (default: None, auto-calculated) sl_price: Stop loss price (default: None, auto-calculated)
Returns: Dict with order details or error
Inputs: side (required), size (required), symbol (required), price, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct action or resource: placing orders, closing positions, canceling orders, viewing account info, and viewing market state. No overlap or ambiguity between them.
All tool names use snake_case and follow a clear pattern. Action-oriented tools use verb_noun (place_order, close_position, cancel_open_orders), while informational tools use resource_state (account_info, market_state). The naming is consistent and predictable.
Five tools is well-scoped for a trading-focused server. Each tool serves a distinct purpose and covers the core trading workflow without redundancy or bloat.
The tool set covers the essential lifecycle: placing orders, closing positions, canceling orders, and retrieving account/market information. Minor gaps exist such as no explicit get_positions or get_open_orders tools, but account_info likely covers position details and the workflow is functional.
Maintenance
Related MCP Connectors
Hyperliquid market data, wallet analytics and liquidation alerts for AI agents.
Trade Hyperliquid perps, stocks, gold, oil and pre-IPO from AI agents. Hosted; keys can't withdraw.
Build, backtest and paper-run Hyperliquid strategies from your AI assistant.
Non-custodial Hyperliquid perp trading: live markets, account state, user-armed order execution
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceEnables interaction with the Hyperliquid DEX for retrieving market data, managing positions, and executing trades. Supports both testnet and mainnet operations with comprehensive trading tools including order placement, cancellation, and portfolio management.11MIT
- AlicenseAqualityDmaintenanceEnables interaction with the Hyperliquid exchange to trade perpetuals, check positions, and manage risk through natural language. It provides tools for fetching real-time market data, tracking portfolio value, and executing orders with a focus on safety through default paper trading.101MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to securely trade on Hyperliquid perpetual exchange, including order placement, position management, market data retrieval, and vault operations via natural language.29 PyPI24MIT
- AlicenseBqualityDmaintenanceIntegrates with Hyperliquid DEX to enable trading, account management, and market data queries through natural language.123MIT