Cursor con Occult API

El servidor MCP pone 299 endpoints de astrología a disposición de Composer como herramientas. En vez de describirle 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 gasta un crédito una llamada correcta a call_endpoint; las que fallan son gratis.

Créala en el panel. Tiene la forma yt_live_… y va ligada a tu saldo de créditos, así que trátala como una contraseña: nunca en el código 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 tocar el archivo a mano, tienes la misma opción en Settings → Cursor Settings → MCP → Add new global MCP server.

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

Pregúntale 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 sale vacía, el servidor no ha arrancado. Lo más habitual es que el archivo de configuración esté en su sitio pero con una estructura incorrecta, así que revisa primero el nombre de la clave que se indica arriba.

Con el servidor MCP de occult-api, obtén el panchanga de hoy para Jaipur y muéstrame el tithi, el nakshatra y la franja del rahu kaal. Pide todas las keys en una sola llamada.

El agente debería llamar a la API en vez de responder de memoria. Si la respuesta llega al instante y sin ninguna llamada a herramientas, ha tirado de sus datos de entrenamiento. Dile «usa las herramientas de occult-api» y lo hará.

• Un `.cursor/mcp.json` dentro del proyecto tiene prioridad sobre el global. Así puedes darle 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; no hace falta reiniciar el editor.
• Pon las instrucciones fijas en `.cursor/rules/` en lugar de repetirlas en cada prompt. Una sola regla que diga que agrupe las `keys` en vez de hacer una llamada por cálculo se amortiza enseguida.

Los endpoints son HTTP normal y corriente. Para usarlos no necesitas nada de esta página:

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 sola solicitud, por un solo crédito. Cuatro llamadas te costarían cuatro.