> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nippy.la/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> SDK para gamificación en tu app. MCP para operar con IA.

Documentación para integrar productos con Nippy. Usa el SDK para ejecutar mecánicas de gamificación desde tu aplicación, o conecta un cliente MCP para consultar y operar herramientas internas con lenguaje natural.

## Secciones principales

<CardGroup cols={2}>
  <Card title="SDK de gamificación" icon="code" href="/sdk/introduction">
    Integra campañas, spins, claims, webhooks y manejo de errores desde tu backend o frontend.
  </Card>

  <Card title="MCP" icon="plug" href="/mcp/introduction">
    Conecta clientes compatibles con MCP para consultar analytics, ruletas, flows, learning y supply.
  </Card>
</CardGroup>

## Empieza rápido

<CardGroup cols={2}>
  <Card title="SDK" icon="code" href="/quickstart#sdk" horizontal>
    Instala el SDK, inicializa el cliente y ejecuta un spin.
  </Card>

  <Card title="MCP" icon="terminal" href="/quickstart#mcp" horizontal>
    Configura un cliente MCP con el endpoint de Nippy y tu API key.
  </Card>
</CardGroup>

## Referencia del SDK

<CardGroup cols={2}>
  <Card title="track()" icon="paper-plane" href="/sdk/track">
    Envía eventos de negocio y deja que Nippy evalúe reglas de campaña.
  </Card>

  <Card title="spin()" icon="rotate" href="/sdk/spin">
    Ejecuta un giro inmediato y recibe el resultado de forma síncrona.
  </Card>

  <Card title="getState()" icon="circle-info" href="/sdk/get-state">
    Consulta elegibilidad, cooldowns, spins restantes y claims pendientes.
  </Card>

  <Card title="claim()" icon="gift" href="/sdk/claim">
    Confirma premios físicos o digitales que requieren reclamación explícita.
  </Card>
</CardGroup>

## Operación y soporte

<CardGroup cols={2}>
  <Card title="Autenticación" icon="key" href="/sdk/authentication">
    Configura API keys y headers requeridos para llamadas del SDK y API pública.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/sdk/webhooks">
    Verifica firmas y procesa eventos emitidos por Nippy.
  </Card>

  <Card title="Errores del SDK" icon="triangle-exclamation" href="/sdk/errors">
    Revisa códigos de error, causas y patrones de manejo.
  </Card>

  <Card title="Errores MCP" icon="circle-exclamation" href="/errors">
    Diagnostica errores comunes al usar el servidor MCP.
  </Card>
</CardGroup>

<Note>
  Para credenciales y acceso a la consola, usa una API key con prefijo `npk_`. No la incluyas en repositorios ni clientes públicos.
</Note>