Guia do servidor MCP de quebra-cabeças

Conecte um cliente compatível com Streamable HTTP e cabeçalho Bearer configurável. A chave vai no cabeçalho, nunca nos argumentos da ferramenta.

Chaves API

Configuração do cliente

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

O cliente precisa aceitar Streamable HTTP remoto e cabeçalho Authorization personalizado. Clientes que aceitam apenas OAuth não usam este método.

Ferramentas de criação

Ferramentas de gestão e imagem

list_puzzles
get_puzzle
delete_puzzle
manage_puzzle_share
get_puzzle_capabilities
import_image_asset

Exemplos de chamadas

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

Imagem de entrada

Use import_image_asset com uma URL HTTPS acessível e passe o assetId retornado à ferramenta adequada. Para envio binário, use POST /api/v1/assets. Não envie imagens base64 nos argumentos.