# UnscrambleKey MCP server

<img src="icons/icon-128.png" alt="UnscrambleKey" width="96" align="right">

UnscrambleKey is a hosted, read-only [Model Context Protocol](https://modelcontextprotocol.io) server for English word tools. An AI assistant can use it to unscramble a rack of letters, find anagrams, solve a Wordle position, fit a crossword pattern, list words by length or letters and score a word in Scrabble or Words With Friends. In hosts that support MCP Apps (ChatGPT, Claude) it shows the words grouped by length, the Wordle board and a tap-a-word points card.

- Website: https://unscramblekey.com
- MCP endpoint: `https://unscramblekey.com/api/mcp` (Streamable HTTP, no sign-in)
- Documentation: https://unscramblekey.com/app
- Official MCP Registry name: `com.unscramblekey/unscramblekey`

This repository holds the public server description, icons and connection instructions. The server itself is hosted at unscramblekey.com, so there is nothing to install or run locally.

## Tools

All tools are read-only.

| Tool | What it does |
|---|---|
| `unscramble_letters` | Every word a rack of letters can make, grouped by length, common first, with scores and optional blanks and filters |
| `find_anagrams` | The words that use all the letters exactly once, plus the count of shorter words |
| `solve_wordle` | The words still possible after your guesses and the ten best next guesses |
| `solve_pattern` | Words that fit a crossword-style pattern such as _A_E_ |
| `word_list` | Dictionary words by length, start, end or contained letters, a page at a time |
| `score_word` | Whether a word is valid, common or rare, and its Scrabble and Words With Friends points |

- Scoring is `scrabble` (default) or `wwf`; blanks in a rack are `_` or `?`.
- Offensive words are hidden unless `include_offensive` is set. Results come a page at a time with a `cursor`.

## Connect

### ChatGPT and Claude

Add a custom connector with the URL `https://unscramblekey.com/api/mcp` and choose no authentication.

### Claude Desktop, Cursor and other MCP clients

```json
{
  "mcpServers": {
    "unscramblekey": {
      "url": "https://unscramblekey.com/api/mcp"
    }
  }
}
```

Clients that only launch local servers can connect through a bridge such as [`mcp-remote`](https://www.npmjs.com/package/mcp-remote):

```json
{
  "mcpServers": {
    "unscramblekey": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://unscramblekey.com/api/mcp"]
    }
  }
}
```

## Try asking

- "Unscramble the letters LISTEN."
- "I guessed CRANE in Wordle: C gray, R yellow, A gray, N gray, E green. What next?"
- "Which words fit _A_E_?"
- "Is QUIZ a word, and how many points is it in Scrabble?"

## On the website

- [Word unscrambler](https://unscramblekey.com/)

## Screenshots

| Unscramble | Wordle | Pattern |
|---|---|---|
| ![The words a rack of letters can make, grouped by length with scores](screenshots/unscramble-letters.png) | ![A Wordle position with the words still possible and the best next guesses](screenshots/solve-wordle.png) | ![Words that fit the pattern _A_E_](screenshots/solve-pattern.png) |

## Privacy and support

- Privacy: https://unscramblekey.com/privacy/
- Terms: https://unscramblekey.com/terms/
- Support: https://unscramblekey.com/contact/ or abishop1933@gmail.com

UnscrambleKey has no accounts. The letters and words sent from the chat reach the server so it can look them up; they are not stored by UnscrambleKey, and the hosting provider keeps standard request logs for a short time.

To report a problem, open an issue in this repository or write to abishop1933@gmail.com.

## License

The text and icons in this repository are released under the [MIT License](LICENSE). The UnscrambleKey website, its content and brand are not covered by it.