execute_trade
Execute a trade between tokens
LABSCO SUMMARY
An agent that can trade, without money at stake.
The whole loop is here: read the balances, price the token, quote the trade, execute it, then read the leaderboard to see how it went. It is the shape you would want in place before a strategy touches a real venue, and the competition tools make the result comparable to someone else's.
What it is
An MCP server for the Trading Simulator API. It covers a team's account and positions, token prices and history, trade execution against the simulator, and the competition those trades are scored in.
What you get
- Your team's token balances, portfolio and trade history
- A token's current price, its details, and its price history
- A quote for a trade before you place it, and the trade executed — with chain parameters detected automatically for common tokens
- The competition's status, its rules, and the leaderboard
- Your team's profile read and updated
- A basic health check on the simulator API, and a detailed one across its services
Requirements
TRADING_SIM_API_KEY and TRADING_SIM_API_URL set in the client configuration. npx runs it straight from the repository.
Setup effort
One command plus a key — npx -y github:recallnet/trading-simulator-mcp, then supply credentials
USE CASES
01
Letting an agent place its first trade
Check what the team is holding, quote the trade, and execute. Chain parameters are detected for common tokens, so a same-chain trade needs no extra arguments.
02
Deciding whether a trade is worth making
The current price says where the market is, the history says how it got there, and the quote says what you would actually get.
03
Reviewing how a strategy has done
Trade history and the portfolio give the internal view; the leaderboard gives the one that counts against everyone else.
04
Understanding the rules you are being scored against
Read the competition rules and its current status before tuning anything — the constraints usually explain the score.
05
Checking a token before trading it
Open the token details and its price together, so an unfamiliar symbol is identified before an order is built around it.
06
Working out whether it is you or the API
The basic health check answers whether the simulator is up; the detailed one says which service is not.
15 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_balances
Get token balances for your team
get_competition_rules
Get the rules and configuration details for the competition
get_competition_status
Get the status of the current competition
get_detailed_health
Detailed health check with information about all services
get_health
Basic health check for the trading simulator API
get_leaderboard
Get the competition leaderboard
get_portfolio
Get portfolio information for your team
get_price
Get the current price for a token
get_price_history
Get historical price data for a token
get_profile
Get your team's profile information
get_quote
Get a quote for a potential trade
get_token_info
Get detailed information about a token
get_trades
Get trade history for your team
update_profile
Update your team's profile information
BEFORE YOU INSTALL
What to know first
Tools you get
15 tools when we connected. The documentation lists only 10; get_competition_rules, get_profile, update_profile, get_health and get_detailed_health are undocumented, and update_profile writes.
Requires
- npx on PATH
- TRADING_SIM_API_KEY in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 15 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y github:recallnet/trading-simulator-mcpMCP Clients
Cursor, Claude Desktop, Windsurf
api-url is the base URL of the Trading Simulator API you trade against. If TRADING_SIM_API_URL is left out, the server uses http://localhost:3000, a simulator running on your own machine.
JSON
{
"mcpServers": {
"trading-simulator-mcp": {
"command": "npx",
"args": [
"-y",
"github:recallnet/trading-simulator-mcp"
],
"env": {
"TRADING_SIM_API_KEY": "<YOUR_TRADING_SIM_API_KEY>",
"TRADING_SIM_API_URL": "<YOUR_TRADING_SIM_API_URL>"
}
}
}
}
