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

# Servidor MCP

> Usa LLMGenerator desde Claude, Cursor, Windsurf y cualquier agente compatible con MCP. Genera archivos llms.txt sin salir del chat.

El servidor MCP (Model Context Protocol) de LLMGenerator permite a los agentes de IA generar, revisar y validar archivos `llms.txt` por ti — sin abandonar la conversación.

**Endpoint**: `https://mcp.llmgenerator.com/mcp`

***

## Requisitos

Necesitas una clave API de LLMGenerator. Créala en [ajustes de claves API](https://app.llmgenerator.com/settings/api-keys).

Formato: `llmgen_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

***

## Configuración

<Tabs>
  <Tab title="Claude Desktop">
    Edita el archivo de configuración:

    * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
    * **Windows / Linux**: `~/.config/claude/claude_desktop_config.json`

    ```json theme={null}
    {
      "mcpServers": {
        "llmgenerator": {
          "url": "https://mcp.llmgenerator.com/mcp",
          "headers": {
            "Authorization": "Bearer llmgen_tu_clave_api"
          }
        }
      }
    }
    ```

    Reinicia Claude Desktop. Las herramientas de LLMGenerator aparecerán en el icono de herramientas del chat.
  </Tab>

  <Tab title="Claude Code CLI">
    ```bash theme={null}
    claude mcp add llmgenerator \
      --url https://mcp.llmgenerator.com/mcp \
      --header "Authorization: Bearer llmgen_tu_clave_api"
    ```
  </Tab>

  <Tab title="Cursor">
    Abre **Ajustes → MCP** y añade un servidor:

    * **Nombre**: `llmgenerator`
    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Cabeceras**: `Authorization: Bearer llmgen_tu_clave_api`
  </Tab>

  <Tab title="Windsurf">
    Abre **Ajustes → IA → Servidores MCP** y añade:

    * **URL**: `https://mcp.llmgenerator.com/mcp`
    * **Cabecera Authorization**: `Bearer llmgen_tu_clave_api`
  </Tab>
</Tabs>

***

## Herramientas disponibles

Tras conectar, tu agente tiene 9 herramientas:

| Herramienta             | Descripción                                      |
| ----------------------- | ------------------------------------------------ |
| `generate_llms_txt`     | Inicia la generación de `llms.txt` para una URL  |
| `get_generation_status` | Consulta el trabajo hasta que termine            |
| `list_sites`            | Lista sitios generados                           |
| `get_site`              | Detalles y URLs de archivo de un sitio           |
| `get_llms_txt_content`  | Obtiene el texto `llms.txt`                      |
| `discover_urls`         | Rastrea un sitio y descubre URLs                 |
| `get_discovered_urls`   | Lista URLs de un trabajo de descubrimiento       |
| `get_credit_balance`    | Saldo de créditos y transacciones recientes      |
| `validate_llms_txt`     | Valida contenido `llms.txt` y obtiene puntuación |

***

## Ejemplos de prompts

<AccordionGroup>
  <Accordion title="Generar llms.txt para un sitio">
    > «Genera un llms.txt para stripe.com»

    El agente llama `generate_llms_txt`, hace polling con `get_generation_status` y devuelve el resultado.
  </Accordion>

  <Accordion title="Listar y leer archivos">
    > «Muéstrame mis sitios generados y el contenido llms.txt del más reciente»

    El agente usa `list_sites` y luego `get_llms_txt_content`.
  </Accordion>

  <Accordion title="Validar llms.txt">
    > «Valida este llms.txt y dime cómo mejorarlo: \[pega el contenido]»

    El agente usa `validate_llms_txt` (puntuación 0–100 y sugerencias).
  </Accordion>

  <Accordion title="Descubrir URLs antes de generar">
    > «Descubre las URLs en docs.example.com antes de decidir cuáles incluir»

    El agente usa `discover_urls` y `get_discovered_urls`.
  </Accordion>

  <Accordion title="Consultar créditos">
    > «¿Cuántos créditos me quedan?»

    El agente llama `get_credit_balance`.
  </Accordion>
</AccordionGroup>

***

## Funcionamiento

El servidor MCP corre en Cloudflare Workers como proxy delante de la API REST de LLMGenerator. Tu clave se envía en cada petición; el servidor MCP no almacena datos.

```
Agente IA → mcp.llmgenerator.com → api.llmgenerator.com
               (protocolo MCP)           (REST API)
```

**Límite de tasa**: 60 peticiones por minuto y clave API. Si se supera, recibirás `429` con un mensaje claro.

***

## Consumo de créditos

| Herramienta                                              | Créditos              |
| -------------------------------------------------------- | --------------------- |
| `generate_llms_txt` (simple)                             | 1 por URL             |
| `generate_llms_txt` (mejorada)                           | 2 por URL             |
| `discover_urls` (primer escaneo)                         | Gratis                |
| `discover_urls` (re-escaneo)                             | 1 crédito por 10 URLs |
| Herramientas de lectura (`list_sites`, `get_site`, etc.) | Gratis                |
| `validate_llms_txt`                                      | Gratis                |

***

## Solución de problemas

<AccordionGroup>
  <Accordion title="No veo las herramientas en el cliente">
    1. Comprueba que la URL sea exactamente `https://mcp.llmgenerator.com/mcp` (incluye `/mcp`).
    2. Verifica que la clave empiece por `llmgen_`.
    3. Reinicia el cliente tras guardar la configuración.
    4. Prueba la conexión:

    ```bash theme={null}
    curl -s -X POST https://mcp.llmgenerator.com/mcp \
      -H "Accept: application/json, text/event-stream" \
      -H "Authorization: Bearer llmgen_TU_CLAVE" \
      -H "Content-Type: application/json" \
      -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
    ```
  </Accordion>

  <Accordion title="Error 401">
    Falta la clave o no es válida. Usa `Authorization: Bearer llmgen_...` (con el prefijo `Bearer `). Obtén una nueva clave en [ajustes API](https://app.llmgenerator.com/settings/api-keys).
  </Accordion>

  <Accordion title="429 límite de tasa">
    Has superado 60 peticiones/minuto con la misma clave. Espera 60 segundos. Para límites mayores, [escríbenos](mailto:llmgenerator@gmail.com).
  </Accordion>

  <Accordion title="El trabajo permanece en «processing»">
    Sitios grandes pueden tardar 1–3 minutos. El agente debe seguir consultando `get_generation_status`. Si supera 5 minutos, prueba una nueva generación.
  </Accordion>
</AccordionGroup>

***

## Detalles del protocolo

* **Transporte**: [Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Versión MCP**: `2024-11-05`
* **Autenticación**: cabecera `Authorization: Bearer llmgen_xxx`
* **Content-Type**: las peticiones deben incluir `Accept: application/json, text/event-stream`

<Info>
  OAuth 2.1 en navegador está en la hoja de ruta para conectar sin copiar manualmente la clave API.
</Info>