Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Wordle MCP (Python) what's today's Wordle solution?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
To check out the Go version of this MCP Server (lighter, faster),click here
A MCP Server for fetching the Wordle solutions via the Wordle API.
Wordle solutions are only available from 2021-05-19, to 23 days in the future. Any other attempts at calling other dates will return an error from the API
Ensure that you have Docker installed. Add this to your MCP Server configuration:
{
"mcpServers": {
"Wordle MCP (Python)": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"--init",
"-e",
"DOCKER_CONTAINER=true",
"ghcr.io/cr2007/mcp-wordle-python:latest"
]
}
}
}
If you get an error on Claude Desktop for the first time, just make sure to pull the image before running.
docker pull ghcr.io/cr2007/mcp-wordle-python:latest
Related MCP server: mcp-nba
uvxThe quickest and easiest method to get started. Make sure to install uv before adding this in your configuration.
Add this to your MCP server configuration:
{
"mcpServers": {
"Wordle MCP (Python)":{
"command": "uvx",
"args": [
"--from",
"git+https://github.com/cr2007/mcp-wordle-python",
"mcp-wordle"
]
}
}
}See CONTRIBUTING.md for setting up a dev environment and running the test suite. Every push and pull request is validated by the CI workflow.
Releases are cut by pushing a vMAJOR.MINOR.PATCH tag:
Bump version in pyproject.toml to match the new release.
Commit that change.
Tag the commit, e.g. git tag v1.2.3 and git push origin v1.2.3.
The publish workflow rejects the release if the tag doesn't match pyproject.toml's version, or if the test/uvx/Docker checks fail. On success, it pushes ghcr.io/cr2007/mcp-wordle-python tagged with the full version, major.minor, major, and latest.
Contributions are welcome! You may fork the repo, create your changes in a branch, and then create a Pull Request
See CONTRIBUTING.md for a full guide on setting up a dev environment, running tests, and commit/PR conventions.
Fetches the Wordle of a particular date provided between 2021-05-19 to 23 days future
Inputs: target_date.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as fetching Wordle solutions for specific dates, leaving no room for confusion or misselection.
A single tool inherently has perfect naming consistency, as there are no other tools to compare against. The tool name 'get_wordle_solution' follows a clear verb_noun pattern, which would be consistent if more tools were added.
One tool is too few for a server named 'Wordle MCP', which suggests a broader scope related to the Wordle game. While fetching solutions is a core function, the lack of tools for actions like checking guesses, getting hints, or accessing past statistics makes the set feel incomplete and under-scoped.
The tool surface is severely incomplete for a Wordle-related domain. It only provides solutions for dates, missing essential operations such as submitting guesses, validating words, retrieving game rules, or accessing user statistics, which are typical in Wordle applications and would be expected from such a server.
Fetches live Polymarket prediction market orderbooks, implied Yes/No probabilities, volume, and wh
Forecast future events and scan prediction-market edges.
Winning numbers for 30+ world lotteries, minutes after each draw. Free, no key, CC BY 4.0.
Sealed prediction-market verdicts, graded in public across Polymarket and Kalshi. No auth required.
