Model Context Protocol

A Occult API dentro do seu assistente de IA

Conecte o Claude, o Cursor ou qualquer assistente compatível com MCP a dados reais de efemérides. Peça um panchanga, um kundli ou um dasha com suas próprias palavras e receba um cálculo de verdade, e não uma invenção com cara de resposta certa.

você:  Qual é o panchanga de Jaipur amanhã ao nascer do sol?

       → tithi Chaturthi (Krishna paksha), yoga Vriddhi, karana Balava

Antes de começar

Você precisa de uma chave de API. Crie uma conta e gere a chave na página de chaves. Ela aparece uma única vez, então copie antes de sair. Fora isso, só é preciso ter o Node 18 ou mais recente; o npx baixa o resto na primeira execução.

Configure

Todos os clientes usam o mesmo bloco. Adicione-o ao arquivo indicado abaixo. Se o arquivo já tiver uma seção mcpServers, coloque occult-api dentro dela em vez de criar outra.

{
  "mcpServers": {
    "occult-api": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

Claude Code (VS Code)~/.claude.jsonC:Users<you>.claude.json no Windows

Claude Desktopclaude_desktop_config.json%APPDATA%Claude no Windows, ~/Library/Application Support/Claude/ no macOS

Cursor~/.cursor/mcp.json

Depois, feche e abra o app de novo. Os servidores MCP se conectam na inicialização, então recarregar a janela não basta.

Ou pelo terminal

Se você tem a linha de comando do Claude Code instalada, este comando faz tudo em um passo só. Ele não funciona na extensão do VS Code, que não tem o comando claude; nesse caso, use o arquivo de configuração acima.

claude mcp add occult-api -e OCCULT_API_KEY=yt_live_your_key_here -- npx -y occult-api-mcp

O que o assistente consegue fazer

Cinco ferramentas cobrem os 299 endpoints e os 330 cálculos. Não criamos uma ferramenta por endpoint, de propósito: toda ferramenta ocupa o contexto do modelo em cada mensagem, e 299 delas lotariam a conversa antes de você perguntar qualquer coisa. Em vez disso, o assistente faz uma busca.

check_accountGrátis

Confirma que a chave funciona e mostra o saldo de créditos. Se algo falhar, peça ao assistente para rodar esta primeiro: ela separa uma chave inválida de um saldo zerado.

search_endpointsGrátis

Encontra um cálculo pelo nome ou pela função. “manglik” dá resultado mesmo sem existir um endpoint com esse nome, porque a busca cobre todos os cálculos, e não só os nomes dos endpoints.

describe_endpointGrátis

Os campos exatos da requisição, os valores que cada um aceita e um corpo de requisição comprovado em um servidor real.

call_endpoint1–25 créditos

Roda qualquer endpoint pelo preço dele: um crédito na maioria, 25 nos relatórios em PDF e no chat com IA. Requisições que falham não são cobradas.

get_panchanga1 crédito

Um atalho próprio para a requisição mais comum, para o assistente não precisar procurá-la antes.

Quanto custa

Exatamente o mesmo que uma chamada HTTP direta: um crédito por cálculo bem-sucedido (25 para relatórios em PDF e chat com IA) e nada por requisição que falha. Buscar e ler a documentação é grátis, então o assistente pode explorar a API inteira sem gastar nada. O saldo volta em toda chamada, e você recebe um aviso quando ele fica abaixo de 50 créditos.

Sobre a sua chave

A chave fica na sua máquina. Ela é lida das variáveis de ambiente, enviada à API em um cabeçalho e nunca é mostrada ao modelo: o assistente vê os resultados, nunca a credencial.

Mesmo assim, é uma credencial de servidor: quem tiver a chave pode gastar os seus créditos. Não coloque a chave em configurações nem repositórios compartilhados, e troque-a na página de chaves se achar que ela vazou.

Se algo der errado

“Your Occult API key is invalid, revoked, or expired”: Crie uma chave nova, atualize o bloco env e reinicie o app. Os servidores MCP leem o ambiente uma vez só, na inicialização.
“claude” não é reconhecido como comando: Você está usando a extensão do VS Code, que não instala o comando claude. Use o arquivo de configuração acima: ele faz exatamente a mesma coisa.
O servidor nem aparece: Confira se o JSON é válido e reinicie o app por completo. Os erros de inicialização vão para o log de MCP do cliente, e não para o chat.
O assistente não encontra um cálculo: Tente o nome em sânscrito: “kundli” em vez de “mapa natal”. Todos os cálculos estão na referência.

Pegar uma chave de API Ver no npm Código no GitHub