🧩 Oh, my Dots! MCP Server

Model Context Protocol Server for Crossword, Word Search, Cryptogram and Cross-Math Puzzles

📋 Overview

This server implements the Model Context Protocol (MCP), enabling AI applications to create crossword, word search, cryptogram, and cross-math puzzles via a standardized interface. The server exposes tools that can be called by MCP-compatible clients like Claude, ChatGPT, VS Code, and other AI assistants.

MCP Endpoint: /mcp

🔧 Available Tools

create_crossword_puzzle

Creates a crossword puzzle URL from a list of words with hints.

Parameters

words required
Format: "word: hint" separated by newlines
Must contain 3-30 words. Keep hints brief - long hints take up too much space on the board
word_count optional
Number of words (3-30) - for reference/validation only
topic optional
Theme or topic of the crossword - for reference only

Returns

A URL to the generated crossword puzzle at ohmydots.com

create_word_search

Creates a word search puzzle URL from a plain list of words (no hints needed).

Parameters

words required
One word per line, separated by newlines
Must contain 3-30 words
word_count optional
Number of words (3-30) - for reference/validation only
topic optional
Theme or topic of the word search - for reference only
allow_special_characters optional
Allow accented/special characters in the grid

Returns

A URL to the generated word search puzzle at ohmydots.com

create_cryptogram

Creates a cryptogram puzzle URL that encodes a secret sentence as a substitution cipher.

Parameters

message required
The secret sentence to encode. Must contain at least 5 distinct letters
hint_words optional
Format: "word: hint" separated by newlines. Every letter in each word must already appear in the message. Keep hints brief - long hints take up too much space on the board

Returns

A URL to the generated cryptogram puzzle at ohmydots.com

create_cross_math

Creates a cross-math puzzle URL: a crossword-shaped grid of arithmetic expressions where some numbers are hidden for the player to fill in. All parameters are optional.

Parameters

difficulty optional
easy, medium, or hard - higher difficulty pre-fills fewer numbers. Defaults to medium
operators optional
Array of +, -, *, / to use in the expressions. Defaults to addition only
total_expressions optional
Number of expressions in the puzzle (4-30). Defaults to 10
min_number / max_number optional
Range allowed for operands/results. Default to 1 and 20; max_number must be greater than 4x min_number

Returns

A URL to the generated cross-math puzzle at ohmydots.com

🚀 Quick Start

Testing with curl

Initialize the connection:

curl -X POST https://mcp.ohmydots.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2024-11-05",
      "capabilities": {},
      "clientInfo": {
        "name": "test-client",
        "version": "1.0.0"
      }
    }
  }'

List available tools:

curl -X POST https://mcp.ohmydots.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Create a crossword puzzle:

curl -X POST https://mcp.ohmydots.com/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "create_crossword_puzzle",
      "arguments": {
        "words": "CAT: Furry pet that meows\nDOG: Man'\''s best friend\nBIRD: Has wings and feathers\nFISH: Swims in water\nFROG: Amphibian that hops"
      }
    }
  }'

🔌 Connect from MCP Clients

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "oh-my-dots": {
      "url": "https://mcp.ohmydots.com/mcp",
      "type": "http"
    }
  }
}

VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "oh-my-dots": {
      "url": "https://mcp.ohmydots.com/mcp",
      "type": "http"
    }
  }
}

Other MCP Clients

Any MCP-compatible client can connect using:

💡 Usage Examples

Example 1: Simple Crossword
Ask your AI assistant: "Create a crossword puzzle with 5 words about animals"
Example 2: Themed Crossword
Ask: "Make a 10-word crossword about technology"
Example 3: Custom Words
Ask: "Create a crossword with these words: APPLE, ORANGE, BANANA"
Example 4: Word Search
Ask: "Make a word search with 10 words about the ocean"
Example 5: Cryptogram
Ask: "Create a cryptogram with an inspirational quote about perseverance"
Example 6: Cross-Math
Ask: "Make a hard cross-math puzzle with addition and subtraction, numbers up to 100"

📖 How It Works

  1. Your AI assistant receives your request for a puzzle
  2. The AI generates appropriate words or a sentence (and hints, where applicable) based on your requirements, or picks cross-math settings that match what you asked for
  3. The AI calls the create_crossword_puzzle, create_word_search, create_cryptogram, or create_cross_math tool with the content
  4. The server encodes the content and generates a URL to ohmydots.com
  5. You receive a working puzzle link!
Note: The AI assistant generates the words, sentence, or puzzle settings - this server only handles the technical process of creating the puzzle URL.

🔐 Protocol Details

📚 Resources