Angel One MCP Server

Name: Angel One MCP Server
Author: io.github.ameernoufil

io.github.ameernoufil/angel-one

Repository Registry

What is the Angel One MCP server?

Angel One SmartAPI MCP for orders, portfolio, market data, GTT rules, charges, and margin.

How to install Angel One

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ANGEL_API_KEY
required
secret
Angel One SmartAPI app key
ANGEL_CLIENT_ID
required
secret
Angel One client code
ANGEL_PASSWORD
required
secret
Angel One password or MPIN
ANGEL_TOTP_SECRET
required
secret
Base32 TOTP secret used to generate login OTPs
SOFT_MAX_ORDER_QTY
Soft max order quantity
HARD_MAX_ORDER_QTY
Hard max order quantity
SOFT_MAX_ORDER_VALUE
Soft max order value in INR
HARD_MAX_ORDER_VALUE
Hard max order value in INR

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<YOUR_ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<YOUR_ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<YOUR_ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<YOUR_ANGEL_TOTP_SECRET>",
        "SOFT_MAX_ORDER_QTY": "<YOUR_SOFT_MAX_ORDER_QTY>",
        "HARD_MAX_ORDER_QTY": "<YOUR_HARD_MAX_ORDER_QTY>",
        "SOFT_MAX_ORDER_VALUE": "<YOUR_SOFT_MAX_ORDER_VALUE>",
        "HARD_MAX_ORDER_VALUE": "<YOUR_HARD_MAX_ORDER_VALUE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<YOUR_ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<YOUR_ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<YOUR_ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<YOUR_ANGEL_TOTP_SECRET>",
        "SOFT_MAX_ORDER_QTY": "<YOUR_SOFT_MAX_ORDER_QTY>",
        "HARD_MAX_ORDER_QTY": "<YOUR_HARD_MAX_ORDER_QTY>",
        "SOFT_MAX_ORDER_VALUE": "<YOUR_SOFT_MAX_ORDER_VALUE>",
        "HARD_MAX_ORDER_VALUE": "<YOUR_HARD_MAX_ORDER_VALUE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<YOUR_ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<YOUR_ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<YOUR_ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<YOUR_ANGEL_TOTP_SECRET>",
        "SOFT_MAX_ORDER_QTY": "<YOUR_SOFT_MAX_ORDER_QTY>",
        "HARD_MAX_ORDER_QTY": "<YOUR_HARD_MAX_ORDER_QTY>",
        "SOFT_MAX_ORDER_VALUE": "<YOUR_SOFT_MAX_ORDER_VALUE>",
        "HARD_MAX_ORDER_VALUE": "<YOUR_HARD_MAX_ORDER_VALUE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "angel-one": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<YOUR_ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<YOUR_ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<YOUR_ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<YOUR_ANGEL_TOTP_SECRET>",
        "SOFT_MAX_ORDER_QTY": "<YOUR_SOFT_MAX_ORDER_QTY>",
        "HARD_MAX_ORDER_QTY": "<YOUR_HARD_MAX_ORDER_QTY>",
        "SOFT_MAX_ORDER_VALUE": "<YOUR_SOFT_MAX_ORDER_VALUE>",
        "HARD_MAX_ORDER_VALUE": "<YOUR_HARD_MAX_ORDER_VALUE>"
      }
    }
  }
}

Claude Code

claude mcp add angel-one --env ANGEL_API_KEY=<YOUR_ANGEL_API_KEY> --env ANGEL_CLIENT_ID=<YOUR_ANGEL_CLIENT_ID> --env ANGEL_PASSWORD=<YOUR_ANGEL_PASSWORD> --env ANGEL_TOTP_SECRET=<YOUR_ANGEL_TOTP_SECRET> --env SOFT_MAX_ORDER_QTY=<YOUR_SOFT_MAX_ORDER_QTY> --env HARD_MAX_ORDER_QTY=<YOUR_HARD_MAX_ORDER_QTY> --env SOFT_MAX_ORDER_VALUE=<YOUR_SOFT_MAX_ORDER_VALUE> --env HARD_MAX_ORDER_VALUE=<YOUR_HARD_MAX_ORDER_VALUE> -- npx -y angel-one-mcp