OpenEphemeris

Motor de astrología/astronomía NASA JPL DE440: cartas natales, tránsitos, sinastría, timing electional, Human Design, astrocartografía.

Documentación

Servidor MCP de OpenEphemeris

smithery badge npm version System Status License: MIT Ephemeris: JPL DE440

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

Servidor de Protocolo de Contexto de Modelo para OpenEphemeris: herramientas astrológicas tipadas impulsadas por la efeméride NASA JPL DE440. Cero alucinaciones en posiciones planetarias, fechas y grados. Cubre 1,100 años de datos astronómicos.

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

Endpoint alojado: https://mcp.openephemeris.com/mcp (HTTP Streamable, especificación MCP 2025-11-25)

Inicio Rápido

Instalar vía Smithery (recomendado)

La forma más rápida de conectar cualquier cliente compatible con MCP:

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

O explora el listado y copia los fragmentos de conexión: smithery.ai/servers/open-ephemeris/openephemeris


Conectar vía 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 vía 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 directamente (HTTP Streamable, sin 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)

Instalación con un clic (Cursor)

Install in Cursor

Reemplaza YOUR_API_KEY_HERE en la configuración MCP de Cursor con tu clave API de https://openephemeris.com/dashboard.

Carga útil del enlace profundo de 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"
  }
}

Instalación 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"
      }
    }
  }
}

Guía de plataformas

Tutoriales de configuración detallados para cada plataforma están en SETUP.md.

ClienteModo de instalaciónUbicación de configuración
SmitheryUn clicsmithery.ai
CursorEnlace profundo de un clic o 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
WindsurfManual~/.codeium/windsurf/mcp_config.json (o heredado ~/.codeium/mcp_config.json)
Claude Web / ChatGPT / clientes remotosURL alojadahttps://mcp.openephemeris.com/mcp

Tutoriales de instalación por cliente

  1. Cursor
    • Haz clic en el botón "Instalar en Cursor" de arriba, luego reemplaza YOUR_API_KEY_HERE en la configuración MCP de Cursor.
    • Si prefieres la configuración manual, pega el bloque mcpServers.openephemeris de "Instalación manual" en ~/.cursor/mcp.json.
  2. Claude Desktop (macOS/Windows)
    • Abre el archivo de configuración de la plataforma de la tabla anterior.
    • Agrega el mismo bloque mcpServers.openephemeris de "Instalación manual".
    • Reinicia Claude Desktop.
  3. Windsurf
    • Abre ~/.codeium/windsurf/mcp_config.json (o la ruta heredada ~/.codeium/mcp_config.json).
    • Agrega el bloque mcpServers.openephemeris de "Instalación manual".
    • Reinicia Windsurf.

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

El servidor está alojado en https://mcp.openephemeris.com/mcp con soporte completo de HTTP Streamable (especificación MCP 2025-11-25). Los clientes solo remotos pueden conectarse directamente, sin necesidad de puente/proxy:

  • Claude Web: Agrega https://mcp.openephemeris.com/mcp como URL de conector personalizada; deja el ID de Cliente OAuth y el Secreto en blanco. El servidor usa OAuth 2.1 + PKCE (Registro Dinámico de Clientes), por lo que Claude maneja la autenticación mediante una ventana emergente del navegador automáticamente.
  • Vía Smithery: Usa el listado de Smithery para conexiones administradas con cualquier cliente
  • SSE heredado: retirado en 3.20.0; usa HTTP Streamable en /mcp

Comportamiento de autenticación y actualización en clientes MCP

  • Credenciales faltantes o inválidas (401): la llamada a la herramienta falla con un mensaje que indica a los usuarios registrarse/iniciar sesión en https://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount, y luego crear/gestionar claves en https://openephemeris.com/dashboard?tab=account.
  • Endpoint restringido por nivel (403): la llamada a la herramienta devuelve un mensaje de actualización requerida con https://openephemeris.com/pay y el enlace de gestión de claves/facturación del panel.
  • Cuota mensual agotada (402): la llamada a la herramienta devuelve orientación sobre la cuota de uso con enlaces tanto al panel (/dashboard?tab=account) como a la actualización (/pay).
  • Límite de ráfaga/tasa (429): la llamada a la herramienta devuelve orientación de reintento y enlaces al monitoreo de uso del panel.

Lo Que Puedes Preguntar

"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 Interactivos

Nueve de las herramientas no responden con JSON. Abren un gráfico en la conversación, uno real, dibujado a partir del mismo cálculo, en el que puedes hacer clic.

Esto importa más de lo que parece. Una carta natal devuelta como JSON es una lista de números que ya debes entender para leerla. La misma carta renderizada como una rueda es algo a lo que puedes señalar. Haz clic en un planeta y obtienes esa posición explicada; haz clic en una casa y obtienes lo que contiene. El gráfico permanece en pantalla mientras sigues hablando, y no cuesta otro crédito seguir mirándolo.

Estos requieren un host que soporte MCP Apps; Claude Desktop es el principal hoy en día. En un cliente sin soporte de aplicaciones, las mismas herramientas siguen funcionando; obtienes los datos subyacentes en lugar de la imagen, así que nada se rompe, simplemente no obtienes la rueda.

HerramientaQué abreEn qué puedes hacer clicCréditos
explore_natal_chartRueda natal: planetas, casas, aspectos, ángulosPlanetas, casas, líneas de aspecto; recalcular con nueva configuración1
explore_bi_wheelDos gráficos en una rueda: tránsitos, sinastría, progresionesLos planetas de cualquiera de las ruedas, las casas y los aspectos entre ellos2
explore_human_designBodygraph de Diseño Humano, con vista de mandala conmutableCentros, compuertas, canales, planetas, variables2
explore_human_design_transitLos planetas de hoy superpuestos sobre un bodygraph natalCanales activados por tránsito3
explore_human_design_connectionDos bodygraphs combinados, cada canal compartido clasificadoCanales de conexión por tipo3
explore_vedic_chartCuadrícula Rashi del Sur de India: posiciones sidéreas y LagnaCada rashi, por sus posiciones y nakshatras3
explore_bazi_chartCuatro Pilares (四柱命盘): Año, Mes, Día, HoraCada pilar3
explore_transit_timelinePróximos impactos de tránsito en orden de fechaImpactos individuales6
explore_moon_phaseDial lunar: iluminación, fase, signo, void-of-courseRecalcular para otro momento3

Pide estos de la misma manera que le preguntarías a una persona: "muéstrame mi carta", "pon los tránsitos de hoy sobre mi Diseño Humano", "qué está haciendo la luna ahora mismo". El modelo elige la aplicación.

Dos cosas que vale la pena saber. La rueda de la carta y la bi-rueda aceptan un clic en una línea de aspecto, no solo en los dos planetas que une, así que "por qué importa esta línea" es un clic en lugar de un párrafo de configuración. Y la alternancia de mandala del bodygraph reorganiza todo el gráfico en anillos concéntricos sin otra llamada API, así que cambiar de vista es gratis.

Las capturas de pantalla de cada uno están en camino.

Herramientas de un Vistazo

CategoríaHerramientaNivel
Carta natalephemeris_natal_chartExplorador
Pronóstico de tránsitoephemeris_transitsExplorador
Instantánea de carta de tránsitoephemeris_natal_transitsExplorador
Fase lunar / VOCephemeris_moon_phaseExplorador
Próximo eclipse visibleephemeris_next_eclipseExplorador
Ventana electionalephemeris_electionalDesarrollador
Análisis de momentoelectional_moment_analysisDesarrollador
Rastreador de estacioneselectional_station_trackerDesarrollador
Búsqueda de aspectoselectional_aspect_searchDesarrollador
Carta de Diseño Humanohuman_design_chartExplorador
Compuesto HDhuman_design_compositeDesarrollador
Superposición de tránsito HDexplore_human_design_transitDesarrollador
Conexión HD (sinastría)explore_human_design_connectionDesarrollador
Penta HDhuman_design_pentaExplorador
Retorno / oposición HDhd_planetary_return, hd_oppositionExplorador
Carta védicavedic_chartExplorador
BaZi (chino)chinese_baziExplorador
Sinastríaephemeris_synastryDesarrollador
Carta compuestaephemeris_compositeDesarrollador
Carta de reubicaciónephemeris_relocationDesarrollador
Carta progresadaephemeris_progressed_chartExplorador
Retorno solarephemeris_solar_returnDesarrollador
Retorno lunarephemeris_lunar_returnDesarrollador
Retorno planetarioephemeris_planetary_returnDesarrollador
Líneas de astrocartografíaacg_power_linesDesarrollador
Impactos ACG en ubicaciónacg_hitsEscala
Puntos de la Estrella de Venusvenus_star_points + 4 másExplorador
Imagen de rueda de cartaephemeris_chart_wheelDesarrollador
Imagen de bi-ruedaephemeris_bi_wheelDesarrollador
Dignidades / Puntos medios / Estrellas fijasephemeris_dignities, ephemeris_midpoints, ephemeris_fixed_starsExplorador

Modelo de Herramientas

  • Las herramientas tipadas son preferidas para flujos de trabajo comunes (natal, tránsitos, fase lunar, eclipse, sinastría, reubicación, electional, Diseño Humano).
  • Herramientas genéricas: dev_list_allowed devuelve todas las operaciones actualmente permitidas; dev_read_api invoca operaciones GET (lectura) permitidas y dev_write_api invoca operaciones POST/PUT/PATCH/DELETE (escritura/cálculo) permitidas, cada una por method + path. La lectura y la escritura se mantienen como herramientas separadas para que una superficie de lectura segura nunca comparta una herramienta con escrituras que cambian el estado.
  • Modelo de seguridad: denegación por defecto con lista de permitidos explícita en config/dev-allowlist.json.
  • Los prefijos de denegación bloquean familias de rutas sensibles (/auth, /billing, /admin, etc.).

Entrada de dev_read_api / dev_write_api

ParámetroTipoRequeridoDescripción
methoddev_read_api: GET · dev_write_api: POST|PUT|PATCH|DELETENoMétodo HTTP (por defecto al método natural de la herramienta)
pathstringRuta API absoluta, p. ej. /ephemeris/natal-chart
queryobjectNoParámetros de consulta
bodyobjectNoCuerpo JSON para solicitudes que no sean GET
presetfull|simpleNoMapeo de conveniencia a query.preset
formatjson|llm|llm_v2NoMapeo de conveniencia a query.format (llm_v2 normaliza a llm)
output_modefull|simple|llm|llm_v2NoCampo de compatibilidad heredado

Variables de Entorno

VariableRequeridaDescripción
OPENEPHEMERIS_API_KEYSí (a menos que se use clave de servicio/JWT)Clave API para OpenEphemeris
ASTROMCP_API_KEYNoAlias heredado para OPENEPHEMERIS_API_KEY (verificado como respaldo)
OPENEPHEMERIS_BACKEND_URLNoPor defecto a https://api.openephemeris.com
OPENEPHEMERIS_PROFILENodev por defecto
OPENEPHEMERIS_TOOLSNocore (por defecto) anuncia un conjunto de herramientas cotidianas enfocado; full anuncia cada herramienta. Ver Superficie de herramientas
OPENEPHEMERIS_TELEMETRYNoEstablecer a 0/false/off para deshabilitar el informe de uso anónimo. DO_NOT_TRACK=1 también funciona. Ver Telemetría
OPENEPHEMERIS_SERVICE_KEYNoAutenticación de servicio interna
OPENEPHEMERIS_JWTNoAutenticación de token Bearer
OPENEPHEMERIS_DEV_ALLOWLIST_PATHNoAnular la ruta del archivo de lista de permitidos
MCP_USER_IDNoIdentificador de usuario por instancia

Los alias heredados (ASTROMCP_*, MERIDIAN_*) siguen siendo compatibles.

Telemetría

Este servidor informa uso anónimo para que sepamos qué herramientas vale la pena mantener y cuáles están rotas. Tres eventos: inicio de sesión, llamada a herramienta, error de herramienta.

Lo que se envía: el nombre de la herramienta, cuánto tardó, estado de error, qué cliente MCP se conectó (p. ej. Claude Desktop, Cursor) y su versión, la versión del servidor, y un prefijo SHA-256 unidireccional de tu clave API utilizado como identificador anónimo estable.

Lo que nunca se envía: tu clave API o token, datos de nacimiento, fechas, nombres, coordenadas, argumentos de herramientas o resultados de herramientas. Nunca se envían cuerpos de solicitud o respuesta, jamás.

Para desactivarlo, cualquiera de las dos opciones funciona, verificado antes de que se envíe algo:

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

Superficie de herramientas

Por defecto, el servidor anuncia un conjunto central enfocado de herramientas cotidianas en lugar de todo el catálogo. Las listas grandes de herramientas cuestan contexto y empeoran la selección de herramientas del modelo, por lo que el valor predeterminado está ajustado para conversaciones reales: una aplicación interactiva por tradición, la herramienta de datos principal por dominio, geocodificación y el proxy genérico restringido por lista de permitidos.

Nada se elimina. La superficie es un filtro solo en tools/list: cada herramienta permanece registrada y se puede llamar por nombre. Si conoces la herramienta que quieres, llámala y funciona, esté listada o no.

Para anunciar el catálogo completo:

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

En el servidor HTTP remoto, agrega ?profile=full a la URL del conector (o envía X-OE-Tool-Surface: full):

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

Conjuntos de herramientas por tradición

Si trabajas en una tradición, pídela por su nombre en lugar de usar la opción general por defecto. Obtienes esa tradición completa —incluyendo las herramientas de cola larga que el conjunto básico omite— por una fracción del 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 herramientasQué cubreHerramientasAprox. tokens
astrologyNatal, tránsitos, sinastría, progresiones, retornos, reubicación, dignidades, puntos medios, lotes, estrellas fijas, compuestos3215,800
hdCartas de Human Design, tránsitos, cartas de conexión, penta, bodygraph147,800
baziCuatro Pilares, Diez Dioses, equilibrio de elementos, pilares de suerte, compatibilidad137,200
electionalVentanas de tiempo, cruces de ángulos, estaciones, análisis de momentos104,600
moonFases, void-of-course, eclipses94,100
venusPuntos de estrellas, fases, elongaciones, estaciones113,700
acgLíneas y aciertos de astrocartografía73,700
vedicCarta Rashi de Jyotish73,400
básico (por defecto)3619,100
completo7034,600

Cada selección también incluye geocodificación (location_search, timezone_resolve), account_usage y el proxy restringido por lista de permitidos — por lo que un lugar de nacimiento siempre es resoluble y nada queda aislado.

Combina con comas; los nombres desconocidos se ignoran en lugar de rechazarse, por lo que un error tipográfico degrada a una superficie más pequeña en lugar de un conector muerto. Al igual que con core/full, esto solo filtra tools/list — cada herramienta sigue siendo invocable por nombre.

Por qué importa: las definiciones de herramientas se reenvían al modelo en cada pasada. astrology,moon anuncia el mismo número de herramientas que el predeterminado pero cuesta ~1,700 tokens menos por mensaje y cubre más de la tradición.

La superficie se fija cuando la sesión se inicializa — este servidor no anuncia tools.listChanged, por lo que cambiar requiere reconectar. dev_list_allowed enumera cada operación alcanzable a través del proxy genérico independientemente de la superficie.

Contribución y Soporte

  • ¿Algo mal con un resultado? Abre un issue — incluye la herramienta, tus entradas y lo que esperabas.
  • ¿Quieres contribuir? Consulta CONTRIBUTING.md. Los ejemplos de integración y nuevas habilidades son lo más útil que puedes añadir.
  • ¿Encontraste un problema de seguridad? Por favor, repórtalo de forma privada — consulta SECURITY.md.
  • ¿Las herramientas agotan el tiempo? Revisa status.openephemeris.com primero.

Si esto te salvó de que un LLM inventara con confianza una posición de Saturno, una ⭐ ayuda a que otras personas lo encuentren.

Legal

Este paquete está licenciado bajo la Licencia MIT. Sin embargo, el uso de este paquete para acceder a la API de OpenEphemeris constituye el uso del Servicio y se rige por los Términos de Servicio de OpenEphemeris. Al usar este paquete, aceptas esos términos. Consulta también la Política de Privacidad y la Política de Uso Aceptable.

Desarrollo

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

Despliegue del Servidor SSE en Fly.io

Cuando actualices la lógica del servidor MCP (manejadores, correcciones de errores, endurecimiento), debes desplegarlo para que los clientes que se conectan a través del endpoint remoto https://mcp.openephemeris.com/mcp reciban las actualizaciones de inmediato.

  1. Navega a apps/api/mcp-server
  2. Ejecuta fly deploy --remote-only

Nota sobre NPM: Desplegar en Fly.io actualiza instantáneamente la herramienta SSE accesible por web. Sin embargo, los usuarios que instalan tu herramienta localmente en Cursor/Desktop a través de npx @openephemeris/mcp-server solo recibirán las actualizaciones una vez que se publique una nueva versión en NPM. Si tus cambios son críticos, debes aumentar la versión en package.json y ejecutar npm publish (o tu pipeline de lanzamiento de CI) después de desplegar en Fly.

npm run verify:release es la puerta de lanzamiento. Verifica:

  • Frescura de la lista de permitidos contra OpenAPI
  • Frescura del paquete de esquemas
  • Sincronización del README
  • Seguridad de tipos + pruebas
  • Contenido del tarball de publicación (npm pack --dry-run --json)

Arquitectura

┌─────────────────────────────────────────────────────────┐
│                    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   │
              └────────────────────────┘

Instantánea de Tiempo de Ejecución (Generada)

Generada por npm run sync:readme desde config/dev-allowlist.json y el registro de herramientas en vivo.

  • Operaciones en lista de permitidos: 31
  • Métodos: GET=5, POST=26, PUT=0, PATCH=0, DELETE=0
  • Herramientas registradas (OPENEPHEMERIS_PROFILE=dev): 92
  • Herramientas 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
  • Herramientas genéricas: dev_list_allowed, dev_read_api, dev_write_api

Familias de Lista de Permitidos

FamiliaOperacionesEjemplo
acg4POST /acg/ccg, POST /acg/hits
chinese5POST /chinese/bazi/compatibility, POST /chinese/bazi/element-balance
comparative5POST /comparative/composite, POST /comparative/composite/midpoint
electional5GET /electional/angle-crossings, GET /electional/aspect-search
ephemeris1POST /ephemeris/relocation
human-design2POST /human-design/composite, POST /human-design/transit-chart
predictive6POST /predictive/returns, POST /predictive/returns/lunar
visualization3POST /visualization/bi-wheel, POST /visualization/bodygraph

¿Por qué OpenEphemeris para Agentes de IA?

La mayoría de los LLMs (como Claude y ChatGPT) tienen grandes dificultades con los cálculos astronómicos (trigonometría, conversiones de fechas julianas y búsquedas planetarias). OpenEphemeris sirve como un motor matemático remoto y seguro.

Al combinar LLMs con el servidor MCP de OpenEphemeris, tus agentes pueden acceder instantáneamente a:

  • Coordenadas sin alucinaciones: Cálculos directos de NASA JPL DE440 con precisión de sub-arcosegundo que abarcan 1,100 años de datos astronómicos.
  • Tokens optimizados para LLMs (format=llm): Comprimimos las respuestas estándar de cartas JSON de 25,000 tokens en bloques de texto mínimos, reduciendo tus costos de inferencia en un 50–73% según el endpoint.
  • Capas astrológicas listas para usar: Soporte integrado para líneas geoJSON de Astrocartografía, Lotes Herméticos, Estrellas Fijas y generación compleja de matrices de Human Design.