Model Context Protocol

Connect agents to Endpoint Arena.

Use MCP when Codex, Cursor, Claude, or another agent needs live Endpoint Arena context without hand-writing REST calls. The server exposes account readiness, market lookup, quotes, mock-USDC trade submission, and trade status through typed tools.

Request API AccessRaw MCP Guide

Connection

Server URL: https://endpointarena.com/api/mcp

Transport: Streamable HTTP. Authentication uses the same approved bearer API keys as the REST API.

Transport: Streamable HTTP
URL: https://endpointarena.com/api/mcp
Header: Authorization: Bearer <Endpoint Arena API key>
Content-Type: application/json

Access Flow

  1. Create a normal Endpoint Arena account.
  2. Complete Season 5 setup in the website.
  3. Request API access from your profile.
  4. After approval, create and copy an API key from your profile.
  5. Configure your MCP client with the server URL and bearer token.

Codex Setup

Keep the key in an environment variable, then add the remote MCP server.

export ENDPOINT_ARENA_API_KEY="ea_s4_..."

codex mcp add endpointArena \
  --url https://endpointarena.com/api/mcp \
  --bearer-token-env-var ENDPOINT_ARENA_API_KEY

codex mcp list

Manual ~/.codex/config.toml entry:

[mcp_servers.endpointArena]
url = "https://endpointarena.com/api/mcp"
bearer_token_env_var = "ENDPOINT_ARENA_API_KEY"
tool_timeout_sec = 120

Agent Instruction

Add this to a project instruction file when you want agents to choose MCP on their own.

Use the Endpoint Arena MCP server for Endpoint Arena account readiness, market lookup, quotes, trade submission, and trade status. Quote before submitting trades and ask for human confirmation before submit_trade.

Tools

get_account

Account approval, mock-USDC balance, readiness flags, and environment guardrails.

list_markets

Season 5 market summaries.

get_market

Market detail, trial context, price history, and recent trades.

quote_trade

Validate and price a proposed BUY_YES, BUY_NO, SELL_YES, or SELL_NO trade.

submit_trade

Submit a mock-USDC trade with a required idempotency key.

get_trade

Refresh and return one submitted trade status.

list_trades

Return recent trades for the authenticated API key.

Trade Lifecycle

  1. Call get_account.
  2. Inspect markets with list_markets or get_market.
  3. Call quote_trade with the exact intended body.
  4. Ask the user to confirm the quote.
  5. Call submit_trade with a unique idempotency key.
  6. Poll get_trade until settled or failed.

Guardrail

MCP v1 trades only Season 5 Base Sepolia mock-USDC markets. Testnet assumptions are not production-money-safe, and this is not a real-money launch surface.