Agrega astrología a tu agente de IA a través de MCP

Si has trabajado con Claude Desktop el último año, seguramente has visto MCP (Model Context Protocol). Es un estándar abierto de Anthropic para conectar herramientas externas a los modelos de AI. Unas pocas líneas de configuración y Claude puede acceder al sistema de archivos, bases de datos o cualquier API.

En este post, cómo añadir cálculos astrológicos a un agente de AI mediante MCP. Tiempo: menos de 5 minutos.

MCP es un protocolo mediante el cual los modelos de AI invocan herramientas. Imagina que es un “REST API para agentes de AI”:

• Servidor expone herramientas (cálculos, consultas, acciones)
• Cliente (Claude Desktop, Cursor, agente personalizado) las descubre y las invoca
• El modelo decide por sí mismo cuándo y qué herramienta usar: en base a la solicitud del usuario

Los servidores MCP pueden ser locales (ejecutados como subproceso) o remotos (HTTP). La mayoría son locales, se publican en npm y se inician mediante npx.

MCP-сервер AstroWay expone una herramienta por cada operación de API, 735 en el paquete npm y 843 en el servidor alojado, con nombres del tipo astroway_<grupo>_<operación>:

• astroway_western_chart y herramientas relacionadas para cartas, tránsitos, progresiones y retornos
• astroway_relational_* para sinastría, composite y cartas grupales
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretaciones de AI
• grupos Human Design, védica, china, helenística, tarot y numerología

Para acortar la lista, conecta un solo servidor de dominio en lugar del catálogo completo, ver configuración MCP

Regístrate en astroway.info y crea una clave API gratuita (10 000 créditos/mes, sin tarjeta).

Archivo claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Añade el servidor astroway:

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Después del reinicio, las herramientas AstroWay aparecerán en el menú de herramientas del campo de entrada del chat.

Ahora simplemente habla con Claude en lenguaje natural:

Tú: Genera la carta natal de una persona nacida el 14 de julio de 1990 a las 14:30 en Kyiv. ¿Qué significa su Sol en Cáncer en la casa 10?

Claude: Invoca natal_chart con las coordenadas parseadas, luego interpret_placement. Aquí está la carta natal. El Sol en Cáncer en la casa 10 indica…

Claude mismo:

• parsea el lenguaje natural (ciudad → coordenadas)
• elige la herramienta correcta
• formatea la respuesta

Si construyes un agente AI personalizado (no Claude Desktop), también puedes usar el servidor MCP. El protocolo está documentado:

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

La mayoría de los frameworks para agentes (LangChain, LlamaIndex, etc.) tienen soporte integrado para MCP.

Si no quieres los costos adicionales de MCP, llama al HTTP-API directamente desde el agente:

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Ventajas de MCP: descripciones estructuradas de herramientas, autodetección, manejo de errores estandarizado. Ventajas de HTTP: más simple, funciona en cualquier lugar, sin subprocesos.

Cuando MCP esté configurado, prueba en Claude:

1. ¿Cuál es mi horóscopo diario? Nací el 3 de octubre de 1993 a las 6 de la mañana en Nueva York.
2. Calcula mi tipo de Human Design. Nacido el 22 de abril de 1987 a las 16:45 en Londres.
3. Compara la compatibilidad de dos personas: yo (14 de julio de 1990, Kyiv) y mi amiga (22 de marzo de 1992, París).
4. ¿Cuáles son los principales tránsitos para mí hoy? Da una interpretación.
5. No sé la hora exacta de nacimiento. ¿Qué muestra el análisis de sensibilidad para un rango de ±30 minutos?

Claude seleccionará automáticamente las herramientas necesarias, llamará varias en cadena de forma coordinada y formateará la respuesta en lenguaje humano.

Las herramientas de interpretación AI de AstroWay (interpret_*, *_horoscope) tienen guardrails de seguridad integrados:

• Ningún consejo médico, legal o financiero
• Disclaimer automáticos inyectados
• Filtrado de contenido

Cuando el agente muestra el texto de interpretación al usuario, mantén el disclaimer. Está en el campo disclaimer de cada respuesta de AI.

Las llamadas MCP pasan por el mismo sistema de créditos que HTTP. Muestras simples (10 créditos) → chart (20) → sinastría (50) → interpretación AI (50).

Para uso personal (un usuario que hace preguntas a Claude) - alrededor de 200–500 créditos al mes. Plan gratuito con holgura.

Para un agente en producción con cientos de usuarios - calcula según la mezcla de endpoints. Bot de horóscopo diario para 1 000 usuarios = 1 000 × 20 × 30 = 600 000 créditos/mes → plan Pro.

• AstroWay MCP en npm
• Agentes AI y MCP: caso de uso: guía de integración completa
• Horoscope & AI Interpretations API: página del producto
• Inicio rápido: obtén la clave API (gratis, 10 000 créditos/mes)