Sudokumax

Genera puzzles de Sudoku verificados, paquetes de hojas de trabajo imprimibles con hojas de respuestas y colecciones jugables a través de asistentes de IA.

Ver en sudokumax.comPrueba este MCPPatrocinado

Servidor MCP alojado

npx add-mcp 'https://sudokumax.com/api/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

En esta página

Configuración con tu asistente

Un prompt listo para usar te guía a través de la conexión, las pruebas y el uso de las herramientas.

Abrir el prompt de configuración en Cursor

Cursor abre un nuevo prompt para que lo revises. Tu agente puede ayudar a configurar el servidor; tú agregas tu clave API en la configuración de MCP.

Abrir configuración en Cursor ↗

Requiere la aplicación Cursor. Abrir el prompt no instala ni ejecuta nada automáticamente.

Crea tu clave API gratuita →

No se incluyen claves API ni detalles de cuenta en el prompt.

Leer el prompt de configuración

Help me set up and use the Sudokumax MCP server in my MCP-compatible client.

Documentation: https://sudokumax.com/developers/mcp
Server: https://sudokumax.com/api/mcp
Transport: Streamable HTTP (stateless JSON responses, no SSE subscription).
Authentication: Authorization: Bearer YOUR_API_KEY on every request.
Create a free account and API key at https://sudokumax.com/developers/keys.

1. Check which client I am using and whether it supports remote MCP with a custom Authorization header. Explain the configuration changes before applying them. Use the client's secure settings for my key; never ask me to paste it into this conversation or put it in a URL, source control, or public code.
2. For Cursor, configure a server named sudokumax in MCP settings with the URL and Authorization header above. For Claude, use a custom connector and its Request headers settings if available on my account. ChatGPT's direct authenticated MCP connection requires OAuth, which Sudokumax does not currently provide: do not claim that a Bearer API key can connect it. Offer a compatible client instead. Cloud clients cannot reach a localhost server.
3. Initialize the connection and list the available tools. Do not say setup is complete until a real tool request succeeds. If the hosted endpoint is unavailable, report that rather than inventing a result.
4. First test: call generate_puzzles with {"count":1,"difficulty":"beginner"}. Explain the puzzle grid, solution, analysis and attribution in the returned result.
5. Explain the available tools: generate_puzzles, check_uniqueness, analyze_difficulty, validate_progress, get_hint, publish_puzzles, export_worksheets and create_worksheet_pack. Their field definitions and examples are at https://sudokumax.com/developers.
6. Show how I can ask: "Make 20 beginner Sudoku worksheets, include answer sheets, and give me a playable link for each one." Use create_worksheet_pack with {"count":20,"difficulty":"beginner","includeAnswers":true,"paper":"a4"}. Return the actual PDF, collection and individual playable links from the tool response. PDF download links expire after 24 hours.

API calls are free with required attribution. Everything published online must visibly hyperlink to https://sudokumax.com. Offline outputs must print sudokumax.com. Keep the credit on every worksheet and answer sheet. Never fabricate tool results or output URLs.

Configuración manual

  1. Crea una clave API. Regístrate y genera una clave gratuita. Guárdala en la configuración privada de tu cliente.
  2. Agrega el servidor remoto. En Cursor, agrega la configuración siguiente a tus ajustes de MCP. En Claude, abre Personalizar → Conectores → Agregar conector personalizado, ingresa la URL del servidor y agrega Authorization en Encabezados de solicitud con el valor Bearer YOUR_API_KEY.
  3. Verifica la conexión. Habilita el servidor, actualiza la lista de herramientas y ejecuta la primera solicitud a continuación. Una configuración guardada por sí sola no confirma una conexión funcional.
{
  "mcpServers": {
    "sudokumax": {
      "url": "https://sudokumax.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Reemplaza YOUR_API_KEY en la configuración de tu cliente. Cada solicitud necesita el encabezado. El endpoint no tiene estado y devuelve JSON; no proporciona una suscripción SSE.

Compatibilidad de clientes

Cursor admite configuración remota de MCP. Claude admite encabezados de solicitud personalizados donde haya conectores personalizados disponibles. La integración directa con ChatGPT requiere soporte OAuth, que este servidor aún no implementa.

Documentación del cliente: Cursor · Claude · Autenticación de ChatGPT

Tu primera solicitud

Después de conectarte, pega esto en tu asistente:

Generate one beginner Sudoku puzzle using Sudokumax. Show me the puzzle, explain its difficulty analysis, and include the required website credit.

Tu asistente debe llamar a generate_puzzles con {"count":1,"difficulty":"beginner"}. Espera un rompecabezas de 81 celdas, su solución, un análisis de dificultad y la atribución.

Crear un paquete completo de hojas de trabajo

Make 20 beginner Sudoku worksheets on A4 paper, include answer sheets, and give me a playable link for each one. Use Sudokumax and keep its website credit on every published output.

Esto usa create_worksheet_pack y devuelve una descarga PDF, una página de colección y enlaces jugables individuales. Con respuestas incluidas, el PDF tiene 40 páginas. Los enlaces de descarga caducan después de 24 horas; los enlaces jugables públicos no usan esa caducidad.

Herramientas disponibles

Cada herramienta tiene los mismos campos de entrada y salida de operación que su contraparte REST.

[generate_puzzles

Genera rompecabezas y soluciones verificados.

Campos y ejemplos →](https://sudokumax.com/developers/api/generate) [check_uniqueness

Comprueba si una cuadrícula tiene exactamente una solución.

Campos y ejemplos →](https://sudokumax.com/developers/api/check) [analyze_difficulty

Inspecciona los recuentos de pistas y las técnicas de resolución compatibles.

Campos y ejemplos →](https://sudokumax.com/developers/api/analyze) [validate_progress

Comprueba las entradas del jugador y la finalización.

Campos y ejemplos →](https://sudokumax.com/developers/api/validate) [get_hint

Obtén una colocación de singles explicada.

Campos y ejemplos →](https://sudokumax.com/developers/api/hint) [publish_puzzles

Crea una colección y enlaces de rompecabezas jugables.

Campos y ejemplos →](https://sudokumax.com/developers/api/publish) [export_worksheets

Convierte tus cuadrículas en un PDF imprimible.

Campos y ejemplos →](https://sudokumax.com/developers/api/worksheets) [create_worksheet_pack

Genera rompecabezas, PDF, respuestas y enlaces juntos.

Campos y ejemplos →](https://sudokumax.com/developers/api/packs)

Respuestas y errores

El cliente inicializa la conexión antes de llamar a las herramientas. Aquí está la solicitud de protocolo para el ejemplo de hoja de trabajo:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "create_worksheet_pack",
    "arguments": {
      "count": 20,
      "difficulty": "beginner",
      "includeAnswers": true,
      "paper": "a4"
    }
  }
}

Una respuesta exitosa incluye el resultado de la operación en structuredContent y como JSON en content[0].text. Un paquete incluye pdfUrl, pdfExpiresAt, collectionUrl, puzzles[].playableUrl y la atribución.

Ejemplo de error de herramienta

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "isError": true,
    "content": [
      {
        "type": "text",
        "text": "NOT_UNIQUE: Puzzle verification returned multiple; a verified unique solution is required."
      }
    ]
  }
}

Los errores de operación establecen isError: true. Las claves faltantes o revocadas fallan en la capa HTTP con 401 o 403. La entrada MCP no válida puede producir un error de validación de protocolo. Para respuestas 429, espera el período de Retry-After antes de reintentar.

Límites y referencia de errores →

Adaptador stdio local

Para clientes que inician procesos MCP, compila el adaptador desde el repositorio del sitio web. Llama a la API REST autenticada, por lo que aún requiere acceso a la red y una clave activa.

npm ci
npm run build:engine

{
  "mcpServers": {
    "sudokumax": {
      "command": "node",
      "args": [
        "/absolute/path/to/website/packages/puzzle-engine/dist/stdio.js"
      ],
      "env": {
        "SUDOKUMAX_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Reemplaza la ruta ejecutable absoluta y configura la clave en tu cliente. Establece SUDOKUMAX_SITE_URL para probar contra un sitio web local. Los orígenes de API no locales deben usar HTTPS. La salida estándar está reservada para mensajes MCP. El paquete npm está preparado en el repositorio; la publicación está pendiente.

Recursos, prompts y atribución

El servidor expone el recurso sudokumax://developers y un prompt classroom-worksheets para un paquete de veinte rompecabezas para principiantes.

Las llamadas a la API son gratuitas con atribución. Las salidas en línea deben enlazar visiblemente a sudokumax.com; las salidas fuera de línea deben imprimir la dirección del sitio web. Mantén el crédito ya incluido en cada hoja de trabajo y hoja de respuestas generada.

Lee los términos de atribución →