Angel One MCP Server

Angel One Limited (ранее Angel Broking Limited) — ведущая индийская брокерская фирма, основанная в 1996 году и обслуживающая более 24,7 млн клиентов на крупнейших индийских фондовых биржах, включая BSE и NSE. Этот сервер предоставляет доступ к торговле индийскими акциями, товарно-сырьевыми активами и деривативами.

Сервер Model Context Protocol (MCP), который предоставляет полноценный функционал для торговли и рыночных данных для Angel One через их SmartAPI.

Возможности

Управление портфелем

• Просмотр акций и инвестиционного портфеля

• Получение полной информации об активах, находящихся на семейном счёте

• Проверка текущих торговых позиций

• Доступ к лимитам системы управления рисками (RMS)

Торговые операции

• Размещение заявок на покупку/продажу (рыночных, лимитных, стоп-лосс)

• Изменение существующих заявок

• Отмена заявок

• Просмотр книги заявок и исторических сделок

• Создание правил GTT (Good Till Triggered)

Рыночные данные

• Цена последней сделки (LTP) в реальном времени

• Исторические данные в виде свечей (OHLC)

• Поиск акций и финансовых инструментов

• Анализ лидеров роста и падения

• Коэффициент пут/колл (PCR) для оценки настроений рынка

Расширенные возможности

• Расчёт греков (Greeks) по опционам

• Конвертация позиций

• Оценка брокерских комиссий

• Автоматическая аутентификация через TOTP

• Всесторонняя обработка ошибок

• Защитные механизмы и режим dry-run

Related MCP server: Kite MCP Server

Установка

Установка для разработчиков (актуальная версия)

# Clone the repository
git clone https://github.com/YOUR_USERNAME/angel-one-mcp-server.git
cd angel-one-mcp-server

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

Установка через PyPI (скоро будет доступна)

pip install angel-one-mcp

Настройка

Вы можете настроить учётные данные Angel One одним из следующих способов:

Вариант 1: Переменные окружения (рекомендуется)

Создайте файл .env в каталоге вашего проекта:

ANGEL_ONE_API_KEY=your_api_key
ANGEL_ONE_CLIENT_CODE=your_client_code
ANGEL_ONE_PASSWORD=your_password
ANGEL_ONE_TOTP_SECRET=your_totp_secret
MAX_ORDER_QUANTITY=10000
DRY_RUN_MODE=false

Затем настройте Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"]
    }
  }
}

Вариант 2: Прямая настройка

Настройте учётные данные напрямую в Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "angel-one-trading": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"],
      "env": {
        "ANGEL_ONE_API_KEY": "your_api_key",
        "ANGEL_ONE_CLIENT_CODE": "your_client_code", 
        "ANGEL_ONE_PASSWORD": "your_password",
        "ANGEL_ONE_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

Примечание: Рекомендуется вариант 1, поскольку он позволяет хранить конфиденциальные учётные данные отдельно от конфигурационных файлов.

Примеры использования

Управление портфелем

• "Показать текущие активы"

• "Какой у меня доступный маржин?"

• "Показать открытые позиции"

Торговля

• "Купить 100 акций RELIANCE по рыночной цене"

• "Разместить лимитную заявку на продажу 50 TCS по цене ₹3500"

• "Отменить заявку с идентификатором 12345"

Рыночные данные

• "Какова текущая цена NIFTY?"

• "Показать лидеров роста за сегодня"

• "Получить исторические данные для SBIN"

Возможности безопасности

• Автоматическая аутентификация на основе TOTP

• Настраиваемые лимиты объёма заявок

• Режим dry-run для тестирования

• Всесторонняя обработка ошибок

• Учётные данные не хранятся в памяти

Требования

• Python 3.8+

• Учётная запись Angel One SmartAPI

• Действительные API credentials и настройка TOTP

Лицензия

MIT License