# EventTrader Connector Kit

This kit is the drop-in asset bundle for listing **EventTrader by CyMetica**
in AI assistant / agent connector directories (Claude, ChatGPT, Microsoft
365 Copilot, Cursor, Gemini CLI, Docker MCP Catalog, Cline, and others). It
contains icons, screenshots, and ready-to-submit manifests.

## What this is

EventTrader is an AI-native prediction-market and index-fund exchange. The
MCP server exposes market data, index-fund research, order-book/trade
tooling and (for the full profile) order placement and portfolio actions
over the Model Context Protocol.

Two MCP endpoints are published from the same server:

| Endpoint | Server name | Use for |
|---|---|---|
| `https://cymetica.com/mcp/v1` | `eventtrader-mcp` | Developer-tool directories that allow trade execution: Cursor, Cline, Gemini CLI, Docker MCP Catalog, Claude Code. 71 tools without authentication; keyed callers get 99. |
| `https://cymetica.com/mcp/v1/research` | `eventtrader-research` | Directories that ban trade execution: Claude, ChatGPT, Microsoft Copilot. Read-only tools only — no order placement, no withdrawals. |

Transport: streamable HTTP, JSON-RPC 2.0, protocol `2025-03-26`.

## Authentication

Two supported methods — no authentication is required to use the 71 public
(unauthenticated) tools:

1. **OAuth 2.1 with dynamic client registration.** Authorization server
   metadata: `https://cymetica.com/.well-known/oauth-authorization-server`.
   Scopes: `read`, `portfolio`, `trade`.
2. **Account API key**, sent as either `Authorization: Bearer <key>` or
   `X-API-Key: <key>`. Generate a key from
   `https://cymetica.com/account#apiKeysCard`.

Keyed callers get access to the full 99-tool set.

## Quick-connect snippets

### Claude (custom connector)

In Claude, go to **Settings → Connectors → Add custom connector** and enter:

```
https://cymetica.com/mcp/v1/research
```

(Claude's directory policy prohibits connectors that execute financial
transactions — use the read-only research URL above for any Claude
submission.)

### ChatGPT (developer mode connector)

In ChatGPT, enable Developer Mode, then **Settings → Connectors → Create →
Custom connector** and enter:

```
https://cymetica.com/mcp/v1/research
```

### Cursor (`.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "eventtrader": {
      "url": "https://cymetica.com/mcp/v1"
    }
  }
}
```

### Claude Code

```
claude mcp add --transport http eventtrader https://cymetica.com/mcp/v1
```

### Gemini CLI (`settings.json`)

```json
{
  "mcpServers": {
    "eventtrader": {
      "httpUrl": "https://cymetica.com/mcp/v1"
    }
  }
}
```

### OpenClaw / Meta Muse / Grok / Mistral Le Chat (custom connector URL)

Add a custom MCP connector pointing at:

```
https://cymetica.com/mcp/v1
```

(use `https://cymetica.com/mcp/v1/research` instead if the assistant's
policy bans trade-execution tools).

### stdio alternative (PyPI)

For assistants that only support local stdio MCP servers:

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

Set the environment variable `EVENT_TRADER_API_KEY` to an account API key
from `https://cymetica.com/account#apiKeysCard`.

## Example prompts

- "Show me the top-performing AI index funds this week"
- "What is the ET10 index price and 24-h change?"
- "Explain the M&A ripple positions in the latest analyst report"
- "Buy $20 of the AIB-SPACE fund" (full trading profile only —
  `https://cymetica.com/mcp/v1`)

## Links

- Homepage: `https://cymetica.com`
- Docs: `https://cymetica.com/api-docs`
- Build / connect page: `https://cymetica.com/build`
- Privacy Policy: `https://cymetica.com/privacy`
- Terms: `https://cymetica.com/terms`
- Support: `contact@cymetica.com`
- `llms.txt`: `https://cymetica.com/llms.txt`
- Agent skill: `https://cymetica.com/.well-known/skills/default/SKILL.md`
- Official MCP Registry: `com.cymetica/event-trader-mcp`
- PyPI (stdio alternative): `cymetica-eventtrader-mcp`

## Privacy Policy

This section summarizes how EventTrader's MCP connector handles data. The
full policy is at `https://cymetica.com/privacy`.

**What we collect:**

- **Account data the user creates.** When a user registers and connects
  via OAuth or an API key, we associate MCP requests with that account
  (user profile, portfolio, order history) so the connector can answer
  "what's in my portfolio" / "what are my open orders" and place trades on
  the user's behalf when authorized.
- **API usage logs.** Standard request metadata (endpoint called, tool
  name, timestamp, response status) is logged for reliability, abuse
  prevention, and rate limiting.

**What we do not collect:**

- We do not log or store the assistant's conversation content. The MCP
  server only sees the individual tool-call arguments and responses it is
  sent — not the surrounding chat.

**Retention:** Account data is retained for as long as the account is
active, consistent with `https://cymetica.com/privacy`. Usage logs are
retained for a limited operational window for abuse prevention and
debugging.

**Contact:** Questions about data handling: `contact@cymetica.com`. Full
policy: `https://cymetica.com/privacy`. Terms of service:
`https://cymetica.com/terms`.

## License

MIT — see `LICENSE`.