🧩 Oh, my Dots! MCP Server

Model Context Protocol Server for Creating Crossword Puzzles

📋 Overview

This server implements the Model Context Protocol (MCP), enabling AI applications to create crossword puzzles via a standardized interface. The server exposes tools that can be called by MCP-compatible clients like Claude, 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 in uppercase
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

🚀 Quick Start

Testing with curl

Initialize the connection:

curl -X POST https://yourserver.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://yourserver.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Create a crossword puzzle:

curl -X POST https://yourserver.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": {
    "crossword": {
      "url": "https://yourserver.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"

📖 How It Works

  1. Your AI assistant receives your request for a crossword puzzle
  2. The AI generates appropriate words and hints based on your requirements
  3. The AI calls the create_crossword_puzzle tool with the words
  4. The server encodes the words and generates a URL to ohmydots.com
  5. You receive a working crossword puzzle link!
Note: The AI assistant generates the words - this server only handles the technical process of creating the crossword URL.

🔐 Protocol Details

📚 Resources