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

# Servidor MCP

> Conecta apinn a tu asistente de IA (Claude, Cursor…) mediante el servidor MCP.

apinn expone un **servidor MCP** (Model Context Protocol): tu asistente de IA puede **buscar en la documentación** y **llamar a la API** (listar los deportes, obtener las cuotas de un partido, el historial, los specials…) directamente en lenguaje natural.

<Info>
  URL del servidor MCP: **`https://docs.apinn.io/mcp`** (transporte HTTP streamable).
</Info>

## Conectar el servidor

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http apinn https://docs.apinn.io/mcp
    ```

    Luego en una sesión: «lista los partidos de fútbol en directo», «dame las cuotas del event 1632003656».
  </Tab>

  <Tab title="Cursor">
    Añade a `~/.cursor/mcp.json` (o *Settings → MCP → Add* ):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "url": "https://docs.apinn.io/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Desktop">
    En `claude_desktop_config.json` (Settings → Developer → Edit Config):

    ```json theme={null}
    {
      "mcpServers": {
        "apinn": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://docs.apinn.io/mcp"]
        }
      }
    }
    ```

    Reinicia Claude Desktop; el servidor `apinn` aparece en la lista de herramientas.
  </Tab>

  <Tab title="Otro cliente MCP">
    Cualquier cliente compatible con MCP (transporte **HTTP streamable**) puede conectarse a:

    ```
    https://docs.apinn.io/mcp
    ```
  </Tab>
</Tabs>

## Autenticación

* Las herramientas de **búsqueda en la documentación** funcionan sin clave.
* Las herramientas que **llaman a la API** utilizan tu **clave apinn** (`X-API-Key`). Proporciónasela al asistente / en la configuración del cliente MCP cuando la solicite. Cada llamada cuenta en tu [cuota horaria](/es/rate-limits).

<Warning>
  Nunca pegues tu clave en un repositorio público o en una pantalla compartida. Trátala como un secreto.
</Warning>

## Qué puede hacer el asistente

* «¿Cuáles son los deportes disponibles?» → `/api/sports`
* «Dame los partidos de fútbol en directo» → `/api/fixtures?sport_id=29&live=1`
* «Cuotas actuales del event 1632003656» → `/api/odds`
* «Historial completo de las cuotas de este partido» → `/api/odds?full_history=1`
* «Ganador de la Champions League: cuotas de los favoritos» → `/api/specials/outrights`

Todos los [endpoints de la referencia de la API](/es/api-reference/introduction) están expuestos como herramientas MCP (solo lectura).