OpenEphemeris

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

GitHub

Documentación

Servidor MCP de OpenEphemeris

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

Úsalo en Claude: añade https://mcp.openephemeris.com/mcp como conector personalizado (deja el ID de Cliente OAuth y el Secreto en blanco) o instala el plugin de Open Ephemeris desde el directorio de Claude. El inicio de sesión ocurre en el navegador y crea una cuenta gratuita con 150 créditos.

Servidor de Protocolo de Contexto de Modelo para OpenEphemeris: herramientas de astrología 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 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_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.

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 legado `~/.codeium/mcp_config.json`)
ChatGPT	Un clic	Open Ephemeris en el directorio de aplicaciones de ChatGPT
Claude Web / 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_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.
Claude Desktop (macOS/Windows)
- Abre el archivo de configuración de la plataforma desde la tabla de arriba.
- Añade el mismo bloque mcpServers.openephemeris de "Instalación manual".
- Reinicia Claude Desktop.
Windsurf
- Abre ~/.codeium/windsurf/mcp_config.json (o la ruta legada ~/.codeium/mcp_config.json).
- Añade 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 puente/proxy requerido:

Claude Web: Añade https://mcp.openephemeris.com/mcp como URL de conector personalizado: deja el ID de Cliente OAuth y el Secreto en blanco. El servidor usa OAuth 2.1 + PKCE (Registro Dinámico de Clientes), así que Claude maneja la autenticación mediante una ventana emergente del navegador automáticamente.
ChatGPT: Open Ephemeris es una aplicación aprobada en el directorio de aplicaciones de ChatGPT. Abre el listado, haz clic en Instalar plugin, aprueba el inicio de sesión (eso también crea tu cuenta gratuita de OpenEphemeris), luego escribe @Open Ephemeris en cualquier chat. Las cartas se renderizan en línea, exactamente como en Claude. ¿Prefieres configurarlo tú mismo? Configuración → Plugins → Avanzado → Modo desarrollador → + Crear aplicación acepta https://mcp.openephemeris.com/mcp con Autenticación en OAuth: no hay ID de cliente ni secreto que ingresar.
Vía Smithery: Usa el listado de Smithery para conexiones gestionadas con cualquier cliente.
SSE legado: 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 dirige a los usuarios a registrarse/iniciar sesión en https://openephemeris.com/login?signup=true&redirect=%2Fdashboard%3Ftab%3Daccount, 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.
Sin créditos (402): la llamada a la herramienta devuelve un enlace de recarga con un toque (los 150 créditos gratuitos de Explorer son únicos y no se reinician; las asignaciones del plan se renuevan cada período de facturación) más el enlace de uso del panel. Las llamadas fallidas (cualquier 4xx/5xx) se reembolsan.
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?"

Cartas Interactivas

Nueve de las herramientas no responden con JSON. Abren una carta en la conversación: una real, dibujada desde el mismo cálculo, en la 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 tienes que 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 colocación explicada; haz clic en una casa y obtienes lo que contiene. La carta permanece en pantalla mientras sigues hablando, y no cuesta otro crédito seguir mirándola.

Estas necesitan un host que soporte Aplicaciones MCP. Claude y ChatGPT ambos lo hacen, y renderizan el mismo widget: no hay una versión separada para ChatGPT. Las Aplicaciones MCP (SEP-1865) fueron coescritas por Anthropic y OpenAI y se convirtieron en la primera extensión oficial de MCP en enero de 2026, así que un solo recurso ui:// sirve a ambos. En ChatGPT, instálalo desde el directorio de aplicaciones; en Claude, añade el conector (ver SETUP.md).

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, solo 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 cartas en una rueda: tránsitos, sinastría, progresiones	Planetas de cualquiera de las ruedas, casas y los aspectos entre ellos	2 (6 para retorno solar/lunar)
`explore_human_design`	Bodygraph de Human Design, con alternancia de vista mandala	Centros, compuertas, canales, planetas, variables	4
`explore_human_design_transit`	Los planetas de hoy superpuestos sobre un bodygraph natal	Canales activados por tránsito	5
`explore_human_design_connection`	Dos bodygraphs combinados, cada canal compartido clasificado	Canales de conexión por tipo	5
`explore_vedic_chart`	Cuadrícula Rashi del Sur de India: colocaciones sidéreas y Lagna	Cada rashi, por sus colocaciones 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 por hasta 1 año (precio según el lapso)
`explore_moon_phase`	Dial lunar: iluminación, fase, signo, void-of-course	Recalcular para otro momento	3

Pide estas cosas como le pedirías a una persona: "muéstrame mi carta", "pon los tránsitos de hoy sobre mi Human Design", "qué está haciendo la luna ahora mismo". El modelo elige la aplicación.

Dos cosas que vale la pena saber. La rueda de 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 toda la carta en anillos concéntricos sin otra llamada API, así que cambiar de vista es gratis.

Herramientas de un Vistazo

Categoría	Herramienta	Nivel
Carta natal	`ephemeris_natal_chart`	Explorer
Pronóstico de tránsitos	`ephemeris_transits`	Explorer
Instantánea de carta de tránsito	`ephemeris_natal_transits`	Explorer
Fase lunar / VOC	`ephemeris_moon_phase`	Explorer
Próximo eclipse visible	`ephemeris_next_eclipse`	Explorer
Ventana electional	`ephemeris_electional`	Pro
Análisis de momento	`electional_moment_analysis`	Explorer
Rastreador de estaciones	`electional_station_tracker`	Explorer
Búsqueda de aspectos	`electional_aspect_search`	Pro
Carta de Human Design	`human_design_chart`	Explorer
Compuesto HD	`human_design_composite`	Explorer
Superposición de tránsitos HD	`explore_human_design_transit`	Explorer
Conexión HD (sinastría)	`explore_human_design_connection`	Explorer
Penta HD	`human_design_penta`	Explorer
Retorno / oposición HD	`hd_planetary_return`, `hd_opposition`	Explorer
Carta védica	`vedic_chart`	Explorer
BaZi (chino)	`chinese_bazi`	Explorer
Sinastría	`ephemeris_synastry`	Explorer
Carta compuesta	`ephemeris_composite`	Explorer
Carta de reubicación	`ephemeris_relocation`	Explorer
Carta progresada	`ephemeris_progressed_chart`	Explorer
Retorno solar	`ephemeris_solar_return`	Explorer
Retorno lunar	`ephemeris_lunar_return`	Explorer
Retorno planetario	`ephemeris_planetary_return`	Explorer
Líneas de astrocartografía	`acg_power_lines`	Pro
Impactos ACG en ubicación	`acg_hits`	Pro
Puntos de Estrella de Venus	`venus_star_points` + 4 más	Explorer
Imagen de rueda de carta	`ephemeris_chart_wheel`	Explorer
Imagen de bi-rueda	`ephemeris_bi_wheel`	Explorer
Dignidades / Puntos medios / Estrellas fijas	`ephemeris_dignities`, `ephemeris_midpoints`, `ephemeris_fixed_stars`	Explorer

Modelo de Herramientas

Las herramientas tipadas son preferidas para flujos de trabajo comunes (natal, tránsitos, fase lunar, eclipse, sinastría, reubicación, electional, Human Design).
Herramientas genéricas: dev_list_allowed devuelve todas las operaciones actualmente en la lista blanca; dev_read_api invoca operaciones GET (lectura) en la lista blanca y dev_write_api invoca operaciones POST/PUT/PATCH/DELETE (escritura/cómputo) en la lista blanca, 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 blanca 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 el 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 legado

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 legado 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 reporte de uso anónimo. `DO_NOT_TRACK=1` también funciona. Ver Telemetría
`OPENEPHEMERIS_JWT`	No	Autenticación de token Bearer
`OPENEPHEMERIS_DEV_ALLOWLIST_PATH`	No	Sobrescribir la ruta del archivo de lista blanca
`MCP_USER_ID`	No	Identificador de usuario por instancia

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

Telemetría

Este servidor reporta 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. Qué se envía: el nombre de la herramienta, cuánto tiempo tomó, el estado del error, qué cliente MCP se conectó (por ejemplo, Claude Desktop, Cursor) y su versión, la versión del servidor, y un identificador estable para la sesión: un prefijo SHA-256 de un solo sentido de tu clave API, o tu ID de cuenta cuando inicias sesión con OAuth.

Qué 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 solicitudes o respuestas.

Para desactivarlo — cualquiera de las dos opciones funciona, se verifica antes de enviar cualquier cosa:

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

Superficie de herramientas

Por defecto, el servidor anuncia un conjunto principal enfocado de herramientas cotidianas en lugar del catálogo completo. Las listas extensas de herramientas consumen 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.

No se elimina nada. La superficie es un filtro solo sobre tools/list — cada herramienta permanece registrada y se puede invocar por nombre. Si sabes qué herramienta quieres, llámala y funcionará, 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, solicítala por nombre en lugar de usar el valor predeterminado de propósito general. Obtienes esa tradición completa — incluida las herramientas de cola larga que el conjunto principal 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 sincronización, 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
—	principal (predeterminado)	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 inactivo. 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 valor predeterminado pero cuesta ~1,700 tokens menos por mensaje y cubre más de la tradición.

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

Contribución y soporte

¿Algo anda 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 agregar.
¿Encontraste un problema de seguridad? Por favor, repórtalo de forma privada — consulta SECURITY.md.
¿Las herramientas se agotan? 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 otros 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

El código fuente del servidor se mantiene en un monorepo privado; este repositorio contiene los documentos públicos, el plugin, las habilidades y los ejemplos. Los informes de errores y las contribuciones son bienvenidos — consulta CONTRIBUTING.md.

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: 123
Métodos: GET=43, POST=80, 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`	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 qué OpenEphemeris para agentes de IA?

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

Al combinar LLM 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 LLM (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.