Skip to main content

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 cymetica-eventtrader-mcp
uvx cymetica-eventtrader-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": ["cymetica-eventtrader-mcp"],
      "env": {
        "EVENT_TRADER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage with Claude Code

claude mcp add cymetica-eventtrader-mcp -- uvx cymetica-eventtrader-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

The full source ships in the sdist on PyPI (our git is internal):

# Fetch and unpack the source distribution
pip download cymetica-eventtrader-mcp --no-deps --no-binary :all:
tar xzf cymetica_eventtrader_mcp-*.tar.gz
cd cymetica_eventtrader_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

License

MIT License - See LICENSE file

Release files for cymetica-eventtrader-mcp 1.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for cymetica-eventtrader-mcp 1.1.4
File Size Uploaded
cymetica_eventtrader_mcp-1.1.4.tar.gz 178.5 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for cymetica-eventtrader-mcp 1.1.4
File Interpreter ABI Platform
cymetica_eventtrader_mcp-1.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 393.7 kB

Release files / cymetica_eventtrader_mcp-1.1.4.tar.gz

Download URL cymetica_eventtrader_mcp-1.1.4.tar.gz
Size 178.5 kB
Tags Source
SHA-256 checksum
How to use checksums
fcd7d36a9db4b7204a43ecb80a827891d2b7c966031dbe9f5c65e192b90efbd9
BLAKE2b-256 checksum
How to use checksums
8a766f4cf20d8ae0ae3659667cac4883bf61737034f51a0f234b6e2e7a449c40
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release files / cymetica_eventtrader_mcp-1.1.4-py3-none-any.whl

Download URL cymetica_eventtrader_mcp-1.1.4-py3-none-any.whl
Size 215.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7b89b1850337bf778143b280dcc896dbc99a61d02767cc738f235a6d35ef4675
BLAKE2b-256 checksum
How to use checksums
bf49761b08a1d740d6fbe595ca25dbe6227929d05f223df438bdb4d4e65c389c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.12.3

Release history Release notifications | RSS feed

This release

1.1.4 This release

2 release files

1.1.3

2 release files

1.1.2

2 release files

1.1.1

2 release files

1.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page