Angel One Mcp

Angel One MCP

Angel One SmartAPI 用 MCP サーバーです。Claude、Cursor などの AI アシスタントを通じて、株式の取引、ポートフォリオの管理、市場データへのアクセス、分析の実行ができます。

ツール（30 以上）

カテゴリ	ツール
セッション	angelone_ping、angelone_login、angelone_auto_login、angelone_logout、angelone_get_profile、angelone_get_rms_limit
注文	angelone_place_order、angelone_modify_order、angelone_cancel_order、angelone_get_order_book、angelone_get_trade_book、angelone_get_order_details
ポートフォリオ	angelone_get_holdings、angelone_get_all_holdings、angelone_get_positions、angelone_convert_position
市場データ	angelone_get_ltp、angelone_get_market_data、angelone_search_scrip
過去データ	angelone_get_candle_data
GTT	angelone_create_gtt_rule、angelone_modify_gtt_rule、angelone_cancel_gtt_rule、angelone_get_gtt_rule、angelone_list_gtt_rules
分析	angelone_get_option_greeks、angelone_get_gainers_losers、angelone_get_put_call_ratio、angelone_get_oi_buildup、angelone_estimate_charges、angelone_get_margin_api

クイックスタート

1. API キーを取得する

1. smartapi.angelone.in にアクセスします
2. Angel One アカウントでサインアップ／ログインします
3. アプリを作成して API Key を取得します
4. Client Code（Angel One ID）と PIN を控えます
5. TOTP を設定し、TOTP Secret（QR コードから取得）を控えます

2. インストールする

pip install angel-one-mcp

3. Claude Desktop を設定する

claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "angel-one": {
      "command": "angel-one-mcp",
      "env": {
        "ANGELONE_API_KEY": "your_api_key",
        "ANGELONE_CLIENT_CODE": "your_client_code",
        "ANGELONE_PASSWORD": "your_pin",
        "ANGELONE_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

4. Claude で使用する

"Login to my Angel One account"
"Show my portfolio holdings"
"What's the current price of RELIANCE?"
"Place a buy order for 10 shares of INFY at market price"
"Show me NIFTY historical data for the last month"
"What are the option greeks for NIFTY 23000 CE?"
"Show top gainers in the market"

別のセットアップ方法

Python モジュールを直接使用する

{
  "mcpServers": {
    "angel-one": {
      "command": "python",
      "args": ["-m", "angel_one_mcp.server"],
      "env": {
        "ANGELONE_API_KEY": "your_api_key",
        "ANGELONE_CLIENT_CODE": "your_client_code",
        "ANGELONE_PASSWORD": "your_pin",
        "ANGELONE_TOTP_SECRET": "your_totp_secret"
      }
    }
  }
}

Docker を使用する

docker build -t angel-one-mcp .
docker run -p 8000:8000 \
  -e ANGELONE_API_KEY=your_key \
  -e ANGELONE_CLIENT_CODE=your_code \
  -e ANGELONE_PASSWORD=your_pin \
  -e ANGELONE_TOTP_SECRET=your_secret \
  angel-one-mcp

MCP Inspector を使用する（テスト用）

npx @modelcontextprotocol/inspector
# Command: python
# Args: -m angel_one_mcp.server

環境変数

変数	必須	説明
ANGELONE_API_KEY	はい	開発者ポータルで取得した SmartAPI キー
ANGELONE_CLIENT_CODE	はい	Angel One のクライアント ID
ANGELONE_PASSWORD	はい	Angel One の PIN
ANGELONE_TOTP_SECRET	はい	OTP の自動生成に使用する TOTP シークレット
ANGELONE_MCP_TRANSPORT	いいえ	stdio（デフォルト）または streamable_http
ANGELONE_MCP_PORT	いいえ	HTTP モードのポート（デフォルト：8000）

Angel One SmartAPI — 無料

Angel One SmartAPI は完全無料です。

• 月額料金なし
• 取引、ポートフォリオ、市場データへの API アクセスが無料
• 過去のローソク足データを利用可能
• オプションチェーンと分析機能を利用可能

Angel One の有効な取引口座が必要です。

ライセンス

MIT