Guide du serveur MCP de jeux

Connectez un client compatible avec Streamable HTTP et un en-tête Bearer configurable. La clé figure dans l’en-tête, jamais dans les paramètres d’un outil.

Clés API

Configuration du client

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

Le client doit accepter Streamable HTTP à distance et un en-tête Authorization personnalisé. Un client limité à OAuth ne peut pas utiliser cette méthode.

Outils de création

Outils de gestion et d’image

list_puzzles
get_puzzle
delete_puzzle
manage_puzzle_share
get_puzzle_capabilities
import_image_asset

Exemples d’appels

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"
      ]
    }
  }
}

Image en entrée

Importez une image HTTPS accessible avec import_image_asset, puis passez son assetId à un outil compatible. Pour un envoi binaire, utilisez POST /api/v1/assets. Ne transmettez pas d’image base64 dans les paramètres.