Skip to content

README.md

Latest commit

 

History

History
167 lines (124 loc) · 4 KB

README.md

File metadata and controls

167 lines (124 loc) · 4 KB

Alphabots MCP Server

Model Context Protocol (MCP) server for AI agents to access Alphabots portfolio data and market insights.

📋 Overview

The Alphabots MCP Server provides:

  • Portfolio Insights: Complete portfolio summary with advanced analytics
  • Options Analysis: Intelligent CE/PE options detection with Greeks
  • Real-time Data: Current market prices via Yahoo Finance
  • Indian Market Focus: Optimized for NSE, BSE, and Indian derivatives

🚀 Quick Setup

Option 1: Direct Installation

```bash npx alphabots-mcp-server@1.0.12 ```

Option 2: Bundle Import (Recommended for IDEs)

  1. Download `alphabots_bundle.mcpb` from this folder
  2. Import via your IDE's MCP extension
  3. Set your MCP token

⚙️ Configuration

Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or equivalent:

```json { "mcpServers": { "alphabots": { "command": "npx", "args": ["alphabots-mcp-server@1.0.12"], "env": { "mcp_token": "YOUR_MCP_TOKEN_HERE" } } } } ```

Trae.ai / Cursor / ChatGPT

Create or edit `~/mcp.json`:

```json { "mcpServers": { "alphabots": { "command": "npx", "args": ["alphabots-mcp-server@1.0.12"], "ENV": { "mcp_token": "YOUR_MCP_TOKEN_HERE" } } } } ```

VS Code

  1. Install an MCP extension for VS Code
  2. Import `alphabots_bundle.mcpb`
  3. Configure your token

🔑 Get Your Token

  1. Log in to Alphabots portal
  2. Navigate to Settings → API Keys
  3. Generate an MCP token
  4. Replace `YOUR_MCP_TOKEN_HERE` in your config

🛠️ Available Tools

Tool Description
`get_portfolio_summary` Complete portfolio overview with P&L
`get_broker_insights` Broker-specific analytics and stats
`get_holdings` List all current holdings with details
`analyze_options` CE/PE options analysis with Greeks
`get_advanced_analysis` Deep portfolio metrics and trends
`get_weekly_expiry_options` Weekly options positions and exposure

📊 Example Usage

Get Portfolio Summary

``` Agent: Show my portfolio summary

Response: 📊 Portfolio Summary

Total Value: ₹12,45,678 Today's P&L: +₹23,450 (+1.92%) Total P&L: +₹2,34,567 (+23.2%)

Holdings: 32 positions Cash: ₹1,23,456 ```

Analyze Options

``` Agent: Analyze my options positions

Response: 📈 Options Analysis

NIFTY 24200 CE: ₹125 | Delta: 0.52 | Theta: -₹8.5/day BANKNIFTY 49000 PE: ₹180 | Delta: -0.38 | Theta: -₹12.2/day

Total Options P&L: +₹15,678 Weekly Exposure: ₹8,50,000 ```

✨ Features

  • Portfolio Insights: Complete summary with P&L
  • Options Analysis: CE/PE detection with Greeks
  • Enhanced Symbols: NSE:/BSE: prefixed symbols
  • Weekly Expiry: YYMDD format support (e.g., 25APR)
  • Real-time Data: Yahoo Finance integration
  • Indian Markets: Optimized for NSE, BSE, derivatives
  • INR Currency: All values in Indian Rupees (₹)
  • Indian Formatting: Proper locale number formatting

📁 Files

File Description
`alphabots_bundle.mcpb` MCP bundle for IDE import
`mcp_hosted_config.json` Sample config for hosted environments
`README.md` This file

🧪 Testing

After setup, test by asking your AI agent:

  • "Show my portfolio summary"
  • "Get my broker insights"
  • "What are my current holdings?"
  • "Analyze my options positions"
  • "Get advanced portfolio analysis"
  • "Show me weekly expiry options"

The response should show data in INR (₹) currency format.

📚 More Information

🔗 Related Resources

Version: 1.0.12 | Last updated: February 2026