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

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.

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)
Reemplaza
YOUR_API_KEY_HEREen 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.
| Cliente | Modo de instalación | Ubicación de configuración |
|---|---|---|
| Smithery | Un clic | smithery.ai |
| Cursor | Enlace 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 |
| Windsurf | Manual | ~/.codeium/windsurf/mcp_config.json (o heredado ~/.codeium/mcp_config.json) |
| Claude Web / ChatGPT / clientes remotos | URL alojada | https://mcp.openephemeris.com/mcp |
Tutoriales de instalación por cliente
- Cursor
- Haz clic en el botón "Instalar en Cursor" de arriba, luego reemplaza
YOUR_API_KEY_HEREen la configuración MCP de Cursor. - Si prefieres la configuración manual, pega el bloque
mcpServers.openephemerisde "Instalación manual" en~/.cursor/mcp.json.
- Haz clic en el botón "Instalar en Cursor" de arriba, luego reemplaza
- Claude Desktop (macOS/Windows)
- Abre el archivo de configuración de la plataforma de la tabla anterior.
- Agrega el mismo bloque
mcpServers.openephemerisde "Instalación manual". - Reinicia Claude Desktop.
- Windsurf
- Abre
~/.codeium/windsurf/mcp_config.json(o la ruta heredada~/.codeium/mcp_config.json). - Agrega el bloque
mcpServers.openephemerisde "Instalación manual". - Reinicia Windsurf.
- Abre
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/mcpcomo 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 enhttps://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount, y luego crear/gestionar claves enhttps://openephemeris.com/dashboard?tab=account. - Endpoint restringido por nivel (
403): la llamada a la herramienta devuelve un mensaje de actualización requerida conhttps://openephemeris.com/payy 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.
| Herramienta | Qué abre | En qué puedes hacer clic | Créditos |
|---|---|---|---|
explore_natal_chart | Rueda natal: planetas, casas, aspectos, ángulos | Planetas, casas, líneas de aspecto; recalcular con nueva configuración | 1 |
explore_bi_wheel | Dos gráficos en una rueda: tránsitos, sinastría, progresiones | Los planetas de cualquiera de las ruedas, las casas y los aspectos entre ellos | 2 |
explore_human_design | Bodygraph de Diseño Humano, con vista de mandala conmutable | Centros, compuertas, canales, planetas, variables | 2 |
explore_human_design_transit | Los planetas de hoy superpuestos sobre un bodygraph natal | Canales activados por tránsito | 3 |
explore_human_design_connection | Dos bodygraphs combinados, cada canal compartido clasificado | Canales de conexión por tipo | 3 |
explore_vedic_chart | Cuadrícula Rashi del Sur de India: posiciones sidéreas y Lagna | Cada rashi, por sus posiciones y nakshatras | 3 |
explore_bazi_chart | Cuatro Pilares (四柱命盘): Año, Mes, Día, Hora | Cada pilar | 3 |
explore_transit_timeline | Próximos impactos de tránsito en orden de fecha | Impactos individuales | 6 |
explore_moon_phase | Dial lunar: iluminación, fase, signo, void-of-course | Recalcular para otro momento | 3 |
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ía | Herramienta | Nivel |
|---|---|---|
| Carta natal | ephemeris_natal_chart | Explorador |
| Pronóstico de tránsito | ephemeris_transits | Explorador |
| Instantánea de carta de tránsito | ephemeris_natal_transits | Explorador |
| Fase lunar / VOC | ephemeris_moon_phase | Explorador |
| Próximo eclipse visible | ephemeris_next_eclipse | Explorador |
| Ventana electional | ephemeris_electional | Desarrollador |
| Análisis de momento | electional_moment_analysis | Desarrollador |
| Rastreador de estaciones | electional_station_tracker | Desarrollador |
| Búsqueda de aspectos | electional_aspect_search | Desarrollador |
| Carta de Diseño Humano | human_design_chart | Explorador |
| Compuesto HD | human_design_composite | Desarrollador |
| Superposición de tránsito HD | explore_human_design_transit | Desarrollador |
| Conexión HD (sinastría) | explore_human_design_connection | Desarrollador |
| Penta HD | human_design_penta | Explorador |
| Retorno / oposición HD | hd_planetary_return, hd_opposition | Explorador |
| Carta védica | vedic_chart | Explorador |
| BaZi (chino) | chinese_bazi | Explorador |
| Sinastría | ephemeris_synastry | Desarrollador |
| Carta compuesta | ephemeris_composite | Desarrollador |
| Carta de reubicación | ephemeris_relocation | Desarrollador |
| Carta progresada | ephemeris_progressed_chart | Explorador |
| Retorno solar | ephemeris_solar_return | Desarrollador |
| Retorno lunar | ephemeris_lunar_return | Desarrollador |
| Retorno planetario | ephemeris_planetary_return | Desarrollador |
| Líneas de astrocartografía | acg_power_lines | Desarrollador |
| Impactos ACG en ubicación | acg_hits | Escala |
| Puntos de la Estrella de Venus | venus_star_points + 4 más | Explorador |
| Imagen de rueda de carta | ephemeris_chart_wheel | Desarrollador |
| Imagen de bi-rueda | ephemeris_bi_wheel | Desarrollador |
| Dignidades / Puntos medios / Estrellas fijas | ephemeris_dignities, ephemeris_midpoints, ephemeris_fixed_stars | Explorador |
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_alloweddevuelve todas las operaciones actualmente permitidas;dev_read_apiinvoca operaciones GET (lectura) permitidas ydev_write_apiinvoca operaciones POST/PUT/PATCH/DELETE (escritura/cálculo) permitidas, cada una pormethod + 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ámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
method | dev_read_api: GET · dev_write_api: POST|PUT|PATCH|DELETE | No | Método HTTP (por defecto al método natural de la herramienta) |
path | string | Sí | Ruta API absoluta, p. ej. /ephemeris/natal-chart |
query | object | No | Parámetros de consulta |
body | object | No | Cuerpo JSON para solicitudes que no sean GET |
preset | full|simple | No | Mapeo de conveniencia a query.preset |
format | json|llm|llm_v2 | No | Mapeo de conveniencia a query.format (llm_v2 normaliza a llm) |
output_mode | full|simple|llm|llm_v2 | No | Campo de compatibilidad heredado |
Variables de Entorno
| Variable | Requerida | Descripción |
|---|---|---|
OPENEPHEMERIS_API_KEY | Sí (a menos que se use clave de servicio/JWT) | Clave API para OpenEphemeris |
ASTROMCP_API_KEY | No | Alias heredado para OPENEPHEMERIS_API_KEY (verificado como respaldo) |
OPENEPHEMERIS_BACKEND_URL | No | Por defecto a https://api.openephemeris.com |
OPENEPHEMERIS_PROFILE | No | dev por defecto |
OPENEPHEMERIS_TOOLS | No | core (por defecto) anuncia un conjunto de herramientas cotidianas enfocado; full anuncia cada herramienta. Ver Superficie de herramientas |
OPENEPHEMERIS_TELEMETRY | No | Establecer a 0/false/off para deshabilitar el informe de uso anónimo. DO_NOT_TRACK=1 también funciona. Ver Telemetría |
OPENEPHEMERIS_SERVICE_KEY | No | Autenticación de servicio interna |
OPENEPHEMERIS_JWT | No | Autenticación de token Bearer |
OPENEPHEMERIS_DEV_ALLOWLIST_PATH | No | Anular la ruta del archivo de lista de permitidos |
MCP_USER_ID | No | Identificador 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 herramientas | Qué cubre | Herramientas | Aprox. tokens |
|---|---|---|---|
astrology | Natal, tránsitos, sinastría, progresiones, retornos, reubicación, dignidades, puntos medios, lotes, estrellas fijas, compuestos | 32 | 15,800 |
hd | Cartas de Human Design, tránsitos, cartas de conexión, penta, bodygraph | 14 | 7,800 |
bazi | Cuatro Pilares, Diez Dioses, equilibrio de elementos, pilares de suerte, compatibilidad | 13 | 7,200 |
electional | Ventanas de tiempo, cruces de ángulos, estaciones, análisis de momentos | 10 | 4,600 |
moon | Fases, void-of-course, eclipses | 9 | 4,100 |
venus | Puntos de estrellas, fases, elongaciones, estaciones | 11 | 3,700 |
acg | Líneas y aciertos de astrocartografía | 7 | 3,700 |
vedic | Carta Rashi de Jyotish | 7 | 3,400 |
| — | básico (por defecto) | 36 | 19,100 |
| — | completo | 70 | 34,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.
- Navega a
apps/api/mcp-server - 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
| Familia | Operaciones | Ejemplo |
|---|---|---|
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 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.