Model Context Protocol

Usa Occult API desde tu asistente de IA

Conecta Claude, Cursor o cualquier asistente compatible con MCP a datos de efemérides reales. Pide un panchang, una kundli o un dasha en lenguaje natural y recibirás un cálculo de verdad, no una invención que solo parece creíble.

tú:  ¿Cuál es el panchang de Jaipur mañana a la salida del sol?

     → tithi Chaturthi (Krishna paksha), yoga Vriddhi, karana Balava

Antes de empezar

Necesitas una clave de API. Crea una cuenta y genera una en la página de claves. Solo se muestra una vez, así que cópiala antes de salir. Aparte de eso, solo necesitas Node 18 o posterior; npx descarga todo lo demás la primera vez que se ejecuta.

Configúralo

Todos los clientes usan el mismo bloque. Añádelo al archivo de abajo. Si el archivo ya tiene una sección mcpServers, pon occult-api dentro de ella en lugar de añadir otra.

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

Claude Code (VS Code)~/.claude.jsonC:Users<you>.claude.json en Windows

Claude Desktopclaude_desktop_config.json%APPDATA%Claude en Windows, ~/Library/Application Support/Claude/ en macOS

Cursor~/.cursor/mcp.json

Después, cierra la app del todo y vuelve a abrirla. Los servidores MCP se conectan al arrancar, así que recargar la ventana no basta.

O desde la terminal

Si tienes instalada la línea de comandos de Claude Code, esto hace lo mismo en un solo paso. No funciona en la extensión de VS Code, que no incluye el comando claude: en ese caso usa el archivo de configuración de arriba.

claude mcp add occult-api -e OCCULT_API_KEY=yt_live_your_key_here -- npx -y occult-api-mcp

Qué puede hacer el asistente

Cinco herramientas que cubren los 299 endpoints y 330 cálculos. No hay una herramienta por endpoint, y es a propósito: cada herramienta ocupa espacio en el contexto del modelo en cada mensaje, y 299 herramientas llenarían la conversación antes de que preguntaras nada. En su lugar, el asistente busca.

check_accountGratis

Comprueba que la clave funciona e indica el saldo de créditos. Si algo falla, pide al asistente que la ejecute primero: así sabrás si el problema es la clave o el saldo.

search_endpointsGratis

Encuentra un cálculo por su nombre o por lo que hace. 'manglik' da resultado aunque ningún endpoint se llame así, porque busca en todos los cálculos con nombre propio, no solo en los nombres de los endpoints.

describe_endpointGratis

Los campos exactos de la solicitud, los valores que admite cada uno y un cuerpo de solicitud probado contra un servidor en producción.

call_endpoint1–25 créditos

Ejecuta cualquier endpoint al precio de ese endpoint: un crédito en la mayoría, 25 en los informes en PDF y el chat con IA. Las solicitudes fallidas no se cobran.

get_panchanga1 crédito

Un atajo para la solicitud más habitual, para que el asistente no tenga que buscarla antes.

Lo que cuesta

Exactamente lo mismo que una llamada HTTP directa: un crédito por cálculo correcto (25 para los informes en PDF y el chat con IA) y nada por una solicitud fallida. Buscar y leer la documentación es gratis, así que un asistente puede explorar toda la API sin gastar nada. Cada llamada te devuelve el saldo, y recibes un aviso cuando baja de 50 créditos.

Sobre tu clave

La clave no sale de tu equipo. Se lee de las variables de entorno, se envía a la API en una cabecera y nunca se le muestra al modelo: el asistente ve los resultados, nunca la credencial.

Aun así, es una credencial de servidor: quien la tenga puede gastar tus créditos. No la pongas en configuraciones compartidas ni en repositorios, y rótala desde la página de claves si crees que se ha filtrado.

Si algo falla

"Your Occult API key is invalid, revoked, or expired": Crea una clave nueva, actualiza el bloque env y reinicia la app. Los servidores MCP leen sus variables de entorno una sola vez, al arrancar.
"claude" no se reconoce como comando: Estás usando la extensión de VS Code, que no instala el comando claude. Usa el archivo de configuración de arriba: hace exactamente lo mismo.
El servidor no aparece: Comprueba que el JSON es válido y reinicia la app por completo. Los errores de arranque van al registro MCP del cliente, no al chat.
El asistente no encuentra un cálculo: Prueba con el nombre en sánscrito: "kundli" en lugar de "carta natal". Tienes todos los cálculos en la referencia.

Obtén una clave de API Ver en npm Código en GitHub