퍼즐 MCP 서버 안내

Streamable HTTP와 원하는 Bearer 요청 헤더를 지원하는 클라이언트로 연결하세요. API 키는 요청 헤더에만 넣고 도구 인수에는 넣지 않습니다.

클라이언트 설정

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

원격 Streamable HTTP와 사용자 지정 Authorization 헤더를 지원해야 합니다. OAuth만 지원하는 클라이언트는 이 인증 방식을 사용할 수 없습니다.

만들기 도구

관리 및 이미지 도구

list_puzzles
get_puzzle
delete_puzzle
manage_puzzle_share
get_puzzle_capabilities
import_image_asset

도구 호출 예시

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

이미지 입력

접근 가능한 HTTPS 이미지 주소를 import_image_asset으로 가져온 뒤 반환된 assetId를 해당 만들기 도구에 전달합니다. 바이너리 업로드는 POST /api/v1/assets를 사용합니다. 이미지를 base64로 바꿔 도구 인수에 넣지 마세요.