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 practices
• tradex://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.

mcp