MCP - conexión Claude / Cursor

El servidor Model Context Protocol de AstroWay expone todos los 771 endpoints como herramientas para un agente de IA. Dos modos, ambos soportados nativamente por todos los clientes compatibles con MCP.

Modo	URL / comando	Cuándo elegir
Hosted HTTP	https://mcp.astroway.info/mcp	Claude Web (claude.ai en el navegador), Claude Desktop / Cursor / Code newcomers sin npm, o cuando quieres instalación cero
Stdio (npm)	npx @astroway/mcp	Usuarios avanzados de Cursor, desarrollo local, conscientes de la privacidad (la clave nunca sale de tu máquina), listos para usar sin conexión

El endpoint alojado y el paquete npm utilizan el mismo catálogo de herramientas (generado a partir de un único /v1/openapi.json). Autenticación: la misma clave API aw_test_* / aw_live_* – en el modo alojado se envía a través del encabezado Authorization: Bearer …, en stdio a través de la variable de entorno ASTROWAY_API_KEY.

Fuente: github.com/astroway/astroway-mcp · npm: npmjs.com/package/@astroway/mcp · alojado: mcp.astroway.info/health

Alojado (mcp.astroway.info) - instalación cero

Inicio rápido sin npm: elige tu cliente. Antes de la instalación, obtén tu clave en api.astroway.info/dashboard/sign-up (10 000 créditos/mes gratis).

Cursor (un clic)

Haz clic en el botón - Cursor se abrirá, te pedirá confirmación y añadirá la entrada automáticamente:

Instalar en Cursor →

Paso 2 obligatorio - de lo contrario no funcionará

Cursor no puede sustituir el secreto del deeplink - en ~/.cursor/mcp.json se escribirá el literal Bearer YOUR_API_KEY, al que el servidor responde con 403 invalid_format.

Después de hacer clic en el botón:

1. Configuración de Cursor (⚙️ esquina superior derecha) → Herramientas y MCP → busca astroway-hosted en la lista.
2. Haz clic en los tres puntos (⋯) junto al servidor → Editar configuración.
3. En el campo Authorization, reemplaza Bearer YOUR_API_KEY por Bearer aw_test_… (o aw_live_…) - tu clave real del Panel de control.
4. Guarda → vuelve a abrir la lista de MCP → asegúrate de que el estado sea habilitado + punto verde + contador 780+ herramientas habilitadas.

Alternativamente, edita el archivo directamente: ~/.cursor/mcp.json (headers.Authorization).

Nota

Cursor impone un límite en la longitud de los nombres: server_name:tool_name ≤ 60 caracteres. Aproximadamente 90 de las más de 780 herramientas (principalmente los grupos hellenistic_*, psychological_*, zi_wei_*, zodiac_* y numerology_*) son filtradas por Cursor y no estarán disponibles a través del LLM. Las otras ~690 funcionan. En Claude Desktop no existe tal límite - el catálogo completo.

Claude Desktop

Configuración → Desarrollador → Editar configuración abre claude_desktop_config.json. Este archivo solo ejecuta comandos locales: una entrada con solo url se omite con el mensaje “Some MCP servers couldn’t be loaded”. El servidor alojado se conecta a través del puente mcp-remote, que requiere Node.js:

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Cierra completamente Claude Desktop (Cmd+Q) y ábrelo de nuevo. La clave se encuentra en env, porque Claude Desktop en Windows divide el argumento en el espacio después de Bearer.

El diálogo Añadir conector personalizado en Configuración → Conectores solo acepta el nombre y la URL; no hay un campo para el encabezado Authorization, por lo que la clave de AstroWay no se puede pasar a través de él por ahora.

Configuración JSON (manual)

Para Cursor, Cline, Continue y Windsurf, que aceptan una url remota directamente:

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Rutas a los archivos de configuración:

• Cursor: ~/.cursor/mcp.json (global) o .cursor/mcp.json (en el espacio de trabajo)
• Cline (VS Code): .cline/mcp.json en el espacio de trabajo
• Continue: ~/.continue/config.json (bloque mcpServers)
• Windsurf: ~/.codeium/windsurf/mcp_config.json

Después de editar, reinicia completamente el cliente (Cmd+Q → abrir de nuevo).

Verificación

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

En el cliente, pide: “List 5 AstroWay tool names from astroway-hosted”. Debería devolver nombres como astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Límites de tasa

El endpoint alojado está protegido por una limitación de 3 niveles: capa DDoS de Cloudflare + proxy de borde 120 req/min/IP + cubo en memoria 60/60s/(IP+key). Los clientes MCP reales (Claude Desktop, Cursor) no se acercan a estos límites, ya que no realizan solicitudes en ráfaga. Si tu automatización / CI requiere > 120 req/min, utiliza el modo stdio (no hay límites allí, va directamente a través de api.astroway.info/v1/* con tu límite de tasa tarifario).

¿Qué pasa si mcp.astroway.info no está disponible temporalmente?

Si el endpoint alojado devuelve un 5xx, el cliente MCP verá un error al intentar tools/list. Esto no afecta a los clientes stdio, ya que ejecutan un paquete npm local que se conecta directamente a api.astroway.info/v1/* sin la capa alojada intermedia.

Fallback para integraciones críticas: añade un segundo servidor MCP a la configuración en modo stdio; el cliente lo utilizará automáticamente si el alojado no responde a tools/list:

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

El tiempo de actividad real del endpoint alojado se puede ver en status.astroway.info. Los incidentes de más de 5 minutos se publican como postmortem dentro de los 5 días hábiles (según /sla/).

Stdio (npm) - para desarrollo local

@astroway/mcp - un paquete npm que se ejecuta localmente como un subproceso. Un único paquete npm, integración nativa con Claude Desktop, Cursor y cualquier cliente compatible con MCP.

Cómo funciona

La lista de herramientas se genera en el momento de la compilación a partir de la especificación OpenAPI en vivo (api.astroway.info/v1/openapi.json). Cada lanzamiento del paquete incorpora automáticamente todos los nuevos endpoints, sin necesidad de mantenimiento manual.

Cada endpoint se convierte en una herramienta de la siguiente forma:

• tools/list devuelve la descripción y el esquema de entrada (con un ejemplo del cuerpo de la solicitud)
• tools/call realiza un HTTP POST a https://api.astroway.info/v1/<path> con tu ASTROWAY_API_KEY
• La respuesta se devuelve al agente como JSON estructurado

Cada lanzamiento también se envía con procedencia SLSA (certificada por Sigstore) - esto garantiza que el paquete npm se construyó a partir de un commit en el repositorio público.

Instalación

Claude Desktop (macOS)

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Reinicia Claude Desktop. En la barra debajo del chat aparecerá un indicador 🛠️ con el número de herramientas cargadas.

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 cada cliente compatible con MCP. La configuración es idéntica, solo cambia la ruta del archivo:

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

Cliente	Ruta del archivo 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)	bandera de vista previa → mcp.json en el espacio de trabajo
VS Code MCP extension	~/.vscode/mcp.json

Otros clientes MCP

Ejecuta como servidor stdio:

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Consejo

Obtén tu clave en api.astroway.info/dashboard/sign-up. Nivel gratuito - 10 000 créditos/mes, sin tarjeta.

Privacidad - desde v1.0.0+

Este servidor MCP no envía nada de vuelta a AstroWay excepto las propias llamadas a la API que le pides que ejecute. Sin telemetría, sin análisis, sin interruptores de opt-in/opt-out - silencio por defecto.

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

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

Ninguno de ellos contiene ID de sesión, huella digital de la máquina o cualquier cosa personal. Esta es la semántica estándar de User-Agent: cada herramienta CLI envía información similar.

Registro de subconjuntos - desde v1.0.0+

Si utilizas solo una parte del catálogo, registra un subconjunto para que la ventana de contexto del LLM permanezca compacta:

{
  "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/compuesto/davison), prognostics (tránsitos/progresiones/retornos), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Ejecuta npx @astroway/mcp --list-tools para ver el conjunto completo.

ASTROWAY_READONLY=1 omite tres grupos que internamente invocan al LLM (ai, horoscope, reports) - útil cuando quieres matemáticas de cartas puras y deterministas sin gastar créditos en la generación de texto.

Compromiso de estabilidad - desde v1.0.0+

• El catálogo está congelado durante la sesión. Más de 780 herramientas, 12 prompts, 14 recursos están incrustados en el paquete npm publicado en el momento de la compilación; nada cambia durante la conexión. Si tu cliente almacena en caché tools/list después de la primera llamada, permanece correcto durante toda la sesión.
• Los identificadores de herramientas son estables dentro de una versión mayor. Un nombre bajo astroway_<group>_<tool> no será renombrado ni eliminado dentro de v1.x sin una nota de deprecación en CHANGELOG.md y disponibilidad paralela de una versión menor.
• La forma de entrada de la herramienta es estable dentro de una versión menor. Las restricciones (regex, rango, enum) llegan en parches; la adición de un campo obligatorio requiere un incremento menor de versión.
• Actualización del catálogo: reinstalando. npm i -g @astroway/mcp@latest (o la forma npx -y @astroway/mcp en tu configuración) obtiene el conjunto actual en el siguiente inicio.

Ejemplos de prompts

Después de conectar el servidor, pide a la IA:

Carta natal

Calcula mi carta natal - nacido el 15 de marzo de 1990, 14:30, Kiev. Describe el Sol, la Luna, el Ascendente y encuentra los aspectos cercanos.

Claude invocará la herramienta chart con tus parámetros, obtendrá un JSON estructurado y describirá la carta con palabras.

Tránsitos

¿Qué tránsitos significativos de planetas lentos afectarán mi carta natal durante el año 2027?

Claude realiza dos llamadas a herramientas: primero transits (instantánea actual), luego transit-calendar (rango). Interpreta las tendencias.

Mahadasha Védica

Ejecuta Vimshottari Mahadasha para una persona nacida el 22.07.1985 06:45 en Mumbai. ¿En qué período se encuentra esta persona ahora?

A través de la herramienta vedic/dashas/vimshottari/maha - la marca de tiempo UTC exacta del período actual.

Sinastría

Compara dos cartas: A - 10.06.1988 09:15 Londres, B - 22.11.1991 22:40 Berlín. ¿Cuáles son los aspectos cruzados más fuertes?

Herramienta synastry con dos bloques chart + interpretación de la puntuación de compatibilidad.

Tarot

Saca 3 cartas Rider-Waite-Smith: Pasado - Presente - Futuro. Pregunta: “¿debería aceptar el nuevo trabajo?”. Semilla = 42.

tarot/rider-waite/spread con una semilla fija para reproducibilidad.

Lista de todas las herramientas

Después de la conexión, pregunta a Claude:

Enumera todas las herramientas de astroway.

O desde la línea de comandos:

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Configuración

Variable	Por defecto	Descripción	Desde la versión
ASTROWAY_API_KEY	(obligatorio)	En vivo: aw_live_.... Sandbox: aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Anulación para entornos autoalojados/de staging.	0.1.0
ASTROWAY_TOOL_GROUPS	(todos los grupos)	Prefijos separados por comas para limitar el catálogo (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 omite los grupos respaldados por LLM (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug - nivel de registro en stderr.	0.8.0
LOG_FILE	(no se escribe)	Ruta al archivo para duplicar los registros.	0.8.0
MCP_FLAT_TOOLS	0	1 devuelve nombres planos pre-v0.9 (chart en lugar de astroway_western_chart). Legado.	0.9.0

¿Por qué MCP y no una integración directa?

Un LLM genérico (sin fundamentación) dirá “en algún momento de julio, Saturno formará un trígono con tu Júpiter” - sin fecha exacta, con una desviación de ±15 días. Un agente MCP realiza un tool_use POST /v1/transits y devuelve una marca de tiempo UTC al segundo, basada en el auténtico Swiss Ephemeris.

La ventaja no está en el LLM, sino en la garantía de que las matemáticas son reales, no inventadas.

Distribución del paquete

• Listado en mcp.so: mcp.so/server/astroway-mcp/astroway
• mcpservers.org: pendiente de aprobación (a mayo de 2026)
• awesome-mcp-servers (punkpeye): PR #5972

Enlaces

• 📦 npm: npmjs.com/package/@astroway/mcp
• 📘 Documentación de la API: /docs/api/
• 🔑 Registrarse: /dashboard/sign-up
• 💰 Precios: /pricing/
• 🌐 Repositorio público (MIT): github.com/astroway/astroway-mcp