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