About Angel One MCP (Model Context Protocol)
Angel One MCP is a local server for developers and traders who use the Angel One trading platform. It connects MCP clients to the platform’s APIs for historical and portfolio data.
Key features
- 01Access historical trading data
- 02Retrieve portfolio data
- 03Connect to Angel One APIs locally
Use cases
- 01Review historical market data in an MCP client
- 02Check portfolio data through an MCP client
MCP support
It runs as a local MCP server and exposes access to Angel One trading APIs for historical and portfolio data.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEAngel One MCP (Model Context Protocol)
What is MCP: For detailed understanding follow the blog: https://norahsakal.com/blog/mcp-vs-api-model-context-protocol-explained/
This repository contains the Model Context Protocol implementation for Angel One trading platform, allowing you to interact with Angel One's trading APIs to get history data and get portfolio data.
Prerequisites
- Python 3.10
- Angel One trading account
- API credentials from Angel One
Installation
- Clone the repository:
git clone https://github.com/yourusername/angelone-mcp.git
cd angelone-mcp
git submodule update --init --recursive
- Create a virtual environment (recommended):
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
- Install the required dependencies: Linux/Mac
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows:
irm https://astral.sh/uv/install.ps1 | iex
uv pip install -r requirements.txt
Configuration
- Inside api.py file hardcode following parameters with your Angel One credentials:
# test_credentials.py
API_KEY = "your_api_key"
CLIENT_CODE = "your_client_code"
PASSWORD = "PIN"
TOKEN = "your_token" # Visit https://smartapi.angelbroking.com/enable-totp (copy the code/token below QR)
Usage
- You can start
api.pyas an mcp server to your mcp client: - If using Anthropic Desktop configuration update cloud_desktop_config.json. Local configuration file path can be found under settings > Developer > Edit Settings
- If using Cline update MCP servers>Installed>configure MCP Servers and update cline_mcp_settings.json
{
"mcpServers": {
"angleone": {
"command": "C:/Users/<user>/.local/bin/uv",
"args": [
"--directory",
"<local-project-path>/mcpserver-AngelOne/",
"run",
"api.py"
]
}
}
}
Configuration Test -- Snapshots
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.