AstroWay MCP

We need to translate the given text from English to Spanish. The text describes an MCP server for astrology. We must preserve product names, protocol names, URLs, numbers, technical terms. The name "AstroWay MCP" is not in the text, but the text includes "AstroWay Calculation API" and "npx @astroway/mcp". We should preserve those. Also preserve "Swiss Ephemeris", "Rider-Waite-Smith", "Marseille", "Lenormand", "Vimshottari/Yogini/Ashtottari/Kalachakra", "Human Design", "AI horoscopes", "Sub-arcsecond", "10 000 free credits/month", "no card required", "npx @astroway/mcp". Translate the rest naturally. The text: "Comprehensive astrology MCP backed by the AstroWay Calculation API — natal, synastry, transits, Vedic dashas (Vimshottari/Yogini/Ashtottari/Kalachakra), Tarot

GitHub

Prueba este MCPPatrocinado

Documentación

@astroway/mcp

Servidor MCP (Model Context Protocol) que expone todos los endpoints de la AstroWay Calculation API como herramientas para Claude Desktop, Cursor y cualquier agente de IA compatible con MCP.

Cartas natales, sinastría, tránsitos, dashas védicos (Vimshottari, Yogini, Ashtottari, Kalachakra), 16 Vargas, Tarot (Rider-Waite / Marseille / Lenormand), Numerología (5 sistemas), Human Design, horóscopos con IA, todo envuelto como herramientas MCP que el agente puede invocar directamente.

Las herramientas se generan automáticamente a partir del manifiesto de la API en vivo durante la compilación, por lo que cada versión incluye todos los endpoints que existen en producción. Sin mantenimiento manual de listas de herramientas.

Instalación

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Reinicia Claude Desktop. El servidor astroway aparecerá en el indicador MCP en la parte inferior del campo de entrada del chat.

Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

El mismo comando npx @astroway/mcp funciona en cualquier cliente compatible con MCP. Coloca este bloque en el archivo de configuración MCP del cliente (la ruta varía según el cliente):

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Ubicaciones de configuración:

Cliente	Ruta de configuración
Cline (VS Code)	`.cline/mcp.json` en la raíz del espacio de trabajo
Continue	`~/.continue/config.json` (bajo `mcpServers`)
Windsurf	`~/.codeium/windsurf/mcp_config.json`
GitHub Copilot Chat (VS Code)	habilita la vista previa en la configuración, luego `mcp.json` en el espacio de trabajo
Extensión MCP de VS Code	`~/.vscode/mcp.json`

Otros clientes MCP

Ejecuta como servidor stdio:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Privacidad

Este servidor MCP no se comunica con el exterior. No hay telemetría, ni análisis, ni informes de uso, ni interruptor de activación/desactivación que mantener. El único tráfico de red que origina el servidor son las llamadas a la API de AstroWay que le pides que realice, yendo directamente desde tu máquina a https://api.astroway.info/v1.

Las solicitudes salientes llevan dos cabeceras de identificación para que el backend de AstroWay pueda distinguir el tráfico MCP del tráfico HTTP bruto en sus propios registros:

User-Agent: astroway-mcp/<version> (Node/<node-version>)
X-Astroway-Channel: mcp

Ninguna de las dos cabeceras lleva ID de sesión, huella de máquina ni nada personal. Reflejan la semántica estándar de User-Agent HTTP: toda herramienta CLI ya envía información similar.

Registro de subconjuntos (avanzado)

Si solo usas parte del catálogo, puedes registrar un subconjunto y mantener tu ventana de contexto LLM ligera:

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Grupos comunes: western, vedic, tarot, numerology, hd (Human Design), relational (sinastría/composite/davison), prognostics (tránsitos/progresiones/retornos), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Ejecuta npx @astroway/mcp --list-tools para inspeccionar el conjunto completo; el campo de línea de arranque filters: … muestra lo que se aplicó.

ASTROWAY_READONLY=1 omite los tres grupos que internamente llaman a un LLM (ai, horoscope, reports), útil cuando quieres matemática de cartas puramente determinista sin gastar créditos en generación de texto.

Modo de descubrimiento (ligero)

Si tu agente alcanza los límites de contexto o de número de herramientas con el catálogo completo, establece ASTROWAY_DISCOVERY_MODE=1. En lugar de registrar más de 600 herramientas de antemano, el servidor expone solo dos meta-herramientas:

astroway_find_tool(query, limit?): búsqueda por palabras clave en todo el catálogo; devuelve las herramientas que mejor coinciden con su descripción de una línea y los nombres de los parámetros de entrada.
astroway_call_tool(name, arguments?): invoca cualquier herramienta que haya aparecido en la búsqueda.

El agente descubre la herramienta adecuada bajo demanda y luego la invoca, alcanzando todo el catálogo desde una huella de dos herramientas.

Compromiso: una herramienta despachada a través de astroway_call_tool devuelve su resultado solo como texto. Una llamada despachada en tiempo de ejecución no puede declarar un outputSchema por llamada, por lo que no puede llevar el structuredContent validado que proporcionan las herramientas registradas directamente. Deja ASTROWAY_DISCOVERY_MODE sin establecer (el valor predeterminado) cuando quieras salida estructurada tipada; úsalo cuando la presión por el número de herramientas importe más. El descubrimiento tiene prioridad sobre ASTROWAY_TOOL_GROUPS / ASTROWAY_READONLY.

Estabilidad

El catálogo está congelado durante la duración de una sesión. Las 624 herramientas, 12 prompts y 14 recursos están integrados en el paquete npm publicado y no cambian en tiempo de ejecución. (La capacidad MCP listChanged es anunciada por el SDK, pero esta compilación nunca emite una notificación */list_changed. Si tu cliente almacena en caché el catálogo después del primer tools/list, seguirá siendo correcto durante toda la conexión.)
Los identificadores de herramientas son estables dentro de una versión principal. Un nombre publicado bajo astroway_<group>_<tool> no será renombrado ni eliminado dentro del mismo minor de v0.x sin una nota de deprecación en CHANGELOG.md. Entre saltos de versión principal (v1 → v2), cualquier cambio disruptivo se anuncia y la vía de escape heredada (MCP_FLAT_TOOLS=1) te lleva a través de un minor.
La forma de entrada de las herramientas es estable dentro de un minor. El endurecimiento (regex, rango, enum) se publica en parches; añadir campos obligatorios requiere un salto de minor.
Actualiza el catálogo reinstalando. npm i -g @astroway/mcp@latest (o la forma npx -y @astroway/mcp ya presente en la configuración de tu cliente) obtiene el conjunto actual en el siguiente inicio.

Verificar la instalación

Después de reiniciar tu cliente MCP:

Abre el indicador MCP (parte inferior del campo de entrada del chat en Claude Desktop, barra de estado en Cursor).
Deberías ver astroway listado como servidor activo.
Pasa el cursor o haz clic, y la insignia mostrará 624 tools registered + 12 prompts + 14 resources (recuentos de la última versión).
El arranque en frío tarda 2-3 segundos la primera vez (Node + handshake TLS con api.astroway.info).
Comprobación rápida desde cualquier terminal: npx @astroway/mcp --version imprime la versión del paquete, npx @astroway/mcp --list-tools synastry imprime las herramientas coincidentes.

Si el servidor no aparece, establece LOG_LEVEL=debug en el bloque env anterior y reinicia: la línea de arranque y cualquier error de inicio aparecerán en el panel de depuración MCP del cliente.

Obtener una clave API

Regístrate en https://api.astroway.info/dashboard/sign-up: 10 000 créditos/mes gratis, sin necesidad de tarjeta. Cada solicitud cuesta entre 5 y 500 créditos según el endpoint (consulta precios).

Para pruebas locales sin plan de pago, usa una clave de sandbox (aw_test_...) que devuelve respuestas deterministas de forma gratuita.

Lo que obtienes

Categorías de herramientas, con ejemplos a continuación. Ejecuta npx @astroway/mcp una vez y pide al agente "lista herramientas de astroway" para el inventario completo en vivo (el paquete se sincroniza automáticamente con la API en cada versión).

Categoría	Ejemplos
Núcleo	carta natal, posiciones planetarias, draconic, armónicos
Comparaciones	sinastría, composite, davison, compatibilidad entre sistemas
Prognósticos	tránsitos, progresiones secundarias, retorno solar/lunar, calendario de tránsitos
Cartas Especializadas	heliocéntrica, sidérea, búsqueda de eclipses
Aspectos y Puntos	tabla de aspectos, antiscia, puntos medios, partes arábigas, estrellas fijas
Calendario y Ciclos	períodos retrógrados, ingresos, fases lunares, horas planetarias
Dignidades y Recepciones	dignidades esenciales, almuten, hyleg, disposidores
Horaria	carta horaria, luna vacía de curso, via combusta
Human Design	carta completa, tránsitos, penta, dream rave, perfil hologenético
Astro-Geografía	astrocartografía, espacio local, carta de reubicación
Védico	16 Vargas, Panchang, Shadbala, 4 sistemas Dasha × 5 niveles (Vimshottari / Yogini / Ashtottari / Kalachakra), Yogas, Doshas, Compatibilidad, Muhurat
Tarot	mazos Rider-Waite-Smith, Marseille, Lenormand; tiradas + consultas de cartas
Numerología	Pitagórica, Caldea, Cabalística, Védica, Matriz del Destino
Esotérico	I Ching, símbolos sabianos, dados de la fortuna, correspondencias de colores y gemas
Referencia	signos, planetas, casas, aspectos, nakshatras, Lotes Helenísticos, textos natales (copias de interpretación editadas, sin IA)
Interpretaciones con IA	natal, sinastría, tránsitos; chat basado en la carta con cuatro personajes; 21 idiomas
Horóscopo	diario, semanal, mensual, compatibilidad (basado en signos zodiacales)

Ejemplos de prompts

Después de conectar el servidor, prueba estos en Claude Desktop:

Carta natal

Calcula una carta natal para mí, nacido el 1990-03-15 a las 14:30 en Kyiv, Ucrania (50.45N 30.52E, UTC+2). Identifica mi sol, luna, ascendente y cualquier aspecto tenso.

Sinastría

Compara dos cartas: persona A nacida el 1988-06-10 09:15 en Londres (51.51N -0.13E UTC+1), persona B nacida el 1991-11-22 22:40 en Berlín (52.52N 13.40E UTC+1). ¿Cuáles son los aspectos cruzados más fuertes?

Dasha Vimshottari Védico

Ejecuta un Mahadasha Vimshottari para alguien nacido el 1985-07-22 06:45 en Mumbai (19.07N 72.87E UTC+5.5). ¿En qué período planetario están ahora mismo (mayo de 2026)?

Pronóstico de tránsitos

¿Qué tránsitos importantes de planetas exteriores afectan mi carta natal el 2027-01-01? Nacimiento: 1990-03-15 14:30 Kyiv (50.45 30.52 UTC+2).

Lectura de tarot

Saca una tirada de 3 cartas Pasado-Presente-Futuro del mazo Rider-Waite para la pregunta "¿debería aceptar el nuevo trabajo?". Usa la semilla 42 para reproducibilidad.

Human Design

¿Cuál es el tipo, la estrategia y la autoridad de Human Design para alguien nacido el 1990-03-15 14:30 Kyiv (50.45 30.52 UTC+2)? Enumera sus centros definidos y su cruz de encarnación.

Chat basado en la carta

Usando astroway_mcp_ai_chat, pregunta qué significa mi colocación de Saturno. Nacido el 1990-03-15 14:30 Kyiv (50.45 30.52 UTC+2). La respuesta debe citar la casa y los orbes de aspecto en los que se basa.

Configuración

Variable de entorno	Predeterminado	Descripción
`ASTROWAY_API_KEY`	(obligatorio)	Tu clave API. En vivo: `aw_live_...`. Sandbox: `aw_test_...`.
`ASTROWAY_BASE_URL`	`https://api.astroway.info/v1`	Anulación para instancias autoalojadas / de staging.

Cómo se generan las herramientas

Un script en tiempo de compilación lee el manifiesto canónico de endpoints de la API de producción, clasifica cada endpoint por forma de entrada (chart, twoChart, chartTarget, horoscopeSign, year, date, generic) y emite una definición de herramienta tipada. El servidor MCP registra entonces cada entrada contra un Tool con el esquema de entrada Zod apropiado.

Cuando la API publica nuevos endpoints, la siguiente versión MCP los incluye automáticamente, sin definiciones manuales de herramientas que mantener sincronizadas.

Solución de problemas

Claude Desktop no muestra el servidor. Revisa la parte inferior del campo de entrada del chat para ver el indicador MCP (icono de control deslizante). Haz clic para ver los servidores registrados y cualquier error de inicio. Si falta astroway, ejecuta el comando npx @astroway/mcp manualmente en una terminal, donde los errores de inicio se imprimen en stderr.

Las herramientas devuelven Error 401. La clave API falta, no es válida o fue revocada. Genera una nueva en https://api.astroway.info/dashboard/keys.

Las herramientas devuelven Error 402. Sin créditos en el nivel gratuito. Mejora tu plan en https://api.astroway.info/pricing/ o espera al reinicio mensual.

Las herramientas devuelven Error 422 con errores de validación de campos. El LLM pasó un cuerpo que la API no aceptó. Pide a Claude que reintente con el cuerpo de ejemplo mostrado en la descripción de la herramienta, o usa la clave de sandbox (aw_test_...) para depurar sin gastar créditos.

Estructura del repositorio

Este repositorio es el escaparate público de @astroway/mcp: README, CHANGELOG, LICENSE, instrucciones de instalación. El código ejecutable es el propio paquete npm publicado: instálalo con npm install @astroway/mcp o ejecútalo mediante npx @astroway/mcp.

El código fuente se mantiene en el monorepo privado de AstroWay para que el generador en tiempo de compilación pueda leer el manifiesto canónico de endpoints del espacio de trabajo de la API contiguo. El paquete generado es de código abierto bajo MIT y publica cada versión en npm.

Historial de cambios

Consulta CHANGELOG.md.

Enlaces

📦 npm: https://www.npmjs.com/package/@astroway/mcp
📘 Documentación de la API: https://api.astroway.info/docs/api/
🔑 Registro y panel de control: https://api.astroway.info/dashboard/
💰 Precios: https://api.astroway.info/pricing/
🌐 Sitio web: https://astroway.info

Licencia

MIT, consulta LICENSE.