Cursor + Occult API

O servidor MCP oferece 299 endpoints de astrologia como ferramentas que o Composer pode chamar. Em vez de você descrever uma API e torcer para o modelo escrever a requisição certa, o agente busca no catálogo, lê o schema real da requisição e faz a chamada. Assim, os números da resposta vêm das efemérides, e não dos dados de treinamento.

Buscar e ler schemas não custa nada. Só um call_endpoint bem-sucedido gasta crédito, e chamadas que falham são grátis.

Crie uma no painel. Ela tem o formato yt_live_… e dá acesso ao seu saldo de créditos, então trate-a como senha: nunca no código do cliente, nunca em um commit.

Criar chave de API

Abra ~/.cursor/mcp.json (no Windows: %USERPROFILE%\.cursor\mcp.json), crie o arquivo se ele não existir e adicione:

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

Se preferir não editar o arquivo à mão, a mesma configuração está em Settings → Cursor Settings → MCP → Add new global MCP server.

Troque yt_live_your_key_here pela sua chave real. Não precisa instalar mais nada: o npx baixa o servidor na primeira execução.

Peça ao Composer:

Liste as ferramentas que você tem do servidor occult-api.

A resposta deve trazer cinco ferramentas:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Se a lista vier vazia, o servidor não iniciou. O motivo mais comum é o arquivo de configuração estar no lugar certo, mas com o formato errado. Antes de tudo, confira o nome da chave indicado acima.

Usando o servidor MCP occult-api, busque o panchanga de hoje para Jaipur e me mostre o tithi, o nakshatra e o horário do rahu kaal. Agrupe as keys em uma única chamada.

O agente deve chamar a API, e não responder de memória. Se a resposta chegar na hora e sem nenhuma chamada de ferramenta, ele respondeu com base nos dados de treinamento. Diga “use as ferramentas do occult-api” e ele vai usar.

• Um `.cursor/mcp.json` no projeto tem prioridade sobre o global. É assim que você dá a um repositório a própria chave sem mexer na configuração da sua máquina.
• O Cursor recarrega os servidores MCP ao salvar. Se a lista de ferramentas não aparecer, desligue e ligue o servidor em Settings, em vez de reiniciar o editor.
• Coloque instruções fixas em `.cursor/rules/` em vez de repeti-las em todo prompt. Uma regra dizendo para agrupar as `keys`, em vez de fazer uma chamada por cálculo, já se paga na hora.

Os endpoints são HTTP comum. Nada nesta página é necessário para usá-los:

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H 'X-API-Key: yt_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "date_time": "2026-09-17T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana"]
  }'

Repare no array keys: quatro cálculos em uma requisição, cobrados como um crédito. Chamar quatro vezes custa quatro.