MCP Server: use AstroAPI desde asistentes de IA

AstroAPI ofrece un servidor Model Context Protocol (MCP) alojado. Conéctelo a un asistente de IA como Claude Code, Claude Desktop o Cursor, y el asistente podrá llamar a AstroAPI directamente: buscar lugares de nacimiento, calcular cartas y explicar los resultados en un lenguaje sencillo.

Esta es también la forma más rápida de construir una integración: conecte el servidor MCP a su asistente de codificación de IA y pídale que escriba el código de integración por usted. El asistente puede hacer llamadas reales a la API mientras trabaja, de modo que ve respuestas reales en lugar de adivinar.

No se requiere código

Una vez conectado, puede simplemente pedirle a su asistente cosas como «Calcula la carta natal de una persona nacida el 15 de junio de 1990 a las 14:30 en Ámsterdam» — el asistente resuelve la ubicación, llama a la API y resume el resultado.

---

Endpoint

https://mcp.astroapi.cloud/mcp

• Transporte: Streamable HTTP
• Autenticación: su clave habitual de AstroAPI, enviada en el encabezado X-Api-Key
• Los módulos, límites de velocidad y cuotas de su suscripción se aplican exactamente igual que en las llamadas directas a la API.

Puede crear una clave de API en el panel de control en API Keys. Consulte Autenticación para más detalles.

---

Conectar Claude Code

Ejecute esto una sola vez en su terminal:

claude mcp add --transport http astroapi https://mcp.astroapi.cloud/mcp \
  --header "X-Api-Key: YOUR_API_KEY"

Después, simplemente pídale a Claude Code que use AstroAPI — por ejemplo: «Usa las herramientas de astroapi para calcular una carta natal para el 15/06/1990 a las 14:30 en Ámsterdam y constrúyeme un componente de React que la muestre.»

Conectar Cursor

Añada esto a .cursor/mcp.json en su proyecto (o a ~/.cursor/mcp.json de forma global):

{
  "mcpServers": {
    "astroapi": {
      "url": "https://mcp.astroapi.cloud/mcp",
      "headers": {
        "X-Api-Key": "YOUR_API_KEY"
      }
    }
  }
}

Conectar otros clientes MCP

Funciona cualquier cliente que admita MCP sobre Streamable HTTP con encabezados personalizados. Configure:

Ajuste	Valor
URL	https://mcp.astroapi.cloud/mcp
Transporte	Streamable HTTP
Encabezado	X-Api-Key: YOUR_API_KEY

Clientes alojados sin encabezados personalizados

Algunos clientes alojados (como los conectores web de claude.ai) no pueden enviar encabezados personalizados y requieren OAuth. La compatibilidad con OAuth está en la hoja de ruta; por ahora, use un cliente que admita encabezados personalizados, como Claude Code, Claude Desktop o Cursor.

---

Herramientas disponibles

Herramienta	Qué hace
astro_resolve_place	Busca un nombre de lugar y devuelve las coordenadas y la zona horaria IANA. Los asistentes reciben la instrucción de llamar a esta herramienta primero, para que nunca adivinen las coordenadas.
astro_natal_chart	Calcula una carta natal (puntos, casas, aspectos), opcionalmente con textos de interpretación, y devuelve un resumen compacto y legible.

Hay más herramientas en camino (tránsitos, sinastría, compatibilidad, fases lunares, imágenes de cartas y otras). La disponibilidad de las herramientas depende de los módulos de su suscripción: una herramienta que su plan no incluye devuelve un mensaje claro en lugar de datos.

---

Sesión de ejemplo

Una conversación con un asistente conectado podría verse así:

Usted: ¿Cuáles son el signo solar y el ascendente de una persona nacida el 3 de marzo de 1985 a las 6:45 en Barcelona?

Asistente: llama a astro_resolve_place con «Barcelona», y luego a astro_natal_chart con las coordenadas y la zona horaria resueltas — El Sol está en Piscis a 12°41′ en la casa 1, y el Ascendente es Acuario 28°10′ …

El asistente se encarga de la geocodificación, la conversión de zona horaria y la llamada a la API — justo lo que suele salir mal al introducir los datos de nacimiento a mano.

---

Próximos pasos

• Autenticación — crear y gestionar claves de API
• Primeros pasos — los fundamentos de la API detrás de estas herramientas
• Cartas natales — qué devuelve el cálculo natal