Cursor + Occult API

El servidor MCP pone 299 endpoints de astrología a disposición de Composer como herramientas invocables. En lugar de describir una API y esperar que el modelo escriba bien la solicitud, el agente busca en el catálogo, lee el esquema real de la solicitud y hace la llamada. Así, los números de su respuesta salen de las efemérides y no de sus datos de entrenamiento.

Buscar y leer esquemas no cuesta nada. Solo un call_endpoint correcto gasta un crédito, y las llamadas fallidas son gratis.

Créala en el panel. Tiene la forma yt_live_… y está ligada a tu saldo de créditos, así que trátala como una contraseña: nunca en código del lado del cliente y nunca en un commit.

Crear una clave de API

Abre ~/.cursor/mcp.json (en Windows, %USERPROFILE%\.cursor\mcp.json), créalo si no existe y añade:

{
  "mcpServers": {
    "occult-api": {
      "command": "npx",
      "args": ["-y", "occult-api-mcp"],
      "env": { "OCCULT_API_KEY": "yt_live_your_key_here" }
    }
  }
}

Si prefieres no editar el archivo a mano, tienes lo mismo en Settings → Cursor Settings → MCP → Add new global MCP server.

Sustituye yt_live_your_key_here por tu clave real. No hace falta instalar nada más: npx descarga el servidor la primera vez.

Pídele a Composer:

Enumera las herramientas que tienes del servidor occult-api.

Deberías ver cinco herramientas:

• search_endpoints
• describe_endpoint
• call_endpoint
• get_panchanga
• check_account

Si la lista está vacía, el servidor no ha arrancado. Lo habitual es que el archivo de configuración esté en el sitio correcto pero con el formato equivocado, así que antes de nada revisa el nombre de la clave de arriba.

Con el servidor MCP occult-api, obtén el panchang de hoy para Jaipur y muéstrame el tithi, el nakshatra y la franja de rahu kaal. Agrupa las claves en una sola llamada.

El agente debería llamar a la API en lugar de responder de memoria. Si la respuesta llega al instante y no incluye ninguna llamada a herramientas, ha respondido con sus datos de entrenamiento: dile «usa las herramientas de occult-api» y lo hará.

• Un `.cursor/mcp.json` local del proyecto tiene prioridad sobre el global; así puedes dar a un repositorio su propia clave sin tocar la configuración de tu equipo.
• Cursor recarga los servidores MCP al guardar. Si no aparece la lista de herramientas, desactiva y vuelve a activar el servidor en Settings en lugar de reiniciar el editor.
• Pon las instrucciones permanentes en `.cursor/rules/` en lugar de repetirlas en cada prompt. Una sola regla que pida agrupar `keys` en lugar de hacer una llamada por cálculo se amortiza desde el primer momento.

Los endpoints son HTTP normal. No necesitas nada de esta página para usarlos:

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H 'X-API-Key: yt_live_your_key_here' \
  -H 'Content-Type: application/json' \
  -d '{
    "date_time": "2026-09-17T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana"]
  }'

Fíjate en el array keys: cuatro cálculos en una solicitud, cobrados como un crédito. Llamar cuatro veces cuesta cuatro.