# gainium-mcp

MCP-сервер, через который ИИ-ассистент управляет торговыми ботами, сделками и балансами Gainium. Пригодится, если боты крутятся сами, а команды удобнее отдавать из чата.

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

## Что делает

Сервер даёт ассистенту 17 инструментов: список и настройка ботов типов `dca`, `combo`, `grid`, работа со сделками `dca`, `combo`, `terminal`, запуск бэктестов. Операции чтения помечены `readOnlyHint`, записи — `destructiveHint`, так что клиент видит, где он меняет состояние.

Есть три режима развёртывания. Локальный stdio берёт ключи из переменных окружения. Хостинговый OAuth 2.1 — тот, что работает на публичном `https://mcp.gainium.io/mcp` и нужен для коннектора Anthropic: клиент получает токен у сервера авторизации Gainium и шлёт его в заголовке `Authorization: Bearer`. Третий, устаревший, передаёт `X-API-Key` и `X-API-Secret` в каждом запросе. В режиме OAuth заголовки с ключами игнорируются.

Для локального запуска нужна пара ключей из настроек API Gainium: `GAINIUM_API_KEY` и `GAINIUM_API_SECRET`. Без них сервер в stdio-режиме не аутентифицируется. Ограничения ключа — только чтение, только бумажная торговля, один бот — проверяются на стороне сервера, поэтому узкий ключ остаётся узким и после подключения.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://mcp.gainium.io/mcp`
- Переменные окружения: `GAINIUM_API_KEY`, `GAINIUM_API_SECRET`, `GAINIUM_PAPER_ONLY`, `GAINIUM_ALLOWED_BOT_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http gainium-mcp https://mcp.gainium.io/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env GAINIUM_API_KEY=<GAINIUM_API_KEY> --env GAINIUM_API_SECRET=<GAINIUM_API_SECRET> --env GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> --env GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> --transport stdio gainium-mcp -- npx -y gainium-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add gainium-mcp --url https://mcp.gainium.io/mcp
```

2. **Командой платформы**
```bash
codex mcp add gainium-mcp --env GAINIUM_API_KEY=<GAINIUM_API_KEY> --env GAINIUM_API_SECRET=<GAINIUM_API_SECRET> --env GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> --env GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> -- npx -y gainium-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gainium-mcp": {
            "url": "https://mcp.gainium.io/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gainium-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "gainium-mcp"
            ],
            "env": {
                "GAINIUM_API_KEY": "<GAINIUM_API_KEY>",
                "GAINIUM_API_SECRET": "<GAINIUM_API_SECRET>",
                "GAINIUM_PAPER_ONLY": "<GAINIUM_PAPER_ONLY>",
                "GAINIUM_ALLOWED_BOT_ID": "<GAINIUM_ALLOWED_BOT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "gainium-mcp": {
            "type": "http",
            "url": "https://mcp.gainium.io/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "gainium-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "gainium-mcp"
            ],
            "env": {
                "GAINIUM_API_KEY": "<GAINIUM_API_KEY>",
                "GAINIUM_API_SECRET": "<GAINIUM_API_SECRET>",
                "GAINIUM_PAPER_ONLY": "<GAINIUM_PAPER_ONLY>",
                "GAINIUM_ALLOWED_BOT_ID": "<GAINIUM_ALLOWED_BOT_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http gainium-mcp https://mcp.gainium.io/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e GAINIUM_API_KEY=<GAINIUM_API_KEY> -e GAINIUM_API_SECRET=<GAINIUM_API_SECRET> -e GAINIUM_PAPER_ONLY=<GAINIUM_PAPER_ONLY> -e GAINIUM_ALLOWED_BOT_ID=<GAINIUM_ALLOWED_BOT_ID> gainium-mcp npx -y gainium-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- посмотреть список ботов и их настройки из чата
- запустить или остановить конкретного бота
- закрыть сделку или долить в неё средства
- прогнать бэктест стратегии перед запуском
- клонировать бота с другими параметрами

## Примеры запросов агенту
- Покажи все мои боты типа `grid` и их текущие настройки
- Запусти бота `dca` с идентификатором, который я назову
- Прогони бэктест этой стратегии и покажи результат

## Похожие
- [crypto-trading-bots](https://affpapa.org/nevibecode/skills/crypto-trading-bots.md) — скилл · 917 установок
- [exit-strategies](https://affpapa.org/nevibecode/skills/exit-strategies.md) — скилл · 507 установок
- [find-arbitrage-opps](https://affpapa.org/nevibecode/skills/find-arbitrage-opps.md) — скилл · 493 установки
- [solana-payments-wallets-trading](https://affpapa.org/nevibecode/skills/solana-payments-wallets-trading.md) — скилл · 475 установок

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

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