upstox-mcp-server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Upstox Model Context Protocol (MCP) Server π
An open-source implementation of Anthropic's Model Context Protocol (MCP) for the Upstox API v2. This server allows LLM-powered development agents (like Claude Desktop, Cursor, or local custom setups) to securely analyze portfolios and execute orders on the Indian Stock Market (NSE/BSE) using natural language.
β‘ Features
Get Profile (
get_profile): Fetches active broker account metadata and verification status.Get Holdings (
get_holdings): Reads active long-term equity holdings and computes real-time PnL.Place Order (
place_order): Places standard or bracket orders (with optional Good Till Triggered (GTT) target and stop-loss legs) directly onto exchange servers.Fallback Sandbox Mode: Runs in dry-run mode automatically if API credentials are not set, allowing safe testing.
Related MCP server: Kite MCP Server
π οΈ Quick Start
1. Prerequisites
Python 3.10 or higher installed on your system.
An active Upstox Developer account (to obtain API credentials).
2. Installation
Clone the repository and install the dependencies:
git clone https://github.com/YOUR_USERNAME/upstox-mcp-server.git
cd upstox-mcp-server
pip install -r requirements.txt3. Setup Credentials
Copy the example environment file and fill in your Upstox credentials:
cp .env.example .envOpen .env and enter:
UPSTOX_ACCESS_TOKEN=your_real_access_token_here
UPSTOX_API_KEY=your_api_key_here
UPSTOX_API_SECRET=your_api_secret_hereπ€ Client Integration
1. Claude Desktop
Add the server configuration to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"upstox-mcp": {
"command": "python3",
"args": ["/absolute/path/to/upstox-mcp-server/upstox_mcp_server.py"]
}
}
}2. Cursor IDE
Open Cursor and go to Settings > Features > MCP.
Click + Add New MCP Server.
Fill in:
Name:
upstox-mcpType:
stdioCommand:
python3 /absolute/path/to/upstox-mcp-server/upstox_mcp_server.py
Click Save.
π‘ Example Prompt Queries
Once connected, you can query your agent using standard English:
"What is my current portfolio worth on Upstox?"
"Buy 5 shares of TATAMOTORS at market price."
"Buy 10 shares of HAL at 3150 with a stop-loss at 3100 and a profit target of 3250."
π License
MIT License. Feel free to modify, extend, and deploy.
lets do some changes inside this repo
this is my first github repo
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
Agentic brokerage access to a US brokerage account: quotes, orders, positions, cash and documents.
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.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI-powered trading and portfolio management through Upstox API integration. Supports portfolio rebalancing strategies with LLM inference for automated trading decisions.MIT
- 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-
- FlicenseNot gradedqualityDmaintenanceEnables users to interact with the Upstox trading API via natural language to retrieve account information such as profile, funds, holdings, positions, and orders.1-