WordComb MCP Server

Exposes the WordComb combination engine as a remote MCP server over SSE — any AI agent can connect to it over the internet.

Endpoints

Related MCP server: mcp-arabic-toolkit

Tools

Deploy to Railway

1. Push mcp-server/ as its own repo (or subfolder)

cd mcp-server
git init
git remote add origin https://github.com/Yossof0/wordcomb-mcp.git
git add .
git commit -m "Initial MCP server"
git push -u origin main

2. Create a new Railway project

• Go to railway.app

• New Project → Deploy from GitHub repo → select your repo

• Railway auto-detects railway.json and runs npm run build && npm start

• Set the PORT env variable if needed (Railway injects it automatically)

3. Get your public URL

Railway gives you a URL like https://wordcomb-mcp-production.up.railway.app

Connect to Claude Desktop

Edit claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "wordcomb": {
      "type": "sse",
      "url": "https://your-app.up.railway.app/sse"
    }
  }
}

Restart Claude Desktop — WordComb tools appear automatically.

Local dev

npm install
npm run dev
# Server on http://localhost:3000

Example prompts once connected

"Generate all 3-letter combinations of A, B, C, D, E"

"How many combinations can you make from S, T, A, R using all 4 letters?"

"Generate combinations of 1, 2, 3 then check which are real English words"

"من كلمات ع، ل، م — ما التوليفات الممكنة من 3 حروف؟"