angelone-mcp
Mcp server code for angelOne, use these tools directly with your agent to customize your tradebot. Follows model context protocols.
Install / Use
claude mcp add Tilakraj0308 -- npx -y github:Tilakraj0308/angelone-mcpIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of angelone-mcp
angelone-mcp scores 68/100 on our quality scale, 3948th of 4,705 Development & Engineering skills we index.
Its MCP Server is 6.9 KB long, well organised into 21 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated about 13 months ago. Expect some instructions to reference tool versions or APIs that have since changed.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 80/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-16. Automated pattern scan on 2026-11-16. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
angelone-mcp compared with similar skills
All 4 of these similar skills score higher than angelone-mcp; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| angelone-mcp (this skill)by Tilakraj0308 | 68 | 3 | 13mo ago | MCP Server |
| taste-skillby Leonxlnx | 100 | 117.0k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.4k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
Frequently asked questions
- How do I install angelone-mcp?
- Run
claude mcp add Tilakraj0308 -- npx -y github:Tilakraj0308/angelone-mcp. The install tabs above show the steps for each supported agent. - Which AI agents does angelone-mcp work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is angelone-mcp safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 80/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is angelone-mcp still maintained?
- The repository was last updated about 13 months ago. Expect some instructions to reference tool versions or APIs that have since changed.
Skill content
View source on GitHubAngel One MCP Server
A Model Context Protocol (MCP) server for interacting with Angel One (Angel Broking) trading platform. This server enables AI assistants like Claude to access your Angel One account, view holdings, place orders, and manage your portfolio through natural language commands.
Features
- Portfolio Management: View current holdings and portfolio summary
- Order Management: Place buy/sell orders with various order types (SL-L, SL-M, Target)
- Order Tracking: View and cancel pending orders
- Historical Data: Fetch OHLCV data for stocks
- Smart Symbol Resolution: Automatically resolves company names to trading symbols
Prerequisites
- Python 3.12 or higher
- Angel One trading account with API access
- Angel One API credentials (API key, username, password, TOTP token)
Installation
Option 1: Using uv (Recommended)
uv is a fast Python package installer and resolver.
-
Install uv: Follow the installation instructions at https://docs.astral.sh/uv/getting-started/installation/
-
Clone and setup the project:
git clone https://github.com/Tilakraj0308/angelone-mcp.git cd angelone-mcp uv sync -
Download latest market mappings:
uv run python scripts/downloadLatestMappings.py
Option 2: Using pip
-
Clone the repository:
git clone https://github.com/Tilakraj0308/angelone-mcp.git cd angelone-mcp -
Create a virtual environment:
python -m venv .venv # Activate it # On macOS/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate -
Install dependencies:
pip install -e . -
Download latest market mappings:
python scripts/downloadLatestMappings.py
Configuration
-
Create a
.envfile in the project root:cp .env.example .env -
Fill in your Angel One credentials:
api_key = "your_api_key" username = "your_client_id" pwd = "your_password" token = "your_totp_token" threshold = "80"Configuration Parameters:
api_key: Your Angel One API keyusername: Your Angel One client IDpwd: Your Angel One passwordtoken: Your TOTP token from Angel One mobile appthreshold: Fuzzy matching threshold for company name resolution (0-100)
Running the Server
Standalone Mode
# Using uv
uv run angelone-mcp
# Using pip (with venv activated)
angelone-mcp
With Claude Desktop
-
Locate your Claude Desktop config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- macOS:
-
Add the MCP server configuration:
If using uv:
{ "mcpServers": { "angelone": { "command": "uv", "args": [ "--directory", "/absolute/path/to/angelone-mcp", "run", "angelone-mcp" ] } } }If using pip:
{ "mcpServers": { "angelone": { "command": "/absolute/path/to/angelone-mcp/.venv/bin/angelone-mcp", "args": [] } } }On Windows with pip, use:
{ "mcpServers": { "angelone": { "command": "C:\\absolute\\path\\to\\angelone-mcp\\.venv\\Scripts\\angelone-mcp.exe", "args": [] } } } -
Restart Claude Desktop

Available Tools
The MCP server provides the following tools to Claude:
| Tool | Description |
|------|-------------|
| get_exchanges | Get list of available exchanges (NSE, BSE) |
| current_holdings | View your current stock holdings and portfolio summary |
| get_pending_orders | View all pending orders |
| get_stock_details | Fetch historical OHLCV data for a stock |
| buy_stock_sll | Place a Stop Loss Limit buy order |
| buy_stock_slm | Place a Stop Loss Market buy order |
| sell_stock_sll | Place a Stop Loss Limit sell order |
| sell_stock_slm | Place a Stop Loss Market sell order |
| target_sell | Place a target sell order |
| cancel_order | Cancel a pending order |
Usage Examples
Once configured with Claude Desktop, you can use natural language commands like:
- "Show me my current holdings"
- "What are my pending orders?"
- "Get the historical data for Reliance Industries from last week"
- "Place a stop loss buy order for 10 shares of TCS at trigger price 3500 and limit 3505"
- "Sell all my HDFC Bank shares when price reaches 1600"
- "Cancel order with ID 123456"
Example Conversation

Security Notes
⚠️ Important:
- Never commit your
.envfile to version control - Keep your API credentials secure
- The
.envfile is already in.gitignorefor your protection - Review all orders before confirming through Claude
- This tool has access to place real trades - use with caution
Troubleshooting
Common Issues
-
Symbol not found: The server uses fuzzy matching to resolve company names. If it fails, try using the exact trading symbol (e.g., "SBIN-EQ" for State Bank of India)
-
Session expired: The server automatically manages sessions, but if you encounter authentication errors, restart the server
-
Missing mappings: Run the
downloadLatestMappings.pyscript to refresh market datauv run python scripts/downloadLatestMappings.py # or with pip python scripts/downloadLatestMappings.py -
Claude Desktop not detecting server:
- Verify the absolute path in your config file
- Check that the server runs in standalone mode first
- Restart Claude Desktop completely
-
Import errors: Make sure you've installed the package with
pip install -e .oruv sync
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
- Fork the repository
- Create your feature branch (
git checkout -b feature/AmazingFeature) - Commit your changes (
git commit -m 'Add some AmazingFeature') - Push to the branch (
git push origin feature/AmazingFeature) - Open a Pull Request
License
MIT License - see LICENSE file for details
Disclaimer
⚠️ IMPORTANT DISCLAIMER
This software is provided for educational and informational purposes only. Trading in financial markets involves substantial risk of loss and is not suitable for every investor.
- This tool can place real trades with real money
- The authors and contributors are not responsible for any financial losses
- Always verify orders before execution
- Test thoroughly with small amounts first
- Understand the risks involved in algorithmic trading
- This is NOT financial advice
- Use at your own risk
Related Skills
taste-skill
117.0kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.4kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
