# MagicMarkets

An MCP server that puts live sports prediction market prices, quotes, orders and positions inside your agent session.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: magicmarkets
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/magicmarkets/magicmarkets-cli
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/magicmarkets

## What it does

MagicMarkets exposes the v2 prediction market API to an agent. Through MCP tools you can list events that carry prices, pull a quote for a selection, place and manage orders, and check your balance and open positions. The same API ships as a CLI too: one static binary, one API key, no request signing and no private keys.

Every bet takes two steps. A betslip registers interest in a single selection and returns a live quote; it costs nothing. An order then commits a stake against that quote. Betslips expire quickly and hold no price at creation, since the quote arrives asynchronously over the WebSocket — that is what `--wait` is for.

You need an API key from the settings page on magicmarkets.com, shown once when you create it. Store it in `~/.magicmarkets/.env` as `MAGICMARKETS_API_KEY`. Run `magicmarkets status` first: a bad key makes the WebSocket fail at the handshake with no useful message. Placing bets through the stdio MCP mode also needs `MAGICMARKETS_ALLOW_TRADING`, which does nothing on the CLI.

## Requirements
- Remote server: `https://magicmarkets.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://magicmarkets.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add magicmarkets --url https://magicmarkets.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "magicmarkets": {
            "url": "https://magicmarkets.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "magicmarkets": {
            "type": "http",
            "url": "https://magicmarkets.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http magicmarkets https://magicmarkets.com/mcp
```

## When to use it
- find events that currently have live prices
- get a quote on a selection before committing
- place an order with a price and stake against a betslip
- check balance and open orders
- map a price onto the tick schedule

## Example prompts
- List football events with live prices, limit to five
- Create a betslip for `for,h` on event `2026-06-15,1001,2002` and wait for the quote
- Place an order on betslip `bs-123` at price 2.10 with a stake of 50

## Similar
- [kalshi](https://affpapa.org/en/nevibecode/skills/kalshi.md) — skill · 1000 installs
- [okx-cex-trade](https://affpapa.org/en/nevibecode/skills/okx-cex-trade.md) — skill · 10300 installs
- [metadata](https://affpapa.org/en/nevibecode/skills/metadata.md) — skill · 491 installs
- [connectors-available](https://affpapa.org/en/nevibecode/skills/connectors-available.md) — skill · 408 installs
- [hummingbot](https://affpapa.org/en/nevibecode/skills/hummingbot.md) — skill · 400 installs
- [sportscore-mcp](https://affpapa.org/en/nevibecode/mcp/sportscore-mcp.md) — MCP server · ★ 15

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md