Skip to main content

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

Project description

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

Via uvx (recommended)

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cymetica_eventtrader_mcp-1.1.1.tar.gz (174.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

cymetica_eventtrader_mcp-1.1.1-py3-none-any.whl (211.3 kB view details)

Uploaded Python 3

File details

Details for the file cymetica_eventtrader_mcp-1.1.1.tar.gz.

File metadata

  • Download URL: cymetica_eventtrader_mcp-1.1.1.tar.gz
  • Upload date:
  • Size: 174.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for cymetica_eventtrader_mcp-1.1.1.tar.gz
Algorithm Hash digest
SHA256 c84eab8a523800babe507aae130f401dcef3d5ce54b794add4a1b98f9129c7b1
MD5 71f447e67cfbf889c5394108f7d3182a
BLAKE2b-256 8f045123934a2045a7ba29a16371c816130d94c11482e04afb2ecc19de96628d

See more details on using hashes here.

File details

Details for the file cymetica_eventtrader_mcp-1.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for cymetica_eventtrader_mcp-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 0308ee6aa252c406c62268ab989222b585f3b41cbd703de7cd3a11e70be9eec4
MD5 982e662fa713a076e30a7d1fefe7d627
BLAKE2b-256 e02342db41bec542bd1d6302f08cdc91ccfb8514e4042812d0e037dfe458540d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page