Skip to main content
Glama
cr2007

Wordle MCP (Python)

by cr2007

Wordle MCP (Python)

CI Open in GitHub Codespaces Ask DeepWiki

NOTE

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.

IMPORTANT

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

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"
      ]
    }
  }
}
IMPORTANT


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:

  1. Bump version in pyproject.toml to match the new release.

  2. Commit that change.

  3. 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.

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 tool
get_wordle_solutionA
Read-only

Fetches the Wordle of a particular date provided between 2021-05-19 to 23 days future

ParametersJSON Schema
NameRequiredDescriptionDefault
target_dateNo2026-04-05

TDQS

A3.5/5.0
Behavior3/5

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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters4/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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

A3.5/5.0
Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count2/5

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.

Completeness2/5

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

ActivitySlowing
ResponsivenessSyncing

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

Related MCP Servers

Latest Blog Posts

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