GetOutPost MCP Server

Servidor MCP GetOutpost

Um servidor Model Context Protocol (MCP) que traz dados em tempo real do mercado de opções indiano e análises de volatilidade do GetOutpost.in para seus chats de IA.

O que é isso?

Este servidor MCP permite que o Claude analise dados do mercado de opções, incluindo:

• Volatilidade Implícita (IV) - Precificação de opções e expectativas do mercado
• Volatilidade Realizada (RV) - Métricas históricas de movimento de preço (Close-to-Close, Parkinson, Garman-Klass, Rogers-Satchell, Yang-Zhang)
• Prêmio de Risco de Volatilidade (VRP) - IV dividido pela RV
• Análise de Skew - Padrões de sorriso/sorriso invertido de volatilidade entre preços de exercício

Perfeito para análise quantitativa, pesquisa de negociação de opções e insights de negociação baseados em dados nos mercados indianos (NSE, BSE).

Instalação

Opção 1: Marketplace de Extensões do Claude Desktop (Em breve)

Status: Enviado e em análise pela Anthropic

Assim que aprovado, você poderá instalar diretamente do marketplace:

1. Abra o Claude Desktop
2. Vá para Configurações → Extensões
3. Pesquise por "GetOutpost Financial Data"
4. Clique em Instalar
5. Configure o caminho do arquivo de credenciais quando solicitado

Opção 2: Download Direto (arquivo .mcpb)

Disponível agora! Baixe e instale o pacote de extensão diretamente:

1. Baixe a versão mais recente: getoutpost-mcp-server-v2.0.0.mcpb
2. Clique duas vezes no arquivo .mcpb baixado, ou
3. Arraste e solte no Claude Desktop, ou
4. No Claude Desktop, vá para Configurações → Extensões → Instalar Extensão e selecione o arquivo
5. Configure o caminho do arquivo de credenciais quando solicitado

Opção 3: Instalação Global via NPM

Instale globalmente via npm:

npm install -g getoutpost-mcp-server

Depois configure:

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

Obtendo Credenciais do GetOutpost

1. Cadastre-se em GetOutpost.in
2. Faça login e obtenha seu token de acesso e token de atualização nas ferramentas de desenvolvedor.
3. Crie um arquivo de credenciais em ~/.getoutpost_credentials.json:

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

Nota: O servidor MCP atualiza automaticamente seus tokens e atualiza este arquivo quando os tokens expiram.

Ferramentas Disponíveis

O servidor fornece 11 ferramentas que o Claude pode usar:

Ferramentas de Recuperação de Dados

Ferramenta	Descrição
get_iv	Obter dados de volatilidade implícita para símbolos específicos
get_vol	Obter dados de volatilidade realizada usando vários métodos de cálculo
get_vrp	Obter prêmio de risco de volatilidade (IV menos RV)
get_skew	Obter padrões de skew de volatilidade entre preços de exercício

Ferramentas de Descoberta/Filtragem

Ferramenta	Descrição
filter_quick_rules_iv_percentile	Encontrar símbolos por faixa de percentil de IV
filter_quick_rules_rv_percentile	Encontrar símbolos por faixa de percentil de RV
filter_quick_rules_vrp_percentile	Encontrar símbolos por faixa de percentil de VRP
filter_quick_rules_skew_percentile	Encontrar símbolos por faixa de percentil de skew

Ferramentas de Scanner de Oportunidades

Ferramenta	Descrição
scan_short_vol_atm_straddles	Buscar oportunidades de venda de volatilidade usando straddles ATM (IV elevado vs. histórico/pares)
scan_cheap_tail_risk_hedges	Buscar hedge barato para risco de cauda - puts OTM distantes para proteção de portfólio
scan_directional_trades_naked_options	Buscar oportunidades de negociação direcionais usando calls ou puts descobertos

Prompts Disponíveis

Modelos de prompt pré-construídos para ajudar você a começar:

1. Encontrar oportunidades de volatilidade longa - Descubra símbolos onde comprar opções faz sentido (padrão: 30 DTE)
2. Encontrar puts OTM baratos - Localize puts profundamente fora do dinheiro extremamente baratos para hedge de cauda (padrão: 29 DTE)
3. Encontrar oportunidades de volatilidade curta - Identifique símbolos para estratégias de venda de opções (padrão: 30 DTE)
4. Encontrar condições ideais de vol curta - Filtragem avançada para IV moderadamente precificado com RV saudável para evitar reversão à média (padrão: 25 DTE, ATM)
5. Encontrar negociações direcionais baratas - Busque oportunidades de negociação direcional baratas usando opções descobertas
6. Encontrar os melhores straddles de vol curta - Identifique as melhores oportunidades de venda de volatilidade usando straddles ATM
7. Encontrar hedges baratos - Descubra hedges de risco de cauda baratos atualmente disponíveis para proteção de portfólio

Acesse estes pelo menu Prompts no Claude Desktop.

Exemplo de Uso

Após a instalação, você pode fazer perguntas ao Claude como:

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

Ou use os prompts pré-construídos para fluxos de trabalho guiados.

Configuração Recomendada

Para melhores resultados:

1. Crie um Projeto chamado "Options Insights"
2. Descrição do Projeto: "Acesse dados em tempo real do mercado de opções e análises de volatilidade através das APIs financeiras do GetOutpost. Analise volatilidade implícita, volatilidade realizada, prêmio de risco de volatilidade e skew em múltiplos instrumentos para gerar insights de negociação baseados em dados."
3. Adicione Instruções Personalizadas: Escolha o prompt de sistema apropriado para seu assistente de IA:
   • Para Claude: Copie o conteúdo de system_prompt_claude.md (versão abrangente)
   • Para Perplexity: Copie o conteúdo de system_prompt_perplexity.md (condensado, <1500 caracteres)
4. Use Claude Sonnet 4 (ou equivalente) para análise ideal
5. Inicie chats novos ao alternar entre diferentes símbolos ou tipos de análise para evitar problemas de comprimento de contexto

Entendendo os Parâmetros Principais

• Moneyness: log(Forward/Strike) - Valores positivos = puts OTM, 0 = ATM, Negativos = calls OTM
• Dias para Expiração (DTE): Dias corridos até a expiração da opção
• Tipos de Volatilidade:
  • c2c - Close-to-Close
  • parkinson - Estimador baseado em amplitude de Parkinson
  • garman_klass - Estimador Garman-Klass
  • rogers_satchell - Estimador Rogers-Satchell
  • yang_zhang - Estimador Yang-Zhang
  • mean - Média de todos os métodos
• Período de Retrospecção: Dias de dados históricos (20, 40, 60 ou 80)

Gerenciamento de Tokens

O servidor lida com a autenticação automaticamente:

1. Detecta quando seu token de acesso expira (erro 401)
2. Usa seu token de atualização para obter novas credenciais
3. Atualiza seu arquivo de credenciais com os novos tokens
4. Repete a solicitação que falhou de forma transparente

Você nunca precisa atualizar tokens manualmente.

Desenvolvimento

Compilando a partir do Código-Fonte

# 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

Executando Testes

npm test

Estrutura do Projeto

├── 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

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.

Suporte

• Problemas: GitHub Issues
• Suporte GetOutpost: GetOutpost.in
• Documentação MCP: Model Context Protocol

Agradecimentos

Construído com o Model Context Protocol SDK da Anthropic.

---

Aviso Legal: Esta ferramenta é apenas para fins informativos e educacionais. Sempre conduza sua própria pesquisa e consulte consultores financeiros antes de tomar decisões de negociação.