GetOutpost MCP Server

A Model Context Protocol (MCP) server that brings real-time Indian options market data and volatility analytics from GetOutpost.in into your AI chats.

What is this?

This MCP server enables Claude to analyze options market data including:

• Implied Volatility (IV) - Options pricing and market expectations
• Realized Volatility (RV) - Historical price movement metrics (Close-to-Close, Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang)
• Volatility Risk Premium (VRP) - IV divided by RV
• Skew Analysis - Volatility smile/smirk patterns across strike prices

Perfect for quantitative analysis, options trading research, and data-driven trading insights on Indian markets (NSE, BSE).

Installation

Option 1: Claude Desktop Extension Marketplace (Coming Soon)

Status: Submitted and under review by Anthropic

Once approved, you'll be able to 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-v2.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": "[email protected]"
}

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

Available Tools

The server provides 11 tools that Claude can use:

Data Retrieval Tools

| Tool | Description | |------|-------------| | get_iv | Get implied volatility data for specific symbols | | get_vol | Get realized volatility data using various calculation methods | | get_vrp | Get volatility risk premium (IV minus RV) | | get_skew | Get volatility skew patterns across strikes |

Discovery/Filtering Tools

| Tool | Description | |------|-------------| | filter_quick_rules_iv_percentile | Find symbols by IV percentile range | | filter_quick_rules_rv_percentile | Find symbols by RV percentile range | | filter_quick_rules_vrp_percentile | Find symbols by VRP percentile range | | filter_quick_rules_skew_percentile | Find symbols by skew percentile range |

Opportunity Scanner Tools

| Tool | Description | |------|-------------| | scan_short_vol_atm_straddles | Scan for short volatility opportunities using ATM straddles (elevated IV vs historical/peers) | | scan_cheap_tail_risk_hedges | Scan for cheap tail risk hedges - far OTM puts for portfolio protection | | scan_directional_trades_naked_options | Scan for directional trading opportunities using naked calls or puts |

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)
5. Find cheap directional trades - Scan for cheap directional trade opportunities using naked options
6. Find top short vol straddles - Identify the best short volatility opportunities using ATM straddles
7. Find cheap hedges - Discover cheap tail risk hedges currently available for portfolio protection

Access these via the Prompts menu in Claude Desktop.

Example 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"

"Are there any cheap directional trade opportunities available?"

"Give me the top short volatility opportunities right now"

"What are some cheap hedges that are currently available?"

Or use the pre-built prompts for guided workflows.

Recommended Setup

For best results:

1. Create a 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: Choose the appropriate system prompt for your AI assistant:
   • For Claude: Copy content from system_prompt_claude.md (comprehensive version)
   • For Perplexity: Copy content from system_prompt_perplexity.md (condensed, <1500 chars)
4. Use Claude Sonnet 4 (or equivalent) 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.

Development

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

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

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.