Wordle

Fetch Wordle solutions via the Wordle API using Docker or uvx for MCP integrations.

python

2

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "cr2007-mcp-wordle-python": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "ghcr.io/cr2007/mcp-wordle-python:latest"
      ],
      "env": {
        "DOCKER_CONTAINER": "true"
      }
    }
  }
}

This MCP Server fetches Wordle solutions through the Wordle API, enabling you to retrieve daily Wordle answers from 2021-05-19 onward within a defined window. It supports running via Docker or via uvx for quick start, making it easy to integrate Wordle data into your MCP workflows.

How to use

You run this MCP Server with an MCP client by starting the configured MCP server instance. The server exposes a Wordle solutions endpoint that you can query through your MCP client to obtain the daily Wordle answer for dates within the supported range.

Choose one of the supported runtimes and start the server with the corresponding configuration. If you are unsure which path to pick, Docker is the recommended option for a quick and isolated setup.

How to install

Prerequisites you need before starting: Docker (for the Docker method) or uvx (for the uvx method). Ensure you have a working MCP client environment to manage MCP servers.

{
  "mcpServers": {
    "Wordle MCP (Python)": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--init",
        "-e",
        "DOCKER_CONTAINER=true",
        "ghcr.io/cr2007/mcp-wordle-python:latest"
      ],
      "env": [
        {
          "name": "DOCKER_CONTAINER",
          "value": "true"
        }
      ]
    }
  }
}

If you prefer the uvx path, install uvx first, then add the following MCP server configuration. This uses a git-based package path to fetch the Wordle MCP and run it locally.

{
  "mcpServers": {
    "Wordle MCP (Python)":{
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/cr2007/mcp-wordle-python",
        "mcp-wordle"
      ]
    }
  }
}

Additional install notes

If you encounter issues on first run with Docker, pre-pulling the image can resolve initial connection problems on some clients.

Configuration notes

The Docker-based configuration sets an environment flag to indicate a containerized run. You can adapt the env map to your environment if you need to override the default behavior.

Security and data considerations

Only Wordle solutions within the supported date window are accessible. Requests outside this window will return an API error. Treat the API as read-only for date-bounded data.

Available tools

wordle_get

Fetches the Wordle solution for a requested date within the supported window using the Wordle API