# Céu Natal

> Céu Natal is an open-source MCP server for astrology. Swiss Ephemeris birth charts, synastry and transits inside your AI chat, in Portuguese. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API
- **Website:** https://mistico.gustavocancado.com.br
- **Repository:** https://github.com/gucancado/ceu-natal
- **MCP Registry name:** io.github.gucancado/ceu-natal
- **Categories:** astrology
- **Listing updated:** 2026-11-14

## About

Language models tend to invent the Moon sign and the ascendant because they carry no ephemeris. Céu Natal moves that arithmetic out of the model: the server does the calculation with the Swiss Ephemeris and returns numbers, and the assistant only interprets them.

It calculates natal charts, synastry between two people, transits, secondary progressions, composite charts (midpoint method), and solar and lunar returns, with answers in Portuguese. Birth place is given as "City, State" or "City, Country" and is resolved to coordinates and a historical time zone. Ten house systems are supported, with Placidus as default. Without a birth time the chart gives sign positions only, and the Moon is flagged as uncertain.

A free public Streamable HTTP endpoint needs no sign-up, and the README names Claude, ChatGPT, Gemini, Manus, Cursor and n8n as clients. The author says it is in beta, and the code is AGPL-3.0.

## Features

- **Swiss Ephemeris maths:** Positions come from a real ephemeris instead of model guesses.
- **Natal chart:** Planets, houses, angles, aspects, nodes, Chiron and a synthesis.
- **Synastry:** Cross aspects and house placements between two charts.
- **Transits and progressions:** Compare a date's sky with a natal chart, or progress it one day per year.
- **Returns and composite:** Solar and lunar returns and midpoint composite charts.
- **Ten house systems:** Placidus, Koch, Whole Sign and seven more.
- **Uncertain Moon flag:** Charts without a birth time mark the Moon position as uncertain.

## Good for

- Check which transits are active on a given date
- Compare two people's charts for compatibility
- Work out a solar return chart for the coming year
- Get accurate planetary positions before asking an AI to interpret them

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http ceu-natal https://astrologia-mcp.gustavocancado.com.br/mcp/
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://astrologia-mcp.gustavocancado.com.br/mcp/
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ceu-natal": {
      "url": "https://astrologia-mcp.gustavocancado.com.br/mcp/"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ceu-natal": {
      "type": "http",
      "url": "https://astrologia-mcp.gustavocancado.com.br/mcp/"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ceu-natal": {
      "serverUrl": "https://astrologia-mcp.gustavocancado.com.br/mcp/"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "ceu-natal": {
      "type": "http",
      "url": "https://astrologia-mcp.gustavocancado.com.br/mcp/"
    }
  }
}
```

## Tools

- `calcular_mapa_natal`: 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á
- `calcular_sinastria`: 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.
- `calcular_transitos`: 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°.
- `calcular_progressoes`: 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.
- `calcular_mapa_composto`: 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 elem
- `calcular_revolucao_solar`: 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
- `calcular_revolucao_lunar`: 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 
- `listar_aspectos_tipos`: 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).
- `healthcheck`: Verifica se o servidor está operacional e retorna a versão.

## FAQ

### Is it free?

Yes. The public endpoint is free and needs no sign-up; the author describes it as a beta.

### What if I do not know the birth time?

The chart then uses 12:00 local time, gives sign positions only with no houses or angles, and marks the Moon as uncertain.

### Which house systems work?

Placidus (default), Koch, Whole Sign, Equal, Regiomontanus, Campanus, Porphyrius, Alcabitus, Morinus and Topocentric.

### Which language does it answer in?

Portuguese.

### Is Céu Natal free?

Yes. Céu Natal is open source, so you can use and self-host it for free.

### How do I add Céu Natal to Claude Code?

Run this command in your terminal: claude mcp add --transport http ceu-natal https://astrologia-mcp.gustavocancado.com.br/mcp/

### What are the best alternatives to Céu Natal?

The closest alternatives to Céu Natal are Natal Chart Lab, VedicDost: Vedic Astrology, Kundli & AI Astrologer, AstroLogics, GenesisCore Astrology (Western + Vedic) and OIYO Korea Calculators.

## Alternatives

- [Natal Chart Lab](https://ai-powered.com/mcp/natal-chart-lab): Natal Chart Lab is an open-source MCP server for astrology.
- [VedicDost: Vedic Astrology, Kundli & AI Astrologer](https://ai-powered.com/mcp/vedicdost-vedic-astrology-kundli-and-ai-astrologer): VedicDost: Vedic Astrology, Kundli & AI Astrologer is a free MCP server for astrology.
- [AstroLogics](https://ai-powered.com/mcp/astrologics): AstroLogics is a freemium MCP server for astrology.
- [GenesisCore Astrology (Western + Vedic)](https://ai-powered.com/mcp/genesiscore-astrology-western-vedic): GenesisCore Astrology (Western + Vedic) is a free MCP server for astrology.
- [OIYO Korea Calculators](https://ai-powered.com/mcp/oiyo-korea-calculators): OIYO Korea Calculators is a free MCP server for finance and payments.
- [Moon Phase Software](https://ai-powered.com/mcp/moon-phase-software): Moon Phase Software is a free MCP server for astrology.
- [Zodiac Compatibility](https://ai-powered.com/mcp/zodiac-compatibility): Zodiac Compatibility is a free MCP server for astrology.
- [Get Chinese Astrology](https://ai-powered.com/mcp/get-chinese-astrology): Get Chinese Astrology is a free MCP server for astrology.

---
Source: https://ai-powered.com/mcp/ceu-natal
