Angel One MCP Server
Angel One MCP Server
Angel One Limited(前身为 Angel Broking Limited)是印度领先的股票经纪公司,成立于1996年,通过包括BSE和NSE在内的印度主要证券交易所为超过2470万客户提供服务。该服务器提供对印度股票市场、大宗商品和衍生品交易的访问权限。
这是一个基于 Model Context Protocol(MCP)的服务器,通过 Angel One 的 SmartAPI 提供全面的交易和市场数据功能。
功能特性
投资组合管理
查看股票持仓和投资组合
获取家庭账户的完整持仓信息
查看当前交易持仓
查看风险管理系统(RMS)限额
交易操作
下达买入/卖出订单(市价、限价、止损)
修改现有订单
取消订单
查看订单簿和交易历史
创建 GTT(触发前有效)规则
市场数据
实时最新成交价(LTP)
历史K线(OHLC)数据
搜索股票和交易工具
涨幅股/跌幅股分析
认购认沽比率(PCR),用于判断市场情绪
高级功能
期权希腊值(Option Greeks)计算
持仓转换
佣金估算
基于 TOTP 的自动认证
全面的错误处理
安全控制和试运行(dry-run)模式
Related MCP server: Kite MCP Server
安装
开发环境安装(当前)
# 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 .PyPI 安装(即将推出)
pip install angel-one-mcp配置
你可以通过以下任一方式配置你的 Angel One 凭证:
方式一:环境变量(推荐)
在你的项目目录中创建一个 .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
MAX_ORDER_QUANTITY=10000
DRY_RUN_MODE=false然后配置 Claude Desktop(claude_desktop_config.json):
{
"mcpServers": {
"angel-one-trading": {
"command": "python",
"args": ["-m", "angel_one_mcp.server"]
}
}
}方式二:直接在文件配置
直接在 Claude Desktop(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"
}
}
}
}注意: 推荐使用方式一,因为它能将敏感凭证与配置文件分离存放。
使用示例
投资组合管理
“查看我当前的持仓”
“我还有多少可用保证金?”
“显示我的未平仓持仓”
交易
“以市价买入100股 RELIANCE”
“以 ₹3500 的价格卖出 50 股 TCS 的限价订单”
“取货订单 ID 12345”
市场数据
“NIFTY 当前价格是多少?”
“显示今日涨幅最大的板块”
“获取 SBIN 的历史数据”
安全特性
基于 TOTP 的自动身份认证
可配置的订单数量限制
试运行模式(dry-run),供测试使用
全面的错误处理机制
不在内存中保留任何凭证
要求
Python 3.8 及以上
Angel One SmartAPI 账户
有效的 API 凭证和 TOTP 设置
许可证
MIT License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Indian broker accounts for AI agents: positions, holdings, orders, P&L, option chains, 10+ brokers.
Unified financial infrastructure connecting AI agents directly to trade live/demo brokerage accounts, Web3 non-custodial wallets, real-time market data across equities, ETFs, crypto, forex, options, DeFi swaps, and prediction markets, institutional research feeds, and algorithmic strategy backtesters.
AI trading agents, backtests, portfolio, Analytics and your brokers, with OAuth sign-in
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables trading operations on Zerodha platform through natural language, supporting account management, order placement/modification, portfolio holdings, positions, margins, and stock news retrieval.Apache 2.0
- AlicenseBqualityDmaintenanceEnables trading and portfolio management on Zerodha Kite Connect through natural language. Supports placing orders, viewing positions/holdings, accessing real-time market data, and managing GTT orders.24MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI models to interact with the Zerodha trading platform for portfolio management, trading, and account operations through natural language.3-
- AlicenseNot gradedqualityDmaintenanceEnables natural language management of Zerodha trading accounts, including placing orders, checking portfolio, and viewing positions through MCP integration.32Apache 2.0