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

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

En este artículo, te explicaré cómo agregar cálculos astrológicos a un agente de inteligencia artificial a través de MCP. Te tomará menos de 5 minutos.

MCP es un protocolo que permite a los modelos de inteligencia artificial invocar herramientas. Imagina un “REST API para agentes de inteligencia artificial”:

• Servidor expone herramientas (cálculos, solicitudes, acciones)
• Cliente (Claude Desktop, Cursor, agente personalizado) las detecta y las invoca
• El modelo decide cuándo aplicar qué herramienta, según la solicitud del usuario

Los servidores MCP pueden ser locales (iniciados como subprocesos) o remotos (HTTP). La mayoría de los servidores locales se publican en npm y se inician a través de npx.

El servidor MCP de AstroWay expone 25 herramientas que cubren cálculos astrológicos básicos:

• natal_chart — carta natal completa
• synastry — compatibilidad entre dos personas
• transits — tránsitos actuales en la carta natal
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — interpretaciones de inteligencia artificial
• human_design — carta de diseño humano completa
• hd_incarnation_cross, hd_compatibility — características de diseño humano
• 12 herramientas más que cubren progresiones, retornos solares, astrocartografía, rectificación

Regístrate en astroway.info y crea una clave de 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

Agrega el servidor de AstroWay:

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

Después de reiniciar, verás un icono de martillo con 25 herramientas disponibles.

Ahora solo habla con Claude en lenguaje natural:

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

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

Claude mismo:

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

Si estás creando un agente de inteligencia artificial personalizado (no Claude Desktop), también puedes utilizar 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'],
});

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

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

// Invocación de herramienta
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 marcos de trabajo para agentes (LangChain, LlamaIndex, etc.) tienen soporte integrado para MCP.

Si no deseas los gastos adicionales de MCP, puedes llamar a la API de HTTP 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();
}

// Uso en el ciclo del agente
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, intenta 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 Diseño Humano. Nací el 22 de abril de 1987 a las 16:45 en Londres».
3. «Compara la compatibilidad entre dos personas: yo (14 de julio de 1990, Kiev) y mi amiga (22 de marzo de 1992, París)».
4. «¿Cuáles son los tránsitos principales para mí hoy? Dame 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 mismo elegirá las herramientas necesarias, invocará varias en cadena y formateará la respuesta en lenguaje humano.

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

• No ofrecen consejos médicos, legales ni financieros
• Descargos de responsabilidad autoinsertados
• Filtro de contenido

Cuando el agente muestra texto de interpretación al usuario, conserva el descargo de responsabilidad. Está en el campo disclaimer de cada respuesta de inteligencia artificial.

Las llamadas a MCP pasan por el mismo sistema de créditos que la API de HTTP. Muestras simples (10 créditos) → carta (20) → sinastria (50) → interpretación de inteligencia artificial (50).

Para uso personal (un usuario que hace preguntas a Claude) — alrededor de 200-500 créditos al mes. El plan gratuito es suficiente.

Para un agente de producción con cientos de usuarios — calcula según la mezcla de endpoints. Un 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 de inteligencia artificial y MCP — caso de uso — guía de integración completa
• API de horóscopos e interpretaciones de inteligencia artificial — página del producto
• Inicio rápido — obtén una clave de API (gratuita, 10 000 créditos/mes)