OpenEphemeris

Motor de astrologia/astronomia NASA JPL DE440: mapas natais, trânsitos, sinastria, timing elecional, Human Design, astrocartografia.

GitHub

Documentação

Servidor MCP OpenEphemeris

OpenEphemeris in Claude — ask in plain language, get a real computed chart

Use-o no Claude: adicione https://mcp.openephemeris.com/mcp como um conector personalizado (deixe o Client ID e o Secret do OAuth em branco) ou instale o plugin Open Ephemeris no diretório do Claude. O login acontece no navegador e cria uma conta gratuita com 150 créditos.

Servidor de Protocolo de Contexto de Modelo para OpenEphemeris — ferramentas de astrologia tipadas com base na efeméride NASA JPL DE440. Zero alucinação em posições planetárias, datas e graus. Cobre 1.100 anos de dados astronômicos.

The catalog: 90 bodies and 124 fixed stars — asteroids, trans-Neptunians, Uranian points, computed in one engine

Endpoint hospedado: https://mcp.openephemeris.com/mcp (HTTP Streamable, especificação MCP 2025-11-25)

Início Rápido

Instalar via Smithery (recomendado)

A maneira mais rápida de conectar qualquer cliente compatível com MCP:

npx -y @smithery/cli install @open-ephemeris/openephemeris --client claude

Ou navegue pela listagem e copie trechos de conexão: smithery.ai/servers/open-ephemeris/openephemeris

Conectar via AI SDK (Vercel AI SDK)

import Smithery from "@smithery/api"
import { createMCPClient } from "@ai-sdk/mcp"
import { generateText } from "ai"
import { anthropic } from "@ai-sdk/anthropic"
import { createConnection } from "@smithery/api/mcp"

const smithery = new Smithery()

const conn = await smithery.connections.create("{your-namespace}", {
  mcpUrl: "https://server.smithery.ai/open-ephemeris/openephemeris",
  headers: {
    apiKey: "your-openephemeris-api-key", // get one free at openephemeris.com/dashboard
  },
})

const { transport } = await createConnection({
  client: smithery,
  namespace: "{your-namespace}",
  connectionId: conn.connectionId,
})

const mcpClient = await createMCPClient({ transport })
const tools = await mcpClient.tools()

const { text } = await generateText({
  model: anthropic("claude-sonnet-4-20250514"),
  tools,
  prompt: "Calculate a natal chart for someone born April 15, 1990 at 2:30 PM in Chicago.",
})

await mcpClient.close()

Conectar via MCP SDK (TypeScript)

import Smithery from "@smithery/api"
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { createConnection } from "@smithery/api/mcp"

const smithery = new Smithery()

const conn = await smithery.connections.create("{your-namespace}", {
  mcpUrl: "https://server.smithery.ai/open-ephemeris/openephemeris",
  headers: {
    apiKey: "your-openephemeris-api-key",
  },
})

const { transport } = await createConnection({
  client: smithery,
  namespace: "{your-namespace}",
  connectionId: conn.connectionId,
})

const mcpClient = new Client(
  { name: "my-app", version: "1.0.0" },
  { capabilities: {} }
)
await mcpClient.connect(transport)

const { tools } = await mcpClient.listTools()
const result = await mcpClient.callTool({
  name: "ephemeris_natal_chart",
  // A datetime that states a clock time must state its zone: either pass
  // `timezone` alongside the local time, or put a Z/±HH:MM offset on the value.
  arguments: {
    datetime: "1990-04-15T14:30:00",
    timezone: "America/Chicago",
    latitude: 41.8781,
    longitude: -87.6298,
    format: "llm",
  },
})

Conectar diretamente (HTTP Streamable, sem Smithery)

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

const transport = new StreamableHTTPClientTransport(
  new URL("https://mcp.openephemeris.com/mcp"),
  { requestInit: { headers: { "X-API-Key": "your-openephemeris-api-key" } } }
)

const client = new Client({ name: "my-app", version: "1.0.0" }, { capabilities: {} })
await client.connect(transport)

Instalação com um clique (Cursor)

Substitua YOUR_API_KEY_HERE nas configurações de MCP do Cursor pela sua chave de API de https://openephemeris.com/dashboard.

Payload do deeplink do Cursor:

{
  "command": "npx",
  "args": [
    "-y",
    "@openephemeris/mcp-server"
  ],
  "env": {
    "OPENEPHEMERIS_PROFILE": "dev",
    "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
    "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
  }
}

Instalação manual (clientes MCP stdio)

{
  "mcpServers": {
    "openephemeris": {
      "command": "npx",
      "args": ["-y", "@openephemeris/mcp-server"],
      "env": {
        "OPENEPHEMERIS_PROFILE": "dev",
        "OPENEPHEMERIS_BACKEND_URL": "https://api.openephemeris.com",
        "OPENEPHEMERIS_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Guia de plataformas

Passo a passo detalhado de configuração para cada plataforma está em SETUP.md.

Cliente	Modo de instalação	Local da configuração
Smithery	Um clique	smithery.ai
Cursor	Deeplink de um clique ou manual	`~/.cursor/mcp.json`
Claude Desktop (macOS)	Manual	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	Manual	`%APPDATA%\Claude\claude_desktop_config.json`
Windsurf	Manual	`~/.codeium/windsurf/mcp_config.json` (ou legado `~/.codeium/mcp_config.json`)
ChatGPT	Um clique	Open Ephemeris no diretório de aplicativos do ChatGPT
Claude Web / clientes remotos	URL hospedada	`https://mcp.openephemeris.com/mcp`

Passo a passo de instalação por cliente

Cursor
- Clique no botão "Instalar no Cursor" acima e substitua YOUR_API_KEY_HERE nas configurações de MCP do Cursor.
- Se preferir configuração manual, cole o bloco mcpServers.openephemeris de "Instalação manual" em ~/.cursor/mcp.json.
Claude Desktop (macOS/Windows)
- Abra o arquivo de configuração da plataforma na tabela acima.
- Adicione o mesmo bloco mcpServers.openephemeris de "Instalação manual".
- Reinicie o Claude Desktop.
Windsurf
- Abra ~/.codeium/windsurf/mcp_config.json (ou o caminho legado ~/.codeium/mcp_config.json).
- Adicione o bloco mcpServers.openephemeris de "Instalação manual".
- Reinicie o Windsurf.

Clientes somente remotos (Claude Web, ChatGPT, etc.)

O servidor está hospedado em https://mcp.openephemeris.com/mcp com suporte completo a HTTP Streamable (especificação MCP 2025-11-25). Clientes somente remotos podem conectar diretamente — sem necessidade de ponte/proxy:

Claude Web: Adicione https://mcp.openephemeris.com/mcp como URL de conector personalizado — deixe o Client ID e o Secret do OAuth em branco. O servidor usa OAuth 2.1 + PKCE (Registro Dinâmico de Cliente), então o Claude lida com a autenticação via pop-up do navegador automaticamente.
ChatGPT: Open Ephemeris é um aplicativo aprovado no diretório de aplicativos do ChatGPT. Abra a listagem, clique em Instalar plugin, aprove o login (isso também cria sua conta gratuita no OpenEphemeris) e digite @Open Ephemeris em qualquer conversa. Os mapas são renderizados inline, exatamente como no Claude. Prefere configurar manualmente? Configurações → Plugins → Avançado → Modo desenvolvedor → + Criar aplicativo aceita https://mcp.openephemeris.com/mcp com Autenticação em OAuth — sem necessidade de inserir client ID ou secret.
Via Smithery: Use a listagem do Smithery para conexões gerenciadas com qualquer cliente
SSE legado: descontinuado na versão 3.20.0 — use HTTP Streamable em /mcp

Autenticação e comportamento de upgrade em clientes MCP

Credenciais ausentes/inválidas (401): a chamada de ferramenta falha com uma mensagem que orienta os usuários a se cadastrarem/entrarem em https://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount e depois criarem/gerenciarem chaves em https://openephemeris.com/dashboard?tab=account.
Endpoint restrito por nível (403): a chamada de ferramenta retorna uma mensagem de upgrade necessário com https://openephemeris.com/pay e link para gerenciamento de chaves/faturamento no painel.
Sem créditos (402): a chamada de ferramenta retorna um link de recarga em um toque (os 150 créditos gratuitos do Explorer são únicos e não são redefinidos; as cotas dos planos são renovadas a cada período de faturamento) além do link de uso no painel. Chamadas com falha (qualquer 4xx/5xx) são reembolsadas.
Limite de rajada/taxa (429): a chamada de ferramenta retorna orientações de nova tentativa e links para monitoramento de uso no painel.

O Que Você Pode Perguntar

"Calculate a natal chart for 1990-04-15 at 2:30 PM in Chicago."
"Find all Saturn transits to my natal Sun in the next 6 months."
"Get the current moon phase and void-of-course status."
"Find the next solar eclipse visible from Tokyo."
"Find the best time to sign a contract in March — electional window."
"Generate a Human Design chart for my birth data."
"What is my Vedic (sidereal) chart?"
"Calculate my Chinese BaZi (Four Pillars) chart."
"Show me my Astrocartography power lines — where is my Venus line on the map?"
"Find all ACG lines within 3° of Paris for my chart."
"Calculate a synastry chart between two people."
"Find the next Venus Star Point and my relationship to it."
"What are the active planetary stations in the next 3 months?"
"Calculate primary directions for the next 5 years."
"Find my Firdaria time lord period."
"What is the sidereal time and delta-T right now?"

Mapas Interativos

Nove das ferramentas não respondem com JSON. Elas abrem um mapa na conversa — um mapa real, desenhado a partir do mesmo cálculo, no qual você pode clicar.

Isso importa mais do que parece. Um mapa natal retornado como JSON é uma lista de números que você já precisa entender para ler. O mesmo mapa renderizado como uma roda é algo em que você pode apontar. Clique em um planeta e você obtém a explicação daquela posição; clique em uma casa e você vê o que há nela. O mapa permanece na tela enquanto você continua conversando, e não custa outro crédito para continuar olhando.

Isso exige um host que suporte MCP Apps. Claude e ChatGPT ambos suportam, e renderizam o mesmo widget — não há uma versão separada para o ChatGPT. MCP Apps (SEP-1865) foi coautorado pela Anthropic e OpenAI e se tornou a primeira extensão oficial do MCP em janeiro de 2026, então um único recurso ui:// atende a ambos. No ChatGPT, instale-o a partir de o diretório de aplicativos; no Claude, adicione o conector (veja SETUP.md).

Em um cliente sem suporte a aplicativos, as mesmas ferramentas continuam funcionando; você recebe os dados subjacentes em vez da imagem, então nada quebra — você apenas não vê a roda.

Ferramenta	O que abre	No que você pode clicar	Créditos
`explore_natal_chart`	Roda natal — planetas, casas, aspectos, ângulos	Planetas, casas, linhas de aspecto; recalcular com novas configurações	1
`explore_bi_wheel`	Dois mapas em uma roda: trânsitos, sinastria, progressões	Planetas de qualquer uma das rodas, casas e os aspectos entre eles	2 (6 para retorno solar/lunar)
`explore_human_design`	Bodygraph de Human Design, com alternância de visualização mandala	Centros, portas, canais, planetas, variáveis	4
`explore_human_design_transit`	Planetas de hoje sobrepostos a um bodygraph natal	Canais ativados por trânsito	5
`explore_human_design_connection`	Dois bodygraphs combinados, cada canal compartilhado classificado	Canais de conexão por tipo	5
`explore_vedic_chart`	Grade Rashi do Sul da Índia — posições siderais e Lagna	Cada rashi, para suas posições e nakshatras	3
`explore_bazi_chart`	Quatro Pilares (四柱命盘) — Ano, Mês, Dia, Hora	Cada pilar	3
`explore_transit_timeline`	Próximos acertos de trânsito em ordem de data	Acertos individuais	6 para até 1 ano (preço por período)
`explore_moon_phase`	Mostrador lunar — iluminação, fase, signo, void-of-course	Recalcular para outro momento	3

Peça essas coisas como pediria a uma pessoa: "mostre meu mapa", "coloque os trânsitos de hoje sobre meu Human Design", "o que a lua está fazendo agora". O modelo escolhe o aplicativo.

Duas coisas que valem a pena saber. A roda do mapa e a bi-roda aceitam clique em uma linha de aspecto, não apenas nos dois planetas que ela conecta — então "por que essa linha importa" é um clique em vez de um parágrafo de configuração. E a alternância de mandala do bodygraph reorganiza todo o mapa em anéis concêntricos sem outra chamada de API, então alternar visualizações é gratuito.

Ferramentas de Relance

Categoria	Ferramenta	Nível
Mapa natal	`ephemeris_natal_chart`	Explorer
Previsão de trânsito	`ephemeris_transits`	Explorer
Instantâneo de mapa de trânsito	`ephemeris_natal_transits`	Explorer
Fase lunar / VOC	`ephemeris_moon_phase`	Explorer
Próximo eclipse visível	`ephemeris_next_eclipse`	Explorer
Janela elecional	`ephemeris_electional`	Pro
Análise de momento	`electional_moment_analysis`	Explorer
Rastreador de estações	`electional_station_tracker`	Explorer
Busca de aspectos	`electional_aspect_search`	Pro
Mapa de Human Design	`human_design_chart`	Explorer
Composto de HD	`human_design_composite`	Explorer
Sobreposição de trânsito HD	`explore_human_design_transit`	Explorer
Conexão HD (sinastria)	`explore_human_design_connection`	Explorer
Penta HD	`human_design_penta`	Explorer
Retorno / oposição HD	`hd_planetary_return`, `hd_opposition`	Explorer
Mapa védico	`vedic_chart`	Explorer
BaZi (chinês)	`chinese_bazi`	Explorer
Sinastria	`ephemeris_synastry`	Explorer
Mapa composto	`ephemeris_composite`	Explorer
Mapa de realocação	`ephemeris_relocation`	Explorer
Mapa progredido	`ephemeris_progressed_chart`	Explorer
Retorno solar	`ephemeris_solar_return`	Explorer
Retorno lunar	`ephemeris_lunar_return`	Explorer
Retorno planetário	`ephemeris_planetary_return`	Explorer
Linhas de astrocartografia	`acg_power_lines`	Pro
Acertos de ACG no local	`acg_hits`	Pro
Pontos de Estrela de Vênus	`venus_star_points` + mais 4	Explorer
Imagem da roda do mapa	`ephemeris_chart_wheel`	Explorer
Imagem de bi-roda	`ephemeris_bi_wheel`	Explorer
Dignidades / Pontos médios / Estrelas fixas	`ephemeris_dignities`, `ephemeris_midpoints`, `ephemeris_fixed_stars`	Explorer

Modelo de Ferramentas

Ferramentas tipadas são preferidas para fluxos de trabalho comuns (natal, trânsitos, fase lunar, eclipse, sinastria, realocação, elecional, Human Design).
Ferramentas genéricas: dev_list_allowed retorna todas as operações atualmente na lista de permissões; dev_read_api invoca operações GET (leitura) permitidas e dev_write_api invoca operações POST/PUT/PATCH/DELETE (escrita/cálculo) permitidas, cada uma por method + path. Leitura e escrita são mantidas como ferramentas separadas para que uma superfície de leitura segura nunca compartilhe uma ferramenta com escritas que alteram estado.
Modelo de segurança: negação por padrão com lista de permissões explícita em config/dev-allowlist.json.
Prefixos de negação bloqueiam famílias de rotas sensíveis (/auth, /billing, /admin, etc.).

Entrada de `dev_read_api` / `dev_write_api`

Parâmetro	Tipo	Obrigatório	Descrição
`method`	`dev_read_api`: `GET` · `dev_write_api`: `POST\|PUT\|PATCH\|DELETE`	Não	Método HTTP (padrão é o método natural da ferramenta)
`path`	`string`	Sim	Caminho absoluto da API, ex.: `/ephemeris/natal-chart`
`query`	`object`	Não	Parâmetros de consulta
`body`	`object`	Não	Corpo JSON para requisições não-GET
`preset`	`full\|simple`	Não	Mapeamento de conveniência para `query.preset`
`format`	`json\|llm\|llm_v2`	Não	Mapeamento de conveniência para `query.format` (`llm_v2` normaliza para `llm`)
`output_mode`	`full\|simple\|llm\|llm_v2`	Não	Campo de compatibilidade legado

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`OPENEPHEMERIS_API_KEY`	Sim (a menos que chave de serviço/JWT seja usada)	Chave de API para OpenEphemeris
`ASTROMCP_API_KEY`	Não	Alias legado para `OPENEPHEMERIS_API_KEY` (verificado como fallback)
`OPENEPHEMERIS_BACKEND_URL`	Não	Padrão é `https://api.openephemeris.com`
`OPENEPHEMERIS_PROFILE`	Não	`dev` por padrão
`OPENEPHEMERIS_TOOLS`	Não	`core` (padrão) anuncia um conjunto de ferramentas cotidianas focado; `full` anuncia todas as ferramentas. Veja Superfície de ferramentas
`OPENEPHEMERIS_TELEMETRY`	Não	Defina como `0`/`false`/`off` para desativar o relatório de uso anônimo. `DO_NOT_TRACK=1` também funciona. Veja Telemetria
`OPENEPHEMERIS_JWT`	Não	Autenticação por token Bearer
`OPENEPHEMERIS_DEV_ALLOWLIST_PATH`	Não	Substituir caminho do arquivo de lista de permissões
`MCP_USER_ID`	Não	Identificador de usuário por instância

Aliases legados (ASTROMCP_*, MERIDIAN_*) permanecem suportados.

Telemetria

Este servidor relata uso anônimo para sabermos quais ferramentas valem a pena manter e quais estão quebradas. Três eventos: início de sessão, chamada de ferramenta, erro de ferramenta. O que é enviado: o nome da ferramenta, quanto tempo levou, status de erro, qual cliente MCP conectou (ex.: Claude Desktop, Cursor) e sua versão, a versão do servidor e um ID estável para a sessão: um prefixo SHA-256 unidirecional da sua chave de API, ou seu ID de conta quando você faz login com OAuth.

O que nunca é enviado: sua chave de API ou token, dados de nascimento, datas, nomes, coordenadas, argumentos de ferramenta ou resultados de ferramentas. Nenhum corpo de requisição ou resposta, jamais.

Para desativar — qualquer uma das opções funciona, verificada antes de qualquer envio:

OPENEPHEMERIS_TELEMETRY=0
# or the cross-tool standard
DO_NOT_TRACK=1

Superfície de ferramentas

Por padrão, o servidor anuncia um conjunto principal focado de ferramentas do dia a dia, em vez do catálogo inteiro. Listas grandes de ferramentas custam contexto e pioram a seleção de ferramentas pelo modelo, então o padrão é ajustado para conversas reais: um aplicativo interativo por tradição, a ferramenta de dados primária por domínio, geocodificação e o proxy genérico restrito por allowlist.

Nada é removido. A superfície é um filtro apenas em tools/list — toda ferramenta permanece registrada e pode ser chamada pelo nome. Se você souber qual ferramenta quer, chame-a e ela funciona, listada ou não.

Para anunciar o catálogo completo:

OPENEPHEMERIS_TOOLS=full npx -y @openephemeris/mcp-server

No servidor HTTP remoto, acrescente ?profile=full à URL do conector (ou envie X-OE-Tool-Surface: full):

https://mcp.openephemeris.com/mcp?profile=full

Conjuntos de ferramentas por tradição

Se você trabalha em uma tradição, peça-a pelo nome em vez de usar o padrão de propósito geral. Você recebe essa tradição completa — incluindo as ferramentas de cauda longa que o conjunto principal deixa de fora — por uma fração do contexto.

OPENEPHEMERIS_TOOLS=hd npx -y @openephemeris/mcp-server        # Human Design
OPENEPHEMERIS_TOOLS=astrology,moon npx -y @openephemeris/mcp-server

https://mcp.openephemeris.com/mcp?profile=hd,bazi

Conjunto de ferramentas	O que cobre	Ferramentas	Aprox. tokens
`astrology`	Natal, trânsitos, sinastria, progressões, retornos, realocação, dignidades, pontos médios, lotes, estrelas fixas, compostos	32	15.800
`hd`	Mapas de Human Design, trânsitos, mapas de conexão, penta, bodygraph	14	7.800
`bazi`	Quatro Pilares, Dez Deuses, equilíbrio de elementos, pilares de sorte, compatibilidade	13	7.200
`electional`	Janelas de timing, cruzamentos de ângulos, estações, análise de momento	10	4.600
`moon`	Fases, void-of-course, eclipses	9	4.100
`venus`	Pontos de estrelas, fases, elongações, estações	11	3.700
`acg`	Linhas e acertos de astrocartografia	7	3.700
`vedic`	Mapa Rashi Jyotish	7	3.400
—	principal (padrão)	36	19.100
—	completo	70	34.600

Cada seleção também inclui geocodificação (location_search, timezone_resolve), account_usage e o proxy restrito por allowlist — então um local de nascimento é sempre resolvível e nada fica órfão.

Combine com vírgulas; nomes desconhecidos são ignorados em vez de rejeitados, então um erro de digitação degrada para uma superfície menor em vez de um conector morto. Assim como com core/full, isso apenas filtra tools/list — toda ferramenta permanece chamável pelo nome.

Por que isso importa: as definições de ferramentas são reenviadas ao modelo em cada passagem. astrology,moon anuncia o mesmo número de ferramentas que o padrão, mas custa ~1.700 tokens a menos por mensagem e cobre mais da tradição.

A superfície é fixada quando a sessão é inicializada — este servidor não anuncia tools.listChanged, então alternar exige reconexão. dev_list_allowed enumera todas as operações alcançáveis através do proxy genérico, independentemente da superfície.

Contribuição e Suporte

Algo errado com um resultado? Abra uma issue — inclua a ferramenta, suas entradas e o que você esperava.
Quer contribuir? Veja CONTRIBUTING.md. Exemplos de integração e novas habilidades são as coisas mais úteis que você pode adicionar.
Encontrou um problema de segurança? Por favor, reporte-o em particular — veja SECURITY.md.
Ferramentas expirando? Verifique status.openephemeris.com primeiro.

Se isso te salvou de um LLM inventando confiantemente uma posição de Saturno, uma ⭐ ajuda outras pessoas a encontrar isso.

Legal

Este pacote é licenciado sob a Licença MIT. No entanto, o uso deste pacote para acessar a API OpenEphemeris constitui uso do Serviço e é regido pelos Termos de Serviço da OpenEphemeris. Ao usar este pacote, você concorda com esses termos. Veja também a Política de Privacidade e a Política de Uso Aceitável.

Desenvolvimento

O código-fonte do servidor é mantido em um monorepo privado; este repositório contém a documentação pública, plugin, habilidades e exemplos. Relatórios de bugs e contribuições são bem-vindos — veja CONTRIBUTING.md.

Arquitetura

┌─────────────────────────────────────────────────────────┐
│                    MCP Clients                          │
│  Smithery Gateway · Claude Web · ChatGPT · Remote apps  │
└──────────────────┬──────────────────────────────────────┘
                   │ Streamable HTTP (MCP 2025-11-25)
                   │ https://mcp.openephemeris.com/mcp
                   │
┌─────────────────────────────────────────────────────────┐
│          Cursor · Claude Desktop · Windsurf             │
└──────────────────┬──────────────────────────────────────┘
                   │ stdio JSON-RPC
                   │ npx @openephemeris/mcp-server
                   │
              ┌────▼────────────────────┐
              │  openephemeris-mcp      │
              │  Node.js MCP Server     │
              │  typed tools            │
              │  auth: Key > JWT        │
              └────────────┬────────────┘
                           │ HTTPS
                           ▼
              ┌────────────────────────┐
              │  OpenEphemeris API     │
              │  api.openephemeris.com │
              │  NASA JPL DE440        │
              │  1,100 years of data   │
              └────────────────────────┘

Snapshot de Runtime (Gerado)

Gerado por npm run sync:readme a partir de config/dev-allowlist.json e do registro de ferramentas ao vivo.

Operações permitidas: 123
Métodos: GET=43, POST=80, PUT=0, PATCH=0, DELETE=0
Ferramentas registradas (OPENEPHEMERIS_PROFILE=dev): 92
Ferramentas tipadas: account_usage, acg_hits, acg_power_lines, auth_login, auth_logout, auth_status, bazi_annual_pillar, bazi_chart, bazi_compatibility, bazi_element_balance, bazi_luck_pillars, bazi_recalculate, bazi_ten_gods, bi_wheel_on_cross_aspect_click, bi_wheel_on_house_click, bi_wheel_on_planet_click, bi_wheel_recalculate, bi_wheel_synopsis, bodygraph_recalculate, chart_wheel_on_aspect_click, chart_wheel_on_house_click, chart_wheel_on_planet_click, chart_wheel_recalculate, chinese_bazi, electional_angle_crossings, electional_aspect_search, electional_moment_analysis, electional_station_tracker, ephemeris_angles_points, ephemeris_aspect_check, ephemeris_bi_wheel, ephemeris_chart_wheel, ephemeris_composite, ephemeris_composite_midpoint, ephemeris_dignities, ephemeris_electional, ephemeris_fixed_stars, ephemeris_hermetic_lots, ephemeris_house_cusps, ephemeris_lunar_return, ephemeris_midpoints, ephemeris_moon_phase, ephemeris_natal_batch, ephemeris_natal_chart, ephemeris_natal_transits, ephemeris_next_eclipse, ephemeris_next_lunar_phase, ephemeris_overlay, ephemeris_planet_position, ephemeris_planetary_return, ephemeris_progressed_chart, ephemeris_relocation, ephemeris_retrograde_status, ephemeris_solar_return, ephemeris_synastry, ephemeris_transits, explore_bazi_chart, explore_bi_wheel, explore_human_design, explore_human_design_connection, explore_human_design_transit, explore_moon_phase, explore_natal_chart, explore_transit_timeline, explore_vedic_chart, hd_on_center_click, hd_on_channel_click, hd_on_connection_channel_click, hd_on_gate_click, hd_on_planet_click, hd_on_transit_channel_click, hd_on_variable_click, hd_opposition, hd_planetary_return, human_design_bodygraph, human_design_chart, human_design_composite, human_design_penta, location_search, moon_phase_recalculate, timezone_resolve, vedic_chart, vedic_chart_recalculate, venus_eight_year_star, venus_elongations, venus_phase, venus_star_points, venus_star_points_conjunctions, venus_stations
Ferramentas genéricas: dev_list_allowed, dev_read_api, dev_write_api

Famílias da Allowlist

Família	Operações	Exemplo
`acg`	14	`POST /acg/aspects`, `POST /acg/ccg`
`calendar`	3	`GET /calendar/astrology/cross-quarter`, `GET /calendar/astrology/lunar-standstill`
`catalogs`	3	`GET /catalogs/bodies`, `GET /catalogs/fixed-stars`
`chinese`	9	`POST /chinese/bazi`, `POST /chinese/bazi/annual-pillar`
`comparative`	5	`POST /comparative/composite`, `POST /comparative/composite/midpoint`
`eclipse`	6	`GET /eclipse/besselian-elements`, `GET /eclipse/lunar/global`
`electional`	6	`GET /electional/angle-crossings`, `GET /electional/aspect-search`
`ephemeris`	38	`GET /ephemeris/agro/calendar`, `GET /ephemeris/agro/daily`
`health`	2	`GET /health`, `GET /health/detailed`
`human-design`	9	`POST /human-design/chart`, `POST /human-design/composite`
`location`	2	`GET /location/autocomplete`, `GET /location/reverse`
`predictive`	11	`POST /predictive/primary-directions`, `POST /predictive/returns`
`root`	1	`GET /`
`tidal`	1	`GET /tidal/forcing`
`time`	6	`GET /time/delta-t`, `GET /time/equation-of-time`
`timezone`	3	`GET /timezone/coverage`, `POST /timezone/lookup`
`vedic`	1	`POST /vedic/chart`
`visualization`	3	`POST /visualization/bi-wheel`, `POST /visualization/bodygraph`

Por que OpenEphemeris para Agentes de IA?

A maioria dos LLMs (como Claude e ChatGPT) tem grande dificuldade com cálculos astronômicos (trigonometria, conversões de datas julianas e consultas planetárias). OpenEphemeris serve como um mecanismo de matemática remoto e seguro.

Ao combinar LLMs com o servidor MCP OpenEphemeris, seus agentes podem acessar instantaneamente:

Coordenadas com zero alucinação: Cálculos diretos NASA JPL DE440 com precisão de sub-segundo de arco, abrangendo 1.100 anos de dados astronômicos.
Tokens otimizados para LLM (format=llm): Comprimimos respostas padrão de mapas JSON de 25.000 tokens em blocos de texto mínimos, reduzindo seus custos de inferência em 50–73% dependendo do endpoint.
Camadas astrológicas prontas para uso: Suporte integrado para linhas geoJSON de Astrocartografia, Lotes Herméticos, Estrelas Fixas e geração de matrizes complexas de Human Design.