FreeAstroAPI Astrology

MCP Alojado

Conecta FreeAstroAPI directamente a herramientas de IA a través de un servidor MCP alojado. No necesitas instalar un servidor local, ejecutar un script ni compilar nada primero. Añade una URL, agrega tu clave de API, reconecta tu herramienta de IA y podrá comenzar a llamar a los endpoints de astrología como herramientas.

Ideal para usuarios centrados en IA: si tu aplicación ofrece "MCP Remoto", "MCP Alojado" o "MCP HTTP Transmisible", elige esa opción. Si solo te pide un comando de terminal, esa aplicación espera un servidor stdio local en su lugar.

URL del Servidor MCP

HTTP https://api.freeastroapi.com/mcp

Claude Desktop: extensión de un clic

El formulario de Conector Personalizado de Claude Desktop no puede agregar el encabezado x-api-key. Instala esta extensión de escritorio en su lugar. Solicita tu clave de FreeAstroAPI durante la configuración y no requiere comandos de terminal.

Descargar para Claude Desktop (.dxt)

/downloads/mcp/freeastroapi-claude-desktop.dxt

Instalación en cuatro pasos

1. Descarga el archivo de la extensión.
2. Abre Claude Desktop → Configuración → Extensiones → Configuración avanzada.
3. Elige Instalar Extensión y selecciona el archivo descargado.
4. Pega tu clave de API y luego habilita FreeAstroAPI en Buscar y herramientas.

1. Agregar el servidor

En tu aplicación de IA, crea un nuevo servidor MCP remoto y pega la URL de esta página.

2. Agregar tu clave de API

Envía tu clave como el encabezado x-api-key. El servidor MCP usa la misma clave y los mismos límites que la API normal.

3. Comienza a preguntar

Una vez conectado, tu IA puede descubrir herramientas y llamarlas directamente en lugar de adivinar datos de astrología.

Configuración Rápida

Name: FreeAstroAPI
Type: Remote / Hosted MCP server
URL: https://api.freeastroapi.com/mcp

Header:
x-api-key: YOUR_API_KEY

Lo Que Obtiene Tu IA

Herramientas de búsqueda y utilidades

• Búsqueda de Ciudades
• Fase Lunar
• Línea de Tiempo de Fases Lunares
• Efemérides
• Endpoints de horóscopo diario

Herramientas de cartas y astrología

• Cálculo de carta natal
• Tránsitos
• Sinastría occidental
• Endpoints de cartas védicas
• Endpoints de BaZi chino

Los endpoints de autenticación, facturación, administración, webhooks y gestión de cuentas están excluidos intencionalmente de MCP.

Buenos Prompts Para Probar

Busca París, Francia y dame la zona horaria y las coordenadas exactas.

Calcula una carta natal para el 1 de junio de 1990 a las 14:30 en Nueva York.

Muéstrame la fase lunar actual y explícala en lenguaje sencillo.

Obtén una tabla de efemérides semanal para Venus y Marte en el zodíaco tropical.

Autenticación

Campo	Valor	Notas
Encabezado	x-api-key	Usa la misma clave de API que ya usas para solicitudes REST.
Comportamiento por nivel	igual que REST	MCP está incluido en todos los niveles, pero las llamadas aún cuentan contra tu uso normal y los límites de RPS.
Transporte	HTTP Transmisible	Elige una opción MCP remota o alojada en tu herramienta de IA.

Avanzado: Llamadas MCP Crudas

La mayoría de los usuarios nunca necesitarán esto. Está aquí para herramientas avanzadas, pruebas y depuración.

Inicializar

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {
        "name": "example-client",
        "version": "1.0.0"
      }
    }
  }'

Llamar a una Herramienta

curl -X POST "https://api.freeastroapi.com/mcp" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "v2_geo_search",
      "arguments": {
        "q": "paris",
        "limit": 3
      }
    }
  }'

Respuesta de Ejemplo

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\n  \"results\": [ ... ],\n  \"count\": 3\n}"
      }
    ],
    "structuredContent": {
      "results": [
        {
          "name": "Paris",
          "country": "FR",
          "lat": 48.85341,
          "lng": 2.3488,
          "timezone": "Europe/Paris",
          "population": 2138551
        }
      ],
      "count": 1
    },
    "metadata": {
      "status_code": 200,
      "path": "/api/v2/geo/search",
      "method": "GET"
    }
  }
}

Solución de Problemas

El Conector Personalizado de Claude Desktop rechaza esta configuración. Descarga la extensión de Claude Desktop arriba. El formulario de conector solo con URL no puede enviar el encabezado x-api-key requerido.

Solo veo configuración de "comando", no de URL. Esa aplicación espera un servidor MCP stdio local. Usa una aplicación que admita MCP remoto o alojado.

El servidor se conecta pero las herramientas fallan. Verifica que tu clave de API sea válida y no haya expirado. MCP usa la misma clave y los mismos límites que la API normal.

Mi IA dice límite de velocidad superado. Las llamadas MCP cuentan exactamente igual que las solicitudes directas a la API. Consulta Límites de Velocidad.

Necesito coordenadas primero. Pide a la IA que use Búsqueda de Ciudades antes de solicitar una carta natal, de tránsito o de sinastría. La IA puede hacerlo automáticamente a través de MCP.