Trading Simulator MCP Server logo

Trading Simulator MCP Server

by recallnet

The Trading Simulator MCP Server is an MCP server designed to interface with the Trading Simulator API, allowing AI models to interact with the simulator. It provides a structured interface for checking balances, prices, and executing trades.

View on GitHub

Last updated: N/A

What is Trading Simulator MCP Server?

This server is an MCP (Model Context Protocol) server that acts as a bridge between AI models and the Trading Simulator API. It allows AI agents to programmatically interact with the trading simulator to check account status, get price information, and execute trades using structured tool calls.

How to use Trading Simulator MCP Server?

To use this server, configure your MCP environment (like Cursor/Claude/Windsurf) with the provided JSON configuration, ensuring you set the TRADING_SIM_API_KEY and TRADING_SIM_API_URL environment variables. You can then run the server using npx with the necessary environment variables set. The server exposes MCP tools that AI models can call to perform actions within the trading simulator.

Key features of Trading Simulator MCP Server

  • Provides account, price, and trading operations via MCP tool calls.

  • Supports execution of trades between tokens.

  • Includes smart token detection for automatic chain parameter handling.

  • Offers competition operations to check status and view leaderboard rankings.

Use cases of Trading Simulator MCP Server

  • Allowing AI models to automate trading strategies within a simulated environment.

  • Enabling AI agents to learn and optimize trading algorithms without risking real capital.

  • Providing a platform for testing and evaluating different trading models.

  • Facilitating AI-driven participation in trading competitions.

FAQ from Trading Simulator MCP Server

How do I configure the server?

Configure the MCP servers JSON file for your designated consuming environment by adding this MCP using the provided JSON format, ensuring you set the TRADING_SIM_API_KEY and TRADING_SIM_API_URL environment variables.

What API key do I use?

You need to obtain an API key from the Trading Simulator service and set it as the TRADING_SIM_API_KEY environment variable.

How does the server handle different blockchains?

The server includes a COMMON_TOKENS structure that maps token addresses to their respective chains, enabling automatic detection of chain parameters when executing trades. You can extend this structure to add more tokens.

What security measures should I take?

Keep your API key secure, use HTTPS when connecting to the API, and protect the API key as it has full access to execute trades.

How do I add more common tokens?

You can extend the COMMON_TOKENS object in the types.ts file to add more common tokens and their corresponding chain information.