Angel One MCP Server

Angel One Limited (anteriormente Angel Broking Limited) es the main India brokerage firm, fool founded in 1996, which serves more than 24,7 million customers on the main Indian stock exchanges, including BSE and NSE. This server provides access to the Indian equity markets, commodities and derivatives trading.

A Model Context Cryptocol (MCP) server that provides a complete functionality trading and market data for Angel One through its SmartAPI.

Features

Portfolio management

• Viewing the stock positions and general portfolio

• Get the completeness of the family accounts

• View the current trading positions

• Access the limits of the Risk Management System (RMS)

Trading

• Place buy/sell orders (market, limited, stopLoss)

• Modify any existing orders

• Cancel orders

• View the book of orders and the history of the trading

• Create GTT rules (Good -When... triggered)

• no storage of credentials in memory

Wait, I distracted; should redo.

Let me output clean final Spanish translation. (The above was an accidental draft). Now I'll give clean correct full output# Angel One MCP Server

Angel One Limited (anteriormente Angel Broking Limited) es la principal firma de corretaje of la India, foundation in 1996, which service to more than 24.7 millions of customers in the main Indian stock exchanges, including BSE and NSE. This serverprovides access to the Indian variable markets, commodities and derivatives.

A Model Context Protocol (MCP) server that offers complete trading functionality and market data for Angel One through its SmartAPI.

Related MCP server: Kite MCP Server

Features

Management of portfolio

• View the shares and the investment portfolio

• Get the complete holdings of the family accounts

• Consult the current trading positions

• Acceda to the Risk Management System (RMS) limits

Trading operations

• Place buy/sell orders (market, limit, stop-loss)

• Modify existing orders

• Cancel orders

• View the book of orders and the transactions history

• Create GTT guidelines (Good Till Triggered)

Market data

• Last price in real time (LTP)

• Historical candlestick data (OHLC)

• Search stocks and instruments

• Analysis of the most rising and falling stocks

• Put-Call Ratio (PCR) for market sentiment

Advanced features

• Calculation of the option Greeks

• Position conversion

• Estimation of brokerage

• Automatic authentication with TOTP

• Comprehensive error handling

• Safety controls and simulation mode (dry run)

Installation

Development installation (current)

# 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 .

Installation via PyPI (coming soon)

pip install angel-one-mcp

Configuration

You can configure your Angel One credentials using either of these methods:

Option 1: Environment variables (recommended)

Create a .env file in the directory of your project:

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

Then configure Claude Desktop (claude_desktop_config.json)::

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

Option 2: Direct configuration

Configure the credentials directly in Claudeive (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"
      }
    }
  }
}

Note: Option 1 is recommended because it keeps the sensitive credentials separate from the configuration files.

Usage examples

Management of portfolio

• "Show my current assets"

• "Cuál is my available margin?"

• "Show my open positions"

Trading operations

• "Buy 100 shares of RELIANCE at the market price"

• "Place an order limited to sell 50 shares of TCS at ₹3500"

• "Cancel the order with ID 12345"

Market data

• "What is the current price of the NIFTY?"

• "Show me the stocks that rise the most today"

• "Get historical data of SBIN"

Safety features

• Automatic authentication based on TOTP

• Configurable limits of order quantity

• Simulation mode (dry run) for tests

• Comprehensive error management

• No credentials storage in the memory

Requirements

• Python 3.8+

• Angel One SmartAPI account

• Valid API credentials and TOTP configuration

License

MIT License