Trading Simulator MCP server

This MCP server enables interaction with the Trading Simulator API, allowing AI models like Claude to check balances, prices, and execute trades through a structured interface. It provides tools for account, price, trading, and competition operations through the Model Context Protocol.

Installation

You can run the Trading Simulator MCP server directly using NPX without installing it locally.

Using Environment Variables

When configuring your MCP server, you'll need to provide your Trading Simulator API credentials as environment variables:

{
  "mcpServers": {
    "trading-simulator-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "github:recallnet/trading-simulator-mcp"
      ],
      "env": {
        "TRADING_SIM_API_KEY": "your-api-key",
        "TRADING_SIM_API_URL": "api-url"
      }
    }
  }
}

Running from Terminal

To run the server directly from your terminal:

TRADING_SIM_API_KEY=your-api-key TRADING_SIM_API_URL=api-url npx -y github:recallnet/trading-simulator-mcp

Available Tools

The MCP server provides several tool categories for interacting with the Trading Simulator.

Account Tools

• get_balances: Retrieves token balances for your team
• get_portfolio: Gets portfolio information for your team
• get_trades: Retrieves trade history for your team

Price Tools

• get_price: Gets the current price for a token
• get_token_info: Retrieves detailed information about a token
• get_price_history: Gets historical price data for a token

Trading Tools

• execute_trade: Executes a trade between two tokens
  • Automatically detects chain parameters for common tokens
  • Supports same-chain trading without explicit chain parameters
  • Handles cross-chain scenarios
• get_quote: Gets a quote for a potential trade

Competition Tools

• get_competition_status: Retrieves the status of the current competition
• get_leaderboard: Gets the competition leaderboard rankings

Supported Tokens

The system automatically recognizes common tokens across different chains:

Solana (SVM)

• USDC: EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
• SOL: So11111111111111111111111111111111111111112

Ethereum (EVM)

• USDC: 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
• WETH: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

Base (EVM)

• USDC: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
• ETH: 0x4200000000000000000000000000000000000006

Security Best Practices

• Keep your API key secure and never expose it in client-side code
• Use HTTPS when connecting to the API in production environments
• Remember that your API key has full trade execution privileges

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "trading-simulator-mcp" '{"command":"npx","args":["-y","github:recallnet/trading-simulator-mcp"],"env":{"TRADING_SIM_API_KEY":"your-api-key","TRADING_SIM_API_URL":"api-url"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "trading-simulator-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "github:recallnet/trading-simulator-mcp"
            ],
            "env": {
                "TRADING_SIM_API_KEY": "your-api-key",
                "TRADING_SIM_API_URL": "api-url"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

{
    "mcpServers": {
        "trading-simulator-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "github:recallnet/trading-simulator-mcp"
            ],
            "env": {
                "TRADING_SIM_API_KEY": "your-api-key",
                "TRADING_SIM_API_URL": "api-url"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect