Skip to content
MCP server

Angel One

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.0.10
Listing updated
5 days ago

About Angel One

Angel One is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add angel-one --env ANGEL_API_KEY='<ANGEL_API_KEY>' --env ANGEL_CLIENT_ID='<ANGEL_CLIENT_ID>' --env ANGEL_PASSWORD='<ANGEL_PASSWORD>' --env ANGEL_TOTP_SECRET='<ANGEL_TOTP_SECRET>' -- npx -y angel-one-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "angel-one": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "angel-one": {
      "command": "npx",
      "args": [
        "-y",
        "angel-one-mcp"
      ],
      "env": {
        "ANGEL_API_KEY": "<ANGEL_API_KEY>",
        "ANGEL_CLIENT_ID": "<ANGEL_CLIENT_ID>",
        "ANGEL_PASSWORD": "<ANGEL_PASSWORD>",
        "ANGEL_TOTP_SECRET": "<ANGEL_TOTP_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ANGEL_API_KEYAngel One SmartAPI app keyRequired
  • ANGEL_CLIENT_IDAngel One client codeRequired
  • ANGEL_PASSWORDAngel One password or MPINRequired
  • ANGEL_TOTP_SECRETBase32 TOTP secret used to generate login OTPsRequired
  • SOFT_MAX_ORDER_QTYSoft max order quantity
  • HARD_MAX_ORDER_QTYHard max order quantity
  • SOFT_MAX_ORDER_VALUESoft max order value in INR
  • HARD_MAX_ORDER_VALUEHard max order value in INR

Pricing

Open source

Angel One FAQ

Is Angel One free?

Yes. Angel One is open source, so you can use and self-host it for free.

How do I add Angel One to Claude Code?

Run this command in your terminal: claude mcp add angel-one --env ANGEL_API_KEY='<ANGEL_API_KEY>' --env ANGEL_CLIENT_ID='<ANGEL_CLIENT_ID>' --env ANGEL_PASSWORD='<ANGEL_PASSWORD>' --env ANGEL_TOTP_SECRET='<ANGEL_TOTP_SECRET>' -- npx -y angel-one-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers