Wordle MCP (Python)
Click on "Install 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.
Wordle MCP (Python)
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
Index
Get Started
Using Docker (recommended)
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: Weather Forecast MCP Server
Installing via uvx
The 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"
]
}
}
}Examples on Claude Desktop
Development
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.
Releasing
Releases are cut by pushing a vMAJOR.MINOR.PATCH tag:
Bump
versioninpyproject.tomlto match the new release.Commit that change.
Tag the commit, e.g.
git tag v1.2.3andgit 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.
Contributing
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.
Available Tools
1 toolget_wordle_solutionARead-only
Fetches the Wordle of a particular date provided between 2021-05-19 to 23 days future
| Name | Required | Description | Default |
|---|---|---|---|
| target_date | No | 2026-04-05 |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations declare readOnlyHint=true, establishing this is a safe read operation. The description adds the date range constraint (2021-05-19 to 23 days future), which is useful behavioral context not captured in annotations. It does not disclose rate limits, error cases, or return format.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Single sentence contains essential information (verb, resource, constraint) with minimal waste. Minor grammatical awkwardness ('to 23 days future' rather than 'into the future') slightly impacts clarity but not comprehension.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter read-only tool, the description covers the essential operation and input constraints. However, it omits the expected date format (ISO 8601 implied by default value but not stated) and provides no information about the return value structure (absent output_schema).
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema description coverage, the description compensates well by clarifying that the parameter represents a 'particular date' and specifying its valid range ('between 2021-05-19 to 23 days future'), giving clear semantics to the target_date parameter despite the schema providing only type and title.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('Fetches') and resource ('the Wordle'), and adds the critical scope constraint (specific date range). While it doesn't explicitly say 'solution' or 'answer', 'Fetches the Wordle' combined with the tool name makes the purpose clear.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides the valid date range constraint ('between 2021-05-19 to 23 days future'), which functions as an input guideline. However, it lacks explicit 'when to use' guidance, error handling notes, or alternatives (though no siblings exist).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
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.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Retrieve daily PVPC electricity tariffs for 2.0 TD consumers, published by Red Eléctrica.
Winning numbers for 30+ world lotteries, minutes after each draw. Free, no key, CC BY 4.0.
Macro data for AI agents: GDP, inflation, unemployment and more (World Bank, US BLS). No keys.
Current time, timezone conversion & date math for AI agents. On Cloudflare Workers.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceProvides weather forecast data for any location using the Open-Meteo API, returning temperature, precipitation, cloud cover, humidity, and wind speed for specified date ranges.1
- AlicenseAqualityDmaintenanceRetrieves MyFitnessPal nutrition data including daily summaries, meal breakdowns, exercises, and macros through FastMCP.61MIT
- AlicenseNot gradedqualityCmaintenanceWraps the Free Dictionary API to provide word definitions, pronunciations, and other dictionary data.13MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cr2007/mcp-wordle-python'
If you have feedback or need assistance with the MCP directory API, please join our Discord server