Guía del servidor MCP de pasatiempos

Conecta un cliente compatible con Streamable HTTP y una cabecera Bearer configurable. La clave va en la cabecera, nunca en los argumentos de una herramienta.

Claves API

Configuración del cliente

{
  "url": "https://puzzlegenio.com/api/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

El cliente debe admitir Streamable HTTP remoto y una cabecera Authorization personalizada. Los clientes que solo admiten OAuth no pueden usar este método.

Herramientas de creación

Herramientas de gestión e imágenes

list_puzzles
get_puzzle
delete_puzzle
manage_puzzle_share
get_puzzle_capabilities
import_image_asset

Ejemplos de llamadas

create_jigsaw

{
  "name": "create_jigsaw",
  "arguments": {
    "requestKey": "example-jigsaw-0001",
    "title": "Mountain puzzle",
    "options": {
      "tilesX": 5,
      "tilesY": 5,
      "shape": "rectangle"
    }
  }
}

create_crossword

{
  "name": "create_crossword",
  "arguments": {
    "requestKey": "example-crossword-0001",
    "title": "Nature crossword",
    "input": {
      "entries": [
        {
          "word": "RIVER",
          "clue": "A flowing body of water"
        },
        {
          "word": "TREE",
          "clue": "A woody plant"
        }
      ]
    }
  }
}

create_word_search

{
  "name": "create_word_search",
  "arguments": {
    "requestKey": "example-wordsearch-0001",
    "preset": "word-search-for-kids",
    "title": "Animal word search",
    "input": {
      "words": [
        "CAT",
        "DOG",
        "LION",
        "TIGER"
      ]
    },
    "options": {
      "gridSize": 10,
      "allowDiagonal": false
    }
  }
}

create_sudoku

{
  "name": "create_sudoku",
  "arguments": {
    "requestKey": "example-sudoku-0001",
    "title": "Sudoku practice",
    "options": {
      "size": 9,
      "difficulty": "easy",
      "count": 1
    }
  }
}

create_bingo

{
  "name": "create_bingo",
  "arguments": {
    "requestKey": "example-bingo-0001",
    "title": "Party bingo",
    "input": {
      "words": [
        "APPLE",
        "BANANA",
        "CHERRY",
        "DATE",
        "FIG",
        "GRAPE",
        "KIWI",
        "LEMON",
        "MANGO"
      ]
    },
    "options": {
      "gridSize": 3,
      "cardCount": 1
    }
  }
}

create_maze

{
  "name": "create_maze",
  "arguments": {
    "requestKey": "example-maze-0001",
    "title": "Simple maze",
    "options": {
      "cols": 10,
      "rows": 10,
      "algorithm": "backtracker"
    }
  }
}

create_nonogram

{
  "name": "create_nonogram",
  "arguments": {
    "requestKey": "example-nonogram-0001",
    "mode": "grid",
    "title": "Small nonogram",
    "input": {
      "grid": [
        [
          false,
          false,
          true,
          false,
          false
        ],
        [
          false,
          true,
          true,
          true,
          false
        ],
        [
          true,
          true,
          true,
          true,
          true
        ],
        [
          false,
          true,
          true,
          true,
          false
        ],
        [
          false,
          false,
          true,
          false,
          false
        ]
      ]
    }
  }
}

create_cryptogram

{
  "name": "create_cryptogram",
  "arguments": {
    "requestKey": "example-cryptogram-0001",
    "title": "Quote cipher",
    "input": {
      "text": "PRACTICE MAKES PROGRESS"
    },
    "options": {
      "difficulty": "easy"
    }
  }
}

create_word_scramble

{
  "name": "create_word_scramble",
  "arguments": {
    "requestKey": "example-scramble-0001",
    "title": "Animal scramble",
    "input": {
      "words": [
        "TIGER",
        "HORSE",
        "RABBIT"
      ]
    }
  }
}

Imágenes de entrada

Usa import_image_asset con una URL HTTPS accesible y pasa el assetId obtenido a una herramienta de creación compatible. Para subir un archivo binario, usa POST /api/v1/assets. No envíes imágenes base64 como argumentos.