cymetica-eventtrader-mcp 1.1.0

MCP Server for the EventTrader prediction markets platform - real-time market data for AI systems (import name: event_trader_mcp)

Event Trader MCP Server

A Model Context Protocol (MCP) server that provides prediction market data to AI systems like Claude, ChatGPT, and Gemini.

Features

• 20+ Tools for querying markets, prices, and analytics
• 4 Resources for structured data access
• 4 Prompts for pre-built analysis workflows
• Real-time market data from Event Trader
• Semantic market search
• Plain English market summaries

Installation

Via pip

pip install event-trader-mcp

Via uvx (recommended)

uvx event-trader-mcp

Configuration

Set your API key:

export EVENT_TRADER_API_KEY=your_api_key_here

Optional:

export EVENT_TRADER_API_URL=https://cymetica.com  # Default

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "event-trader": {
      "command": "uvx",
      "args": ["event-trader-mcp"],
      "env": {
        "EVENT_TRADER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with Claude Code

claude mcp add event-trader-mcp

Available Tools

Tool	Description
get_markets	List prediction markets (filter by status)
get_market	Get market details by contract address
get_featured_market	Get the current featured market
get_orderbook	Get bids/asks for a market
get_trades	Get recent trades for a market
search_markets	Search markets by keyword
get_price	Get current asset price
get_prices	Get multiple asset prices
get_leaderboard	Get top traders
get_market_summary	Get AI-friendly market analysis
get_trending_markets	Get markets by volume
et_clob_list_pairs	List all CLOB trading pairs
et_clob_markets	All markets with live stats
et_clob_orderbook	Hybrid orderbook (CLOB + AMM)
et_clob_book	CLOB-only orderbook
et_clob_bbo	Best bid and offer
et_clob_recent_trades	Recent trades
et_clob_stats	Token statistics
et_clob_chart	OHLC candle data
et_clob_venues	Liquidity by venue
et_clob_place_order	Place a limit/market order
et_clob_cancel_order	Cancel an open order
et_clob_cancel_all_orders	Cancel all open orders
et_clob_open_orders	Get open orders
et_clob_my_trades	User's trade history
et_clob_balance	Exchange balance
et_clob_withdraw	Withdraw tokens
et_clob_place_twap	Place a TWAP order
et_clob_cancel_twap	Cancel a TWAP order
et_clob_active_twaps	Active TWAP orders
et_clob_place_scale	Place a scale order

Available Resources

URI	Description
markets://list	All active markets
markets://{address}	Single market details
docs://api	API documentation
docs://getting-started	Getting started guide

Available Prompts

Prompt	Description
analyze_market	Deep market analysis
compare_markets	Compare two markets
find_opportunities	Find trading opportunities
explain_probability	Plain English probability explanation

Example Usage

Once connected, you can ask Claude:

• "What prediction markets are currently active?"
• "Analyze the featured market on Event Trader"
• "What's the current price of Bitcoin?"
• "Find trading opportunities with wide spreads"
• "Explain the probabilities in market 0x123..."
• "What trading pairs are available on the exchange?"
• "Show me the VAIX/USDC orderbook"
• "Place a limit buy order for 1000 VAIX at $0.003"

Development

# Clone the repo
git clone https://github.com/cymetica/event-trader-mcp
cd event-trader-mcp

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run the server locally
python -m event_trader_mcp

API Key

Get your API key at https://cymetica.com/api-docs

Support

• Discord: https://cymetica.com/discord
• Telegram: https://cymetica.com/telegram
• Contact Form: https://cymetica.com/contact

License

MIT License - See LICENSE file