OpenEphemeris

Servidor MCP OpenEphemeris

Servidor Model Context Protocol para OpenEphemeris — ferramentas astrológicas tipadas alimentadas pela efeméride NASA JPL DE440. Zero alucinação em posições planetárias, datas e graus. Cobre 1.100 anos de dados astronômicos.

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

Início Rápido

Instalar via Smithery (recomendado)

A forma 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 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

Tutoriais detalhados de configuração para cada plataforma estão 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)
Claude Web / ChatGPT / clientes remotos	URL hospedada	https://mcp.openephemeris.com/mcp

Tutoriais de instalação por cliente

1. Cursor
   • Clique no botão "Instalar no Cursor" acima e substitua YOUR_API_KEY_HERE nas configurações MCP do Cursor.
   • Se preferir configuração manual, cole o bloco mcpServers.openephemeris de "Instalação manual" em ~/.cursor/mcp.json.
2. 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.
3. 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 ID do Cliente OAuth e o Segredo em branco. O servidor usa OAuth 2.1 + PKCE (Registro Dinâmico de Cliente), então o Claude lida com a autenticação via popup do navegador automaticamente.
• 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

Comportamento de autenticação e 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 o painel de cobrança/gestão de chaves.
• Cota mensal esgotada (402): a chamada de ferramenta retorna orientação sobre cota de uso com links para o painel (/dashboard?tab=account) e upgrade (/pay).
• Limite de rajada/taxa (429): a chamada de ferramenta retorna orientação 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?"

Gráficos Interativos

Nove das ferramentas não respondem com JSON. Elas abrem um gráfico na conversa — um gráfico real, desenhado a partir do mesmo cálculo, que você pode clicar e explorar.

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 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 gráfico permanece na tela enquanto você continua conversando, e não custa outro crédito para continuar olhando.

Isso requer um host que suporte MCP Apps — o Claude Desktop é o principal hoje. Em um cliente sem suporte a apps, as mesmas ferramentas ainda funcionam; você recebe os dados subjacentes em vez da imagem, então nada quebra, você apenas não vê a roda.

Ferramenta	O que abre	O 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 gráficos em uma roda: trânsitos, sinastria, progressões	Planetas de qualquer uma das rodas, casas e os aspectos entre eles	2
explore_human_design	Bodygraph de Human Design, com alternância de visualização mandala	Centros, portas, canais, planetas, variáveis	2
explore_human_design_transit	Planetas de hoje sobrepostos a um bodygraph natal	Canais ativados por trânsito	3
explore_human_design_connection	Dois bodygraphs combinados, cada canal compartilhado classificado	Canais de conexão por tipo	3
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
explore_moon_phase	Mostrador lunar — iluminação, fase, signo, void-of-course	Recalcular para outro momento	3

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

Duas coisas que valem a pena saber. A roda do gráfico e a bi-roda aceitam clique em uma linha de aspecto, não apenas nos dois planetas que ela une — 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 gráfico em anéis concêntricos sem outra chamada de API, então alternar visualizações é gratuito.

Capturas de tela de cada um estão a caminho.

Ferramentas de Relance

Categoria	Ferramenta	Nível
Mapa natal	ephemeris_natal_chart	Explorer
Previsão de trânsito	ephemeris_transits	Explorer
Instantâneo de gráfico 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	Developer
Análise de momento	electional_moment_analysis	Developer
Rastreador de estações	electional_station_tracker	Developer
Busca de aspectos	electional_aspect_search	Developer
Gráfico de Human Design	human_design_chart	Explorer
Composto de HD	human_design_composite	Developer
Sobreposição de trânsito HD	explore_human_design_transit	Developer
Conexão HD (sinastria)	explore_human_design_connection	Developer
Penta HD	human_design_penta	Explorer
Retorno/oposição HD	hd_planetary_return, hd_opposition	Explorer
Gráfico védico	vedic_chart	Explorer
BaZi (chinês)	chinese_bazi	Explorer
Sinastria	ephemeris_synastry	Developer
Gráfico composto	ephemeris_composite	Developer
Gráfico de realocação	ephemeris_relocation	Developer
Gráfico progredido	ephemeris_progressed_chart	Explorer
Retorno solar	ephemeris_solar_return	Developer
Retorno lunar	ephemeris_lunar_return	Developer
Retorno planetário	ephemeris_planetary_return	Developer
Linhas de astrocartografia	acg_power_lines	Developer
Acertos de ACG no local	acg_hits	Scale
Pontos da Estrela de Vênus	venus_star_points + mais 4	Explorer
Imagem de roda de gráfico	ephemeris_chart_wheel	Developer
Imagem de bi-roda	ephemeris_bi_wheel	Developer
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_SERVICE_KEY	Não	Autenticação interna de serviço
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 reporta 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 prefixo SHA-256 unidirecional da sua chave de API usado como ID anônimo estável.

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

Para desativar — qualquer uma das opções funciona, verificado 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 cotidianas 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 app interativo por tradição, a ferramenta de dados primária por domínio, geocodificação e o proxy genérico restrito por lista de permissões.

Nada é removido. A superfície é um filtro apenas em tools/list — toda ferramenta permanece registrada e chamável pelo nome. Se você sabe 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 por ela 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

Toolset	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 tempo, 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, alongamentos, estações	11	3.700
acg	Linhas e acertos de astrocartografia	7	3.700
vedic	Mapa Rashi Jyotish	7	3.400
—	core (padrão)	36	19.100
—	full	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 a 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 toda operação alcançável através do proxy genérico, independentemente da superfície.

Contribuindo 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 encontrarem 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

npm install
npm run dev
npm run typecheck
npm test
npm run regen:dev-allowlist
npm run check:dev-allowlist
npm run sync:readme
npm run check:readme
npm run verify:release

Implantando o Servidor SSE no Fly.io

Quando você atualiza a lógica do servidor MCP (handlers, correções de bugs, endurecimento), você deve implantá-lo para que clientes conectados via endpoint remoto https://mcp.openephemeris.com/mcp recebam as atualizações imediatamente.

1. Navegue até apps/api/mcp-server
2. Execute fly deploy --remote-only

Nota sobre NPM: Implantar no Fly.io atualiza instantaneamente a ferramenta SSE acessível pela web. No entanto, usuários que instalam sua ferramenta localmente no Cursor/Desktop via npx @openephemeris/mcp-server só receberão as atualizações quando uma nova versão for publicada no NPM. Se suas mudanças forem críticas, você deve aumentar a versão em package.json e executar npm publish (ou seu pipeline de release de CI) após implantar no Fly.

npm run verify:release é o portão de release. Ele verifica:

• frescor da allowlist contra a OpenAPI
• frescor do pacote de esquemas
• sincronização do README
• segurança de tipos + testes
• conteúdo do tarball de publicação (npm pack --dry-run --json)

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 na allowlist: 31
• Métodos: GET=5, POST=26, 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	4	POST /acg/ccg, POST /acg/hits
chinese	5	POST /chinese/bazi/compatibility, POST /chinese/bazi/element-balance
comparative	5	POST /comparative/composite, POST /comparative/composite/midpoint
electional	5	GET /electional/angle-crossings, GET /electional/aspect-search
ephemeris	1	POST /ephemeris/relocation
human-design	2	POST /human-design/composite, POST /human-design/transit-chart
predictive	6	POST /predictive/returns, POST /predictive/returns/lunar
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 muita 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 em 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.