Céu Natal
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Céu Natal Calcule meu mapa natal: 12/03/1990, 14:30, Belo Horizonte, MG"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Céu Natal
Servidor MCP que calcula mapas astrais com efemérides suíças para o seu assistente de IA interpretar.
In English. Céu Natal is an open-source Model Context Protocol server that computes
natal charts, synastry, transits, progressions and solar/lunar returns with the Swiss
Ephemeris, answering in Portuguese. A free public endpoint runs at
https://astrologia-mcp.gustavocancado.com.br/mcp/ (no sign-up). Licensed AGPL-3.0.
Setup for Claude, ChatGPT, Claude Code and Cursor in English:
https://mistico.gustavocancado.com.br/en. Quick start in Claude Code:
claude mcp add --transport http --scope user ceu-natal https://astrologia-mcp.gustavocancado.com.br/mcp/.
Por que existe
Peça um mapa astral a um assistente de IA e ele responde com segurança, mas as posições costumam ser inventadas: o modelo não tem efemérides, então chuta o signo da Lua e o ascendente. Este servidor faz a conta de verdade e devolve os números; a IA só interpreta.
Related MCP server: stellara-mcp
Use agora
Endpoint MCP público e gratuito (Streamable HTTP, sem login):
https://astrologia-mcp.gustavocancado.com.br/mcp/Passo a passo para Claude, ChatGPT, Gemini, Manus, Cursor e n8n: https://mistico.gustavocancado.com.br/#conectar.
O que calcula
Tool | O que faz |
| Posições, casas, ângulos, aspectos, nodos, Quíron e síntese de um mapa natal. |
| Aspectos cruzados entre duas pessoas e planetas de uma nas casas da outra. |
| Posições numa data, aspectos com o mapa natal e destaque dos trânsitos lentos. |
| Progressões secundárias (1 dia = 1 ano), com Lua e Sol progredidos. |
| Mapa composto de duas pessoas pelo método de midpoints. |
| Mapa do retorno do Sol à posição natal num ano, com local da revolução. |
| Próximo retorno da Lua à posição natal a partir de uma data. |
| Aspectos suportados, com ângulos, orbes e natureza. |
| Status e versão do servidor. |
Entrada de pessoa: data (DD/MM/YYYY, obrigatória), hora (HH:MM), local
("Cidade, UF" ou "Cidade, País"), nome, is_dst. No mapa natal sem hora, o cálculo usa 12:00 no
horário local, a Lua vem marcada como incerta (posicao_incerta, signo_pode_mudar) e
não saem casas nem ângulos. sistema_casas é opcional: P Placidus (padrão), K Koch,
W Whole Sign, E Equal, R Regiomontanus, C Campanus, O Porphyrius, B Alcabitus,
M Morinus, T Topocentric. GET /tools lista as tools e os nomes dos parâmetros; o inputSchema completo vem do
tools/list do MCP (qualquer cliente MCP mostra).
Exemplo
Pedido (tools/call):
{
"name": "calcular_mapa_natal",
"arguments": {"nome": "Ana", "data": "12/03/1990", "hora": "14:30", "local": "Belo Horizonte, MG"}
}Trecho da resposta:
{
"planetas": {
"sol": {"signo": "Peixes", "grau": "21°52'", "grau_decimal": 21.8779, "posicao_absoluta": 351.8779,
"retrogrado": false, "elemento": "Agua", "qualidade": "Mutavel", "casa": 8},
"lua": {"signo": "Libra", "grau": "6°19'", "grau_decimal": 6.329, "posicao_absoluta": 186.329,
"retrogrado": false, "elemento": "Ar", "qualidade": "Cardinal", "casa": 3}
},
"angulos": {
"ascendente": {"signo": "Cancer", "grau": "18°38'", "grau_decimal": 18.6412, "posicao_absoluta": 108.6412}
},
"aspectos": [
{"planeta_a": "lua", "planeta_b": "venus", "tipo": "trigono", "orbe": 0.48,
"aplicando": true, "exato": true, "natureza": "harmonico"}
],
"local_resolvido": {"lat": -19.9167, "lng": -43.9333, "fuso": "America/Sao_Paulo"}
}A resposta completa traz também os outros planetas, as 12 casas, meio do céu, descendente, fundo do céu, pontos sensíveis e a síntese (elementos, qualidades, hemisférios, stelliums).
Rodar local
Com Docker:
cp .env.example .env
docker compose up --build # http://localhost:8000Com pip (Linux ou macOS; no Windows, use o WSL, porque o pyswisseph não compila nele):
python3.11 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
uvicorn app.server:app --port 8000Por stdio, para cliente que só abre processo local: python -m app.stdio (mesmas variáveis de ambiente).
Rotas: /mcp/ (MCP Streamable HTTP), /health,
/tools (lista de tools; pública quando MCP_API_KEY está vazia), /llms.txt,
/mapa-rapido (formulário do site) e / (redireciona para PUBLIC_SITE_URL).
Para desenvolver, instale também requirements-dev.txt e rode ruff check ., mypy app e
python -m pytest -q. Detalhes em CONTRIBUTING.md.
Variáveis de ambiente
Variável | Default | Descrição |
|
| nome devolvido no |
|
| versão exposta |
| (vazio) | se definida, exige |
| (vazio) | hosts aceitos no |
|
| chamadas de tool por minuto por sessão MCP (0 desliga) |
|
| chamadas de tool por minuto no total (0 desliga) |
|
| pedidos ao |
|
| pedidos ao |
|
| destino do redirect de |
| (vazio = | origens aceitas pelo CORS do |
| (vazio) — sem ele só o Nominatim é usado | conta GeoNames da geocodificação (crie a sua, gratuita, em geonames.org) |
|
| User-Agent enviado ao Nominatim (OSM) |
|
| intervalo mínimo (s) entre chamadas ao Nominatim |
|
| teto de chamadas simultâneas aos provedores de geocodificação |
|
| espera máxima (s) por uma vaga nesse teto; depois, erro |
|
| cache persistente de coordenadas; no Docker, volume em |
| vazio (desliga o | arquivo JSONL dos contatos para novidades deixados no site; em produção, |
| vazio (desliga o | SQLite das estatísticas agregadas de uso (página de status); em produção, |
| vazio (nada é guardado) | SQLite dos mapas feitos no formulário do site (data, hora, cidade), ligados ao id anônimo do navegador e ao contato; em produção, |
| vazio ( | token Bearer das rotas |
Site (web/)
O site de apresentação (https://mistico.gustavocancado.com.br) é um app Next.js 16
separado, com imagem Docker própria (web/Dockerfile). Para rodar:
cd web && pnpm install && pnpm dev; as URLs vêm de web/.env.example.
Precisão e limites
Efemérides: Swiss Ephemeris, da Astrodienst AG, via Kerykeion e pyswisseph. Zodíaco tropical.
Latitude acima de 66°: o cálculo de casas não é confiável perto dos polos. O mapa natal sai sem casas nem ângulos, com aviso; trânsitos, progressões e revoluções recusam.
Anos: datas de 1800 a 2399 (a faixa da efeméride de Quíron); revolução solar de 1800 a 2200.
Horário de verão: se a hora cai na transição (ambígua ou inexistente), o servidor devolve erro pedindo
is_dst(true= horário de verão,false= padrão).Sem hora de nascimento: cálculo às 12:00 locais; a Lua pode estar antes ou depois até metade do movimento diário dela (em geral de 6° a 7,6°, devolvido em
margem_graus), e o resultado diz quando o signo dela pode mudar.Limites do endpoint público: 30 chamadas por minuto por sessão e 600 por minuto no total. Nada do que chega pelo MCP é armazenado (os mapas do formulário do site ficam guardados); veja a política de privacidade.
Contribuir
Issues e pull requests são bem-vindos. Veja CONTRIBUTING.md; para falhas de segurança, SECURITY.md.
Licença
AGPL-3.0-or-later. A AGPL vale também para uso pela rede: quem oferecer este servidor como serviço modificado precisa publicar o código. O endpoint público roda exatamente o código deste repositório.
Copyright (C) 2026 Gustavo Cançado. Créditos e licenças de terceiros em NOTICE.
A escolha segue as dependências: o Kerykeion é AGPL-3.0, e o pyswisseph (Swiss Ephemeris)
é distribuído sob AGPL-3.0 ou sob a licença profissional paga da Astrodienst. Um uso fora
dos termos da AGPL exigiria a licença profissional da Swiss Ephemeris e trocar o
Kerykeion. O site usa os pacotes @beeads/*, sob licença MIT, compatível
com a AGPL.
Available Tools
9 toolscalcular_mapa_compostoMapa compostoARead-onlyIdempotentInspect
Calcula o mapa composto (composite chart) de duas pessoas pelo método de midpoints — o mapa da 'relação como entidade'. Diferente da sinastria, que compara dois mapas, o composto cria um terceiro mapa a partir dos pontos médios das longitudes planetárias. Retorna posições compostas, ângulos (ASC e MC compostos quando ambas as pessoas têm hora+local), aspectos internos do composto e síntese de elementos. Não retorna casas — composto por midpoint não tem instante/local definidos.
Inputs: pessoa_a (required), pessoa_b (required), sistema_casas.
calcular_mapa_natalMapa natalARead-onlyIdempotentInspect
Calcula o mapa astral natal completo de uma pessoa. Retorna posições planetárias, casas (Placidus por padrão; sistema configurável), ângulos, aspectos entre planetas, pontos sensíveis (nodos verdadeiros e Quíron) e síntese (elementos, qualidades, hemisférios, stelliums). Se hora ou local forem omitidos, retorna apenas posições por signo, sem casas nem ângulos. Sem hora, o cálculo usa 12:00 no horário local e a Lua vem marcada como incerta (posicao_incerta, signo_pode_mudar).
Inputs: data (required), hora, nome, local, +2 more.
calcular_progressoesProgressões secundáriasARead-onlyIdempotentInspect
Calcula as progressões secundárias (técnica 'um dia = um ano') de um mapa natal para uma data alvo. Retorna posições progredidas, aspectos entre planetas progredidos e natais, destaque para Lua progredida (fase emocional atual, ~2.5 anos por signo), Sol progredido (capítulo de vida, ~30 anos por signo), e sinaliza ingressos recentes e mudanças iminentes de signo.
Inputs: natal (required), data_alvo (required), sistema_casas.
calcular_revolucao_lunarRevolução lunarARead-onlyIdempotentInspect
Calcula a revolução lunar (lunar return) — o mapa do instante exato em que a Lua retorna à longitude que ocupava no nascimento, técnica de previsão mensal com ciclo de ~27,3 dias. Retorna o primeiro retorno lunar a partir da data de referência informada, com mapa completo, aspectos com o natal, sobreposição dos dois mapas e destaques centrados na Lua: casa que ela ocupa, ascendente da revolução e seus regentes, planetas angulares. Exige hora e local de nascimento. O parâmetro local_revolucao é obrigatório.
Inputs: natal (required), data_referencia (required), local_revolucao (required), sistema_casas.
calcular_revolucao_solarRevolução solarARead-onlyIdempotentInspect
Calcula a revolução solar (solar return) de um ano — o mapa do instante exato em que o Sol retorna à longitude que ocupava no nascimento, técnica de previsão anual. Rege o período até a revolução seguinte. Retorna o mapa completo da revolução (planetas, casas, ângulos, aspectos internos), os aspectos entre a revolução e o mapa natal, a sobreposição dos dois mapas e destaques da leitura: ascendente da revolução e seus regentes, casa ocupada pelo Sol e planetas angulares. Exige hora e local de nascimento. O parâmetro local_revolucao é obrigatório e define ascendente, meio do céu e casas — as posições planetárias são as mesmas em qualquer lugar do mundo.
Inputs: ano (required), natal (required), local_revolucao (required), sistema_casas.
calcular_sinastriaSinastriaARead-onlyIdempotentInspect
Calcula a sinastria entre duas pessoas: aspectos cruzados (planetas de A vs planetas de B), em quais casas do mapa de uma cada planeta da outra cai, e síntese com contagem de aspectos harmônicos / tensão / neutros. Útil para análise de relacionamento.
Inputs: pessoa_a (required), pessoa_b (required), sistema_casas.
calcular_transitosTrânsitosARead-onlyIdempotentInspect
Calcula os trânsitos planetários para uma data específica em relação a um mapa natal. Retorna a posição atual dos planetas, aspectos entre planetas em trânsito e planetas natais (com aplicando/separando), em qual casa natal cada planeta em trânsito está caindo, e síntese com destaque para trânsitos de planetas lentos (Saturno, Urano, Netuno, Plutão e Quíron) com orbe < 2°.
Inputs: natal (required), data_transito (required), hora_transito, sistema_casas, +1 more.
healthcheckVerificar o servidorARead-onlyIdempotentInspect
Verifica se o servidor está operacional e retorna a versão.
Inputs: no named parameters. Returns: status, versao, transporte, codigo_fonte, +1 more
listar_aspectos_tiposTipos de aspectoARead-onlyIdempotentInspect
Retorna os tipos de aspectos suportados pelo servidor com seus ângulos, orbes padrão (e orbes ampliados quando há luminar), e natureza (harmônico, tensão ou neutro).
Inputs: no named parameters. Returns: aspectos
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a clearly distinct astrological calculation or support function. The overlap-prone pair sinastria vs. mapa composto is explicitly differentiated, and solar/lunar returns are cleanly separated by technique and timeframe.
Most tools follow a clear verb_noun pattern in Portuguese, such as calcular_* and listar_*. The only deviation is healthcheck, which is a common utility name but breaks the otherwise consistent convention.
Nine tools is well within a focused, appropriate range for an astrology calculation server. Each calculation tool corresponds to a meaningful technique, with no obvious filler.
The surface covers the major astrological workflows: natal, synastry, transits, progressions, composite, and solar/lunar returns. Minor gaps such as standalone current-sky calculation without a natal reference or chart rendering are reasonable omissions rather than blocking holes.
Maintenance
Related MCP Connectors
Swiss Ephemeris for AI agents: exact natal charts, transits, synastry and birth-place resolution
Western natal charts, horoscopes, transits and synastry for AI agents, verified vs NASA JPL.
Vedic and Western astrology for AI agents: charts, dasha, matchmaking, panchanga, numerology, tarot.
Swiss Ephemeris astrology: natal charts, transits, synastry, solar returns and astrocartography.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceHigh-precision astrology tools for LLM agents, including natal charts, transits, progressions, synastry, and more, backed by Swiss Ephemeris.1MIT
- AlicenseAqualityBmaintenanceEnables AI agents to compute deterministic astrological data with Swiss Ephemeris, including natal charts, transits, synastry, and birth-place resolution, so they never invent planetary positions.464 npm1MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to retrieve precise astrology calculations, including natal charts, transits, composites, harmonic midpoints, and ranked daily aspects, using real ephemeris data rather than guesses.51AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to compute ephemeris-grade natal charts, current transits, and zodiac sign profiles through deterministic astrology tools.MIT