Spark
Sign In
MCP Connector

Retrieve Wordle Solutions via API

Fetch daily Wordle solutions via the Wordle API through an MCP server, installable via Docker or uvx.

Connect
Works with dockergithub
CSK
Own this? Claim it

Maintainer of this project? Claim this page to edit the listing.

86
Spark score
out of 100
Updated 11 days ago
Version 0.1.0
Models
universal
Add to Favorites

Why it matters

Access historical and future Wordle solutions programmatically. This asset connects to the Wordle API to retrieve daily solutions, enabling data analysis or integration into other applications.

Outcomes

What it gets done

01

Fetch Wordle solutions for specific dates

02

Access solutions from May 19, 2021, onwards

03

Retrieve solutions up to 23 days in the future

04

Deploy using Docker for easy integration

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-wordle-mcp | bash

Capabilities

Tools your agent gets

get_wordle_solution

Retrieve the Wordle solution for a specific date between 2021-05-19 and 23 days in the future.

Overview

Wordle MCP Server

An MCP server that fetches a specific day's Wordle solution via the Wordle API, installable through Docker or uvx, limited to dates from 2021-05-19 through 23 days in the future. Use to look up a specific day's Wordle solution conversationally in an MCP client. Cannot answer for dates outside the API's supported window.

What it does

This MCP server fetches Wordle solutions via the Wordle API. Solutions are only available for dates from 2021-05-19 up to 23 days in the future - any other date returns an error directly from the API rather than a fabricated answer.

When to use - and when NOT to

Use this when you want Claude Desktop (or another MCP client) to look up a specific day's Wordle solution conversationally. It cannot answer for dates outside the 2021-05-19-to-23-days-ahead window, since the underlying Wordle API itself doesn't serve those dates. A companion Go implementation of the same server exists in a separate repository for users who want a lighter, faster runtime instead of Python.

Capabilities

Looks up the Wordle solution for a given date within the API's supported range and returns it directly - a single-purpose lookup tool rather than a general word-game or puzzle-solving connector.

How to install

Two installation paths. Using Docker (recommended, requires Docker installed):

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

If Claude Desktop errors on first run, pull the image manually first with docker pull ghcr.io/cr2007/mcp-wordle-python:latest. Alternatively, install via uvx (requires uv installed) by pointing the MCP config at the GitHub repo with the mcp-wordle entry point, which is the quickest path to get started without managing a Docker image directly.

Releases are cut by bumping version in pyproject.toml, committing, and pushing a vMAJOR.MINOR.PATCH tag; the publish workflow rejects the release if the tag doesn't match pyproject.toml's version or if the test/uvx/Docker checks fail, and on success pushes the image to ghcr.io/cr2007/mcp-wordle-python tagged with the full version, major.minor, major, and latest. Every push and pull request is separately validated by a CI workflow. Contributions are welcome via fork and pull request; see CONTRIBUTING.md for the full dev-environment and testing setup.

Who it's for

Anyone who wants Claude to answer "what was/is the Wordle solution for [date]" directly from the Wordle API, without opening the Wordle website or a separate app.

Source README

Wordle MCP (Python)

CI
Open in GitHub Codespaces
Ask DeepWiki

A MCP Server for fetching the Wordle solutions via the Wordle 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"
      ]
    }
  }
}

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.

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.