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

Metadata

Release files for cymetica-eventtrader-mcp 1.1.5

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.5
File Size Uploaded Provenance Actions
cymetica_eventtrader_mcp-1.1.5.tar.gz 178.5 kB Without provenance Details for cymetica_eventtrader_mcp-1.1.5.tar.gz

Built distribution (wheel)

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

Total release size: 393.8 kB

Release files / cymetica_eventtrader_mcp-1.1.5.tar.gz

Download URL cymetica_eventtrader_mcp-1.1.5.tar.gz
Size 178.5 kB
Tags Source
SHA-256 checksum
How to use checksums
102b548c166812bcc73fbd24a0020063de2f17596176096952d175ea76b9edc8
BLAKE2b-256 checksum
How to use checksums
dbb471e3cc825ae05b8ab81fde520e2dcb22d42b7b1d74d86b021a63b4ac23eb
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.5-py3-none-any.whl

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

Security for cymetica-eventtrader-mcp 1.1.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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