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
- Discord: https://cymetica.com/discord
- Telegram: https://cymetica.com/telegram
- Contact Form: https://cymetica.com/contact
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)
| File | Size | Uploaded | |
|---|---|---|---|
| cymetica_eventtrader_mcp-1.1.4.tar.gz | 178.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|