PokePerps MCP Server

A Model Context Protocol server that enables AI agents to research, analyze, and trade Pokemon card perpetual futures on the PokePerps platform.

npm: @pokeperps/mcp
Source: GitHub

Installation

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

Read-only mode:

{
  "mcpServers": {
    "pokeperps": {
      "command": "npx",
      "args": ["@pokeperps/mcp"]
    }
  }
}

With trade execution:

{
  "mcpServers": {
    "pokeperps": {
      "command": "npx",
      "args": ["@pokeperps/mcp"],
      "env": {
        "POKEPERPS_KEYPAIR": "/path/to/your/keypair.json"
      }
    }
  }
}

Claude Code

Add to your project config (.claude/config.json):

{
  "mcp": {
    "pokeperps": {
      "command": "npx",
      "args": ["@pokeperps/mcp"]
    }
  }
}

Environment Variables

| Variable | Description | Default | | ------------------- | --------------------------- | ------------------------------------- | | POKEPERPS_KEYPAIR | Path to Solana keypair JSON | (none - read-only) | | POKEPERPS_API_URL | Backend API URL | https://backend.pokeperps.fun | | POKEPERPS_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:

• pokeperps://docs/trading-guide - Trading guide and best practices
• pokeperps://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 PokePerps backend

API Endpoints

The MCP server connects to:

| Resource | URL | | ----------------- | ------------------------------------------- | | Backend API | https://backend.pokeperps.fun | | API Documentation | https://pokeperps.fun/docs | | OpenAPI Spec | https://backend.pokeperps.fun/api/docs/json | | Trading Guide | https://pokeperps.fun/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.