Metadata-Version: 2.4
Name: cymetica-eventtrader-mcp
Version: 1.1.1
Summary: MCP Server for the EventTrader prediction markets platform - real-time market data for AI systems (import name: event_trader_mcp)
Project-URL: Homepage, https://cymetica.com
Project-URL: Documentation, https://cymetica.com/api-docs
Author-email: Event Trader <dev@cymetica.com>
License-Expression: MIT
License-File: LICENSE
Keywords: ai,chatgpt,claude,llm,mcp,prediction-markets,trading
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: python-dotenv>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.23.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# Event Trader MCP Server

<!-- mcp-name: io.github.eventtrader/event-trader-mcp -->

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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

```bash
pip install cymetica-eventtrader-mcp
```

### Via uvx (recommended)

```bash
uvx cymetica-eventtrader-mcp
```

## Configuration

Set your API key:

```bash
export EVENT_TRADER_API_KEY=your_api_key_here
```

Optional:

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

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

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

## Usage with Claude Code

```bash
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):

```bash
# 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
