MODEL CONTEXT PROTOCOL
Arena MCP Tools
AI agent integration for the CyMetica-42 Arena. 7 tools for reading market state, orderbooks, epochs, and placing trades — all via the Model Context Protocol.
Discovery
All Arena MCP tools are discoverable at the standard /.well-known/mcp endpoint.
# Discover all available MCP tools
curl https://cymetica.com/.well-known/mcp
# Direct tool invocation
curl https://cymetica.com/mcp/tools/arena/state
curl https://cymetica.com/mcp/tools/arena/orderbook/BLUE?levels=10MCP Tools (7)
get_arena_state
PUBLIC
Get Arena market state — teams, NAVs, epoch, scoreboard
Input Schema
No parameters required.
Response Fields
arenaobjectArena market configuration
marketobjectWTA market details
current_epochobjectActive epoch number, start/end times
blue_teamobjectname, nav, epoch_pnl_pct, cumulative_pnl_pct, epoch_wins
red_teamobjectname, nav, epoch_pnl_pct, cumulative_pnl_pct, epoch_wins
# Example
curl https://cymetica.com/mcp/tools/arena/state
# Response
{
"blue_team": {"name": "Blue Team", "nav": 103.42, "epoch_pnl_pct": 1.23, "epoch_wins": 5},
"red_team": {"name": "Red Team", "nav": 98.71, "epoch_pnl_pct": -0.87, "epoch_wins": 3},
"current_epoch": {"epoch_number": 8, "end_time": "2026-04-04T12:00:00Z"}
}
get_arena_teams
PUBLIC
Get team details and portfolio composition
Response Fields
blue.portfolioobjectAsset symbols and weights for Blue Team
red.portfolioobjectAsset symbols and weights for Red Team
*.navfloatCurrent net asset value
*.epoch_winsintTotal epochs won
curl https://cymetica.com/mcp/tools/arena/teams
get_arena_orderbook
PUBLIC
Get orderbook depth for BLUE or RED team
Input Schema
team_symbolstring
BLUE or RED (required)levelsintMinimum price levels to return (default: 30, max: 1000)
Response Fields
bidsarrayBid levels: [{price, size, orders}]
asksarrayAsk levels: [{price, size, orders}]
best_bidstringBest bid price
best_askstringBest ask price
spreadstringCurrent spread
curl https://cymetica.com/mcp/tools/arena/orderbook/BLUE?levels=10
get_arena_epoch
PUBLIC
Get current epoch info with countdown
Response Fields
epoch.epoch_numberintCurrent epoch number
epoch.start_timeISO 8601Epoch start (UTC)
epoch.end_timeISO 8601Epoch end (UTC)
epoch.total_poolfloatTotal USDC in the pool
epoch.resolvedboolWhether epoch has been resolved
curl https://cymetica.com/mcp/tools/arena/epoch
get_arena_history
PUBLIC
Get epoch history with winners
Input Schema
limitintMax epochs to return (default: 20, max: 100)
Response Fields
epochs[]arrayResolved epochs with winning_symbol, winning_pct_gain, total_pool
curl https://cymetica.com/mcp/tools/arena/history?limit=5
get_arena_positions
AUTH
Get user's Arena positions
Authentication
Requires Bearer token via Authorization header or API key.
Response Fields
positions[]arrayteam_symbol, shares, avg_entry_price, realized_pnl, is_live
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://cymetica.com/mcp/tools/arena/positions
place_arena_order
AUTH
Place order on BLUE/RED orderbook
Input Schema
team_symbolstring
BLUE or RED (required)sidestring
buy or sell (required)pricefloat$0.01 – $1.00 (required)
sizefloatOrder size in dollars (required)
order_typestring
limit (default) or marketpost_onlyboolReject if would cross book (default: false)
idempotency_keystringClient-generated unique key (max 64 chars)
Response Fields
order_idstringUUID of the order
statusstringfilled, partial, resting, rejected
fillsarray[{price, size, fee, fill_type}]
remainingfloatUnfilled size remaining
modestring
paper or live# Place a limit buy on BLUE at $0.55
curl -X POST https://cymetica.com/mcp/tools/arena/order \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"team_symbol":"BLUE","side":"buy","price":0.55,"size":10}'Paper vs Live Mode
MCP tools respect the user's simulation_mode setting. Mode is determined server-side per user account — not per request.
Paper Mode (Default)
Tracks positions and P&L without real funds. All new accounts start in paper mode. Positions are tagged is_live: false and cannot trigger USDC settlement.
Live Mode
Real USDC debited/credited via internal ledger. Requires verified balance before order acceptance. Epoch loss limit: $500/epoch. Position is_live flag is locked at creation — prevents paper-to-live exploit.
Integration Examples
Claude Desktop
{
"mcpServers": {
"eventtrader-arena": {
"url": "https://cymetica.com/.well-known/mcp",
"transport": "streamable-http"
}
}
}Cursor
{
"mcp": {
"servers": {
"eventtrader-arena": {
"url": "https://cymetica.com/.well-known/mcp"
}
}
}
}Direct HTTP
# List all tools
curl https://cymetica.com/.well-known/mcp
# Call a tool directly
curl https://cymetica.com/mcp/tools/arena/state
# Authenticated tool call
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://cymetica.com/mcp/tools/arena/positions