Documentación de NatalAI MCP

Conecte su agente de IA a cálculos astrológicos profesionales a través del Protocolo de contexto modelo (MCP).

1. Obtenga una clave API

1. Inicie sesión en NatalAI y abra Gabinete → Claves API de MCP.
2. Haga clic en "Generar clave API", asigne un nombre a su bot y copie la clave inmediatamente.
3. La clave completa se muestra solo una vez. Guárdelo de forma segura.

2. Punto final

Punto final MCP JSON-RPC (HTTP transmitible):

https://natalai.io/mcp/v1/

Manifiesto de herramienta (no se requiere clave): https://natalai.io/mcp/v1/schema/

3. Autenticación

Dos opciones: (1) API key a través de X-API-Key o Authorization: Bearer your-key; (2) OAuth 2.1 — el cliente descubre los metadatos en /.well-known/openid-configuration, inicias sesión en NatalAI y apruebas el acceso. Los tokens de acceso de OAuth también se envían como Authorization: Bearer.

4. Perplexity

Conector personalizado — OAuth (recomendado)

1. Abre Perplexity → Añadir conector personalizado.
2. URL del servidor: https://natalai.io/mcp/v1/
3. Autenticación: OAuth.
4. Transporte: Streaming HTTP.
5. Completa el inicio de sesión en NatalAI y haz clic en Permitir en la pantalla de consentimiento.

Conector personalizado — API key

1. Abre Perplexity → Añadir conector personalizado (o Connectors / MCP).
2. URL del servidor: https://natalai.io/mcp/v1/
3. Autenticación: API key — pega tu clave MCP de NatalAI (valor sin procesar, sin el prefijo “Bearer ”).
4. Transporte: Streaming HTTP (Streamable HTTP).
5. Acceso a la red: Público.
6. Acepta el aviso de riesgo y haz clic en Añadir.

NatalAI acepta la clave como Authorization: Bearer …, que es lo que envía Perplexity para los conectores de API key. Si el conector se creó después de habilitar OAuth y sigue solicitando OAuth, elimínalo y añádelo de nuevo con Autenticación: API key.

API de Agentes

Pasa la clave de NatalAI en el campo authorization de la herramienta MCP (token sin procesar). Perplexity lo enviará a nuestro servidor como Bearer.

curl https://api.perplexity.ai/v1/agent \
  -H "Authorization: Bearer $PERPLEXITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.6-sol",
    "input": "Build a natal chart for 1991-04-26 10:30 in Minsk using NatalAI.",
    "tools": [
      {
        "type": "mcp",
        "server_label": "natalai",
        "server_url": "https://natalai.io/mcp/v1/",
        "authorization": "YOUR_NATALAI_API_KEY"
      }
    ]
  }'

5. OpenAI (Responses API)

Usa una herramienta MCP remota en la OpenAI Responses API. Pon la clave de NatalAI en authorization (token sin procesar).

curl https://api.openai.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -d '{
    "model": "gpt-5.6",
    "input": "Build a natal chart for 1991-04-26 10:30 in Minsk using NatalAI.",
    "tools": [
      {
        "type": "mcp",
        "server_label": "natalai",
        "server_description": "Western and Vedic astrology calculations",
        "server_url": "https://natalai.io/mcp/v1/",
        "authorization": "YOUR_NATALAI_API_KEY",
        "require_approval": "never"
      }
    ]
  }'

Los conectores web de ChatGPT admiten OAuth contra nuestro servidor de autorización (/.well-known/openid-configuration). Perplexity Agent API no ejecuta el flujo de interfaz de usuario de OAuth — usa la interfaz del conector o pasa un token/clave en authorization.

6. Claude Desktop

{
  "mcpServers": {
    "natalai": {
      "url": "https://natalai.io/mcp/v1/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

7. Cursor / Windsurf

{
  "mcp": {
    "servers": [
      {
        "name": "NatalAI",
        "url": "https://natalai.io/mcp/v1/",
        "headers": { "X-API-Key": "YOUR_API_KEY" }
      }
    ]
  }
}

8. Ejemplo de curl

curl -X POST https://natalai.io/mcp/v1/ \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "natal_chart",
      "arguments": {
        "birth_date": "1991-04-26",
        "birth_time": "10:30",
        "latitude": 53.9,
        "longitude": 27.57,
        "timezone": "Europe/Minsk",
        "gender": "male"
      }
    }
  }'

9. Métodos JSON-RPC

10. Herramientas disponibles

• natal_chart
• ephemeris_day
• transits
• transit_strength
• progressions
• solar_return
• synastry
• vedic_natal
• aspect_patterns

11. Límites

Límites de tasa predeterminados por clave: 60 solicitudes/minuto, 1000 solicitudes/día. Las llaves se pueden desactivar en el armario en cualquier momento.

← Volver a la descripción general de MCP