Getoutpost MCP Server

🚀 GetOutpost MCP Server

This Model Context Protocol (MCP) server integrates real - time Indian options market data and volatility analytics from GetOutpost.in into your AI chats. It offers a range of data and tools for in - depth quantitative analysis and data - driven trading insights in the Indian markets (NSE, BSE).

🚀 Quick Start

This MCP server empowers Claude to analyze options market data, including Implied Volatility (IV), Realized Volatility (RV), Volatility Risk Premium (VRP), and Skew Analysis. It's ideal for quantitative analysis and options trading research in Indian markets.

✨ Features

• Comprehensive Data Analysis: Analyze various aspects of the options market, such as IV, RV, VRP, and skew.
• Multiple Installation Options: Install via Claude Desktop Extension Marketplace (coming soon), direct download, or NPM global installation.
• Automated Token Management: Automatically refresh access tokens and update credentials files.
• Pre - built Prompts: Use pre - built prompt templates to quickly start analysis.

📦 Installation

Option 1: Claude Desktop Extension Marketplace (Coming Soon)

Status: Submitted and under review by Anthropic. Once approved, you can install directly from the marketplace:

1. Open Claude Desktop.
2. Go to Settings → Extensions.
3. Search for "GetOutpost Financial Data".
4. Click Install.
5. Configure your credentials file path when prompted.

Option 2: Direct Download (.mcpb file)

Available Now! Download and install the extension bundle directly:

1. Download the latest release: [getoutpost - mcp - server - v1.0.0.mcpb](releases/getoutpost - mcp - server - v1.0.0.mcpb).
2. Double - click the downloaded .mcpb file, or
3. Drag and drop it into Claude Desktop, or
4. In Claude Desktop, go to Settings → Extensions → Install Extension and select the file.
5. Configure your credentials file path when prompted.

Option 3: NPM Global Installation

Install globally via npm:

npm install -g getoutpost-mcp-server

Then configure:

{
  "mcpServers": {
    "getoutpost": {
      "command": "getoutpost-mcp-stdio",
      "env": {
        "CREDENTIALS_FILE_PATH": "/absolute/path/to/.getoutpost_credentials.json"
      }
    }
  }
}

Getting GetOutpost Credentials

1. Sign up at GetOutpost.in.
2. Log in and obtain your access token and refresh token from dev tools.
3. Create a credentials file at ~/.getoutpost_credentials.json:

{
  "ACCESS_TOKEN": "your_access_token_here",
  "REFRESH_TOKEN": "your_refresh_token_here",
  "EMAIL": "your_email@example.com"
}

Note: The MCP server automatically refreshes your tokens and updates this file when tokens expire.

💻 Usage Examples

Basic Usage

Once installed, you can ask Claude questions like:

"Find stocks with high volatility risk premium for potential short vol strategies"

"What's the volatility skew pattern for NIFTY with 30 days to expiry?"

"Show me the top 10 stocks with the cheapest deep OTM puts"

"Analyze the implied vs realized volatility for RELIANCE using yang_zhang method"

Advanced Usage

Use the pre - built prompts in the Prompts menu in Claude Desktop for guided workflows.

📚 Documentation

Available Tools

The server provides 8 tools that Claude can use:

Data Retrieval Tools

Discovery/Filtering Tools

Available Prompts

Pre - built prompt templates to help you get started:

1. Find long volatility opportunities - Discover symbols where buying options makes sense (default: 30 DTE).
2. Find cheap OTM puts - Locate extremely cheap deep out - of - the - money puts for tail hedging (default: 29 DTE).
3. Find short volatility opportunities - Identify symbols for selling options strategies (default: 30 DTE).
4. Find optimal short vol conditions - Advanced filtering for moderately priced IV with healthy RV to avoid mean reversion (default: 25 DTE, ATM).

Recommended Claude Setup

For best results:

1. Create a Claude Project named "Options Insights".
2. Project Description: "Access real - time options market data and volatility analytics through GetOutpost's financial APIs. Analyze implied volatility, realized volatility, volatility risk premium, and skew across multiple instruments to generate data - driven trading insights."
3. Add Custom Instructions: Copy the content from and paste it into your project's custom instructions. This provides Claude with optimal guidance on how to use the tools effectively.
4. Use Claude Sonnet 4 for optimal analysis.
5. Start fresh chats when switching between different symbols or analysis types to avoid context length issues.

Understanding Key Parameters

• Moneyness: log(Forward/Strike) - Positive values = OTM puts, 0 = ATM, Negative = OTM calls.
• Days to Expiry (DTE): Calendar days until option expiration.
• Volatility Types:
  • c2c - Close - to - Close.
  • parkinson - Parkinson's range - based estimator.
  • garman_klass - Garman - Klass estimator.
  • rogers_satchell - Rogers - Satchell estimator.
  • yang_zhang - Yang - Zhang estimator.
  • mean - Average of all methods.
• Lookback Period: Days of historical data (20, 40, 60, or 80).

Token Management

The server handles authentication automatically:

1. Detects when your access token expires (401 error).
2. Uses your refresh token to obtain new credentials.
3. Updates your credentials file with the new tokens.
4. Retries the failed request seamlessly. You never need to manually refresh tokens.

🔧 Technical Details

Building from Source

# Clone the repository
git clone https://github.com/aoutpost2-rgb/mcp-server.git
cd mcp-server

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev:stdio

Running Tests

npm test

Project Structure

├── api/              # API client implementation
├── auth/             # Authentication and token management
├── dist/             # Compiled JavaScript (generated)
├── extension/        # MCP extension bundle
├── mcp_server.ts     # HTTP server implementation
├── mcp_server_stdio.ts  # Stdio server implementation
├── mcp_spec.ts       # MCP protocol handlers and tool definitions
└── tests/            # Test files

📄 License

This project is under the MIT License. See LICENSE file for details.

Support

• Issues: GitHub Issues
• GetOutpost Support: GetOutpost.in
• MCP Documentation: Model Context Protocol

Acknowledgments

Built with the Model Context Protocol SDK by Anthropic.

Disclaimer: This tool is for informational and educational purposes only. Always conduct your own research and consult with financial advisors before making trading decisions.