Ir para o conteúdo

Replit + Occult API

Adicione o servidor MCP a um Repl pelo painel Integrations — sem arquivo de configuração. A configuração leva uns dois minutos, e o servidor roda localmente — sua chave nunca sai da sua máquina.

O que você ganha

O servidor MCP expõe 299 endpoints de astrologia como ferramentas que o Replit Agent pode chamar. Em vez de você descrever uma API e torcer para o modelo acertar a requisição, ele 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 treino.

Buscar e ler schemas não custa nada. Só uma chamada bem-sucedida a call_endpoint gasta crédito, e chamadas que falham são gratuitas.

1. Gere uma chave

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 em código que roda no cliente, nunca num commit.

Criar chave de API

2. Adicione o servidor

O Replit não tem arquivo de configuração MCP — é a única ferramenta da nossa lista em que não há nada para colar nem para commitar. Adicione o servidor pela interface:

Replit Agent → Integrations → Add MCP server

Informe o comando npx com os argumentos -y occult-api-mcp e defina a variável de ambiente OCCULT_API_KEY com a sua chave.

3. Confira a conexão

Pergunte ao Replit Agent:

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

Devem aparecer cinco ferramentas:

  • search_endpoints
  • describe_endpoint
  • call_endpoint
  • get_panchanga
  • check_account

Se a lista vier vazia, o servidor não iniciou. A causa mais comum é o arquivo de configuração estar no lugar certo, mas com o formato errado — então confira primeiro o nome da chave acima.

4. Um primeiro prompt que vale testar

prompt
Use o servidor MCP occult-api para criar uma pequena página em Flask que mostre o panchanga de hoje para a cidade que o visitante digitar.

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 os dados de treino — diga “use as ferramentas do occult-api” e ele vai usar.

Bom saber sobre o Replit

  • O Replit é a única ferramenta aqui SEM arquivo de configuração. Tudo é feito pelo painel Integrations, então não há nada para colar nem para commitar.
  • Guarde a chave de API como Secret do Replit, em vez de digitá-la no painel, para ela não ir junto quando alguém fizer fork do Repl.
  • O fork de um Repl não leva os seus Secrets. Quem faz o fork usa a própria chave — o que, em geral, é o que você quer.

Se preferir não usar MCP

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

curl
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 numa só requisição, cobrados como um crédito. Chamar quatro vezes custa quatro.

Outras ferramentas

Próximos passos