mcp-server-kalshi — MCP-сервер для Claude Code: торговля на Kalshi
Даёт агенту доступ к рынкам предсказаний Kalshi: поиск, изучение правил расчёта и выставление ордеров через MCP-инструменты.
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Что делает 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 с приватным ключом торговые инструменты не заработают.
Какие задачи решает
- найти рынок Kalshi по фильтрам, когда текстового поиска нет
- прочитать точные правила расчёта контракта перед сделкой
- скачать и распознать PDF с условиями контракта
- посмотреть стакан и историю сделок по рынку
- выставить ордер с предварительным превью вместо мгновенной отправки
Примеры запросов агенту
- Покажи открытые рынки Kalshi по фильтрам и выбери самые ликвидные
- Достань правила расчёта этого рынка и скачай PDF с условиями контракта
- Выставь ордер на покупку YES по 40 центов, но сначала покажи превью
Как установить mcp-server-kalshi
Командой платформы
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 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 <команда>
Файл настроек
{
"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 <команда>
Файл настроек
{
"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 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 <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-server-kalshi
Как установить mcp-server-kalshi в Claude Code?
Выполните claude mcp add mcp-server-kalshi -e KALSHI_API_KEY=<KALSHI_API_KEY> -- uvx mcp-server-kalshi. Если нужны ещё переменные окружения, используйте второй вариант: `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`.
Что делает mcp-server-kalshi?
Даёт агенту инструменты для работы с рынками предсказаний Kalshi: поиск рынков и событий, стакан, свечи, история сделок, правила расчёта, а также выставление и отмена ордеров.
Нужен ли API-ключ Kalshi для работы сервера?
Нет, если речь только о рынках и правилах — эти инструменты работают без авторизации. Ключ API и путь к RSA-ключу в .pem нужны для портфеля и торговли.
