TradeX MCP Server
A Model Context Protocol server that enables AI agents to research, analyze, and trade Pokemon card perpetual futures on the TradeX platform.
npm: @tradex/mcp
Source: GitHub
Installation
Security: Use a dedicated trading wallet with only the funds you intend to trade. Your keypair never leaves your machine - all signing is done locally.
Claude Code
claude mcp add tradex -- npx -y @tradex/mcp
For trade execution, pass your keypair:
claude mcp add tradex -e TRADEX_KEYPAIR=/path/to/keypair.json -- npx -y @tradex/mcp
Omit TRADEX_KEYPAIR for read-only mode (search cards, check prices, no trading).
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Read-only mode:
{
"mcpServers": {
"tradex": {
"command": "npx",
"args": ["-y", "@tradex/mcp"]
}
}
}
With trade execution:
{
"mcpServers": {
"tradex": {
"command": "npx",
"args": ["-y", "@tradex/mcp"],
"env": {
"TRADEX_KEYPAIR": "/path/to/your/keypair.json"
}
}
}
}
Cursor
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"tradex": {
"command": "npx",
"args": ["-y", "@tradex/mcp"]
}
}
}
Environment Variables
| Variable | Description | Default |
|---|---|---|
TRADEX_KEYPAIR | Path to Solana keypair JSON | (none - read-only) |
TRADEX_API_URL | Backend API URL | https://backend.tradex.cards |
TRADEX_RPC_URL | Solana RPC URL | https://api.mainnet-beta.solana.com |
Tools
Read-Only (always available)
| Tool | Description |
|---|---|
get_market_movers | Top gainers, losers, and most volatile cards |
get_portfolio | Complete portfolio with computed PnL |
get_trading_signals | Trading signals and recommendations |
prepare_trade | Validate a trade before execution |
simulate_trade | Simulate trade with PnL scenarios |
search_cards | Search Pokemon cards by name |
get_card_details | Detailed card info with price history |
batch_get_cards | Fetch multiple cards at once |
get_tradable_products | List all tradable product IDs |
get_trading_config | Trading parameters (leverage, fees) |
Execution (require keypair)
| Tool | Description |
|---|---|
open_position | Open a long/short position |
close_position | Close an existing position |
deposit | Deposit USDC into trading account |
withdraw | Withdraw USDC from trading account |
get_wallet_status | Check wallet balance and status |
Resources
The server provides documentation resources:
tradex://docs/trading-guide- Trading guide and best practicestradex://docs/api-reference- OpenAPI specification
Example Usage
Once installed, ask Claude:
Research:
- "What are the biggest movers in Pokemon cards today?"
- "Show me trading signals for Charizard cards"
- "Simulate a $100 long position on product 517044 with 5x leverage"
Trading (with keypair):
- "Check my wallet status"
- "Deposit $50 USDC into my trading account"
- "Open a $20 long position on Charizard with 3x leverage"
- "Close my position on product 517044"
Security
- Private keys are stored locally and never transmitted
- Transactions are signed locally using
@solana/web3.js - All trades are validated before execution
- Transaction parameters fetched from the TradeX backend
API Endpoints
The MCP server connects to:
| Resource | URL |
|---|---|
| Backend API | https://backend.tradex.cards |
| API Documentation | https://tradex.cards/docs |
| OpenAPI Spec | https://backend.tradex.cards/api/docs/json |
| Trading Guide | https://tradex.cards/SKILL.md |
Development
# Install dependencies
bun install
# Build
bun run build
# Run locally
bun run dev
License
Business Source License 1.1 (BUSL-1.1), non-commercial use only. Automatically changes to GNU GPLv3 on 2030-02-18.