# mcp-server-kalshi

Даёт агенту доступ к рынкам предсказаний Kalshi: поиск, изучение правил расчёта и выставление ордеров через MCP-инструменты.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 31
- Автор: 9crusher
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/9crusher/mcp-server-kalshi
- Обновлён: 2026-09-19
- HTML: https://affpapa.org/nevibecode/mcp/mcp-server-kalshi

## Что делает

Сервер закрывает весь путь сделки: `list_markets` и `get_market` находят рынок, `get_market_orderbook` и `get_market_candlesticks` дают данные для оценки, `get_market_rules` собирает правила, условия досрочного закрытия и источники расчёта, а `fetch_rules_pdf` скачивает и распознаёт текст самого контракта. Торговые инструменты — `create_order`, `cancel_order`, `amend_order`, `decrease_order`. Свободного текстового поиска у Kalshi нет, поэтому искать приходится фильтрами `list_markets`.

По умолчанию сервер работает с демо-средой Kalshi, реальные деньги включаются только через `KALSHI_ENV=prod`. Инструменты выставления ордеров требуют `confirm=true`: без него возвращается превью с читаемой сводкой и точным payload, а ордер не уходит. Ключ API и RSA-ключ нужны только для портфеля и торговли — рынки и правила читаются без авторизации.

Цена задаётся в целых центах вместе с `action` (buy/sell) и `side` (yes/no), а сервер сам переводит это в формат Kalshi V2, включая инверсию цены для buy-NO и sell-YES. Для локального запуска нужен Python 3.10+ и `uv sync`, затем `uv run start`. Запросы подписываются RSA-PSS, поэтому без файла `.pem` с приватным ключом торговые инструменты не заработают.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `KALSHI_ENV`, `KALSHI_API_KEY`, `KALSHI_PRIVATE_KEY_PATH`, `BASE_URL` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env KALSHI_ENV=<KALSHI_ENV> --env KALSHI_API_KEY=<KALSHI_API_KEY> --env KALSHI_PRIVATE_KEY_PATH=<KALSHI_PRIVATE_KEY_PATH> --env BASE_URL=<BASE_URL> --transport stdio mcp-server-kalshi -- uvx mcp-server-kalshi
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-kalshi <команда>

### Codex

**Командой платформы**
```bash
codex mcp add mcp-server-kalshi --env KALSHI_ENV=<KALSHI_ENV> --env KALSHI_API_KEY=<KALSHI_API_KEY> --env KALSHI_PRIVATE_KEY_PATH=<KALSHI_PRIVATE_KEY_PATH> --env BASE_URL=<BASE_URL> -- uvx mcp-server-kalshi
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-kalshi <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server-kalshi": {
            "command": "uvx",
            "args": [
                "mcp-server-kalshi"
            ],
            "env": {
                "KALSHI_ENV": "<KALSHI_ENV>",
                "KALSHI_API_KEY": "<KALSHI_API_KEY>",
                "KALSHI_PRIVATE_KEY_PATH": "<KALSHI_PRIVATE_KEY_PATH>",
                "BASE_URL": "<BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-kalshi <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server-kalshi": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-server-kalshi"
            ],
            "env": {
                "KALSHI_ENV": "<KALSHI_ENV>",
                "KALSHI_API_KEY": "<KALSHI_API_KEY>",
                "KALSHI_PRIVATE_KEY_PATH": "<KALSHI_PRIVATE_KEY_PATH>",
                "BASE_URL": "<BASE_URL>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-kalshi <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e KALSHI_ENV=<KALSHI_ENV> -e KALSHI_API_KEY=<KALSHI_API_KEY> -e KALSHI_PRIVATE_KEY_PATH=<KALSHI_PRIVATE_KEY_PATH> -e BASE_URL=<BASE_URL> mcp-server-kalshi uvx mcp-server-kalshi
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-server-kalshi <команда>

## Когда брать
- найти рынок Kalshi по фильтрам, когда текстового поиска нет
- прочитать точные правила расчёта контракта перед сделкой
- скачать и распознать PDF с условиями контракта
- посмотреть стакан и историю сделок по рынку
- выставить ордер с предварительным превью вместо мгновенной отправки

## Примеры запросов агенту
- Покажи открытые рынки Kalshi по фильтрам и выбери самые ликвидные
- Достань правила расчёта этого рынка и скачай PDF с условиями контракта
- Выставь ордер на покупку YES по 40 центов, но сначала покажи превью

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89408
- [CCXT](https://affpapa.org/nevibecode/mcp/ccxt.md) — MCP-сервер · ★ 44583
- [Finance Toolkit](https://affpapa.org/nevibecode/mcp/finance-toolkit.md) — MCP-сервер · ★ 5458
- [EdgarTools](https://affpapa.org/nevibecode/mcp/edgartools.md) — MCP-сервер · ★ 2814

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md