Quick Start

Claude Code

claude mcp add context-markets -- npx context-markets-mcp

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "context-markets": {
      "command": "npx",
      "args": ["context-markets-mcp"]
    }
  }
}

No environment variables needed — the server walks you through setup on first use.

Getting Started

The first time you (or your agent) use a trading tool, the server will guide you through onboarding:

1. Wallet — context_generate_wallet creates a new wallet or imports an existing private key
2. Save credentials — persists to ~/.config/context/config.env (chmod 600, shared with the CLI)
3. API key — pass your Context API key (get one at context.markets) via the apiKey param
4. Approve contracts — context_account_setup approves on-chain (requires ETH on Base for gas)
5. Deposit USDC — context_deposit deposits USDC into the exchange

If anything fails (no ETH, rate limit, etc.), you can re-run the same tool — it detects your existing config and picks up where you left off.

Manual setup

If you prefer to configure manually:

# Option 1: Environment variables
export CONTEXT_API_KEY="your-api-key"
export CONTEXT_PRIVATE_KEY="0x..."

# Option 2: Config file (created by context_generate_wallet or `context setup` in the CLI)
# ~/.config/context/config.env

Credentials are loaded in order: env vars > config file.

Need an API key? Visit context.markets.

Available Tools

Read-only (no wallet needed)

| Tool | Description | Key Params | |------|-------------|------------| | context_list_markets | List and search prediction markets on Context Markets | query, status, category, sortBy, limit | | context_get_market | Get detailed information about a specific prediction market | marketId | | context_get_quotes | Get current bid/ask/last prices for a market's YES and NO outcomes | marketId | | context_get_orderbook | Get the orderbook (bid/ask ladder) for a market | marketId, depth | | context_simulate_trade | Simulate a trade to estimate fill price, cost, and slippage | marketId, side, amount | | context_price_history | Get historical price data for a market over a specified timeframe | marketId, timeframe | | context_get_oracle | Get the AI oracle's resolution analysis for a market | marketId | | context_global_activity | Get recent trading activity across all markets | -- |

Account setup and funding

| Tool | Description | Key Params | |------|-------------|------------| | context_generate_wallet | Generate a new wallet or import an existing key | privateKey, apiKey, overwrite | | context_wallet_status | Get address, balances, and approval status | -- | | context_account_setup | Approve USDC spending and operator permissions | -- | | context_deposit | Deposit USDC into the exchange | amount | | context_withdraw | Withdraw USDC from the exchange back to your wallet | amount | | context_mint_test_usdc | Mint test USDC on Base Sepolia | amount |

Trading and orders

| Tool | Description | Key Params | |------|-------------|------------| | context_place_order | Place a buy or sell order on a prediction market | marketId, outcome, side, size, price | | context_cancel_order | Cancel an open order | nonce | | context_cancel_replace_order | Atomically cancel an existing order and place a new one | cancelNonce, marketId, outcome, side, priceCents, size | | context_my_orders | List your open orders | marketId | | context_bulk_create_orders | Create multiple orders in a single atomic batch | orders | | context_bulk_cancel_orders | Cancel multiple open orders in a single batch | nonces | | context_bulk_orders | Atomically create and cancel orders in a single batch | creates, cancelNonces |

Portfolio

| Tool | Description | Key Params | |------|-------------|------------| | context_get_portfolio | Get positions with P&L | kind | | context_get_balance | Get USDC balance and token holdings | -- |

Market creation

| Tool | Description | Key Params | |------|-------------|------------| | context_create_market | Create a market from a question | question | | context_agent_submit_market | Submit a fully formed market draft, wait for oracle approval, and create it on-chain | formattedQuestion, shortQuestion, marketType, evidenceMode, resolutionCriteria, endTime |

Key Concepts

• Prices are in cents (1–99). A price of 65 means $0.65 per share.
• Outcomes are yes or no. Each market is a binary question.
• Read-only tools work with zero config. Trading tools need a wallet — run context_generate_wallet first.
• Shared config. The MCP server and CLI share ~/.config/context/config.env, so you only set up once.

Documentation

• Tool Catalog — full list of tools with parameters and examples
• MCP Guide — setup, configuration, and usage patterns

Ecosystem

| Package | Description | |---------|-------------| | context-markets | TypeScript SDK for trading | | context-markets-react | React hooks for market data and trading | | context-markets-mcp | MCP server for AI agents | | context-markets-cli | CLI for trading from the terminal | | context-skills | AI agent skill files | | context-plugin | Claude Code plugin |

License

MIT — see LICENSE for details.