Wordle MCP Server: Retrieve Solution by Date

Overview

This MCP (Model Context Protocol) server provides a lightweight HTTP interface to look up Wordle solutions by date. It hosts a small model-like service that maps calendar dates to the Wordle answer for that day, letting developers query a specific day and receive the five-letter solution instantly.

The server is useful for testing, tooling and integrations where you need a deterministic Wordle answer lookup (for example, building educational demos, recreation bots, or automated verification tools). It exposes a simple HTTP API that you can run locally or deploy to a container, and it returns structured JSON responses suitable for programmatic consumption.

Features

• Query Wordle solution by date (YYYY-MM-DD).
• Lightweight Python implementation — easy to run locally.
• Simple HTTP endpoints with JSON responses for easy integration.
• Designed to work with MCP-style clients and generic HTTP clients (curl, requests).
• Includes sample data file containing Wordle answers (can be replaced with your own data).

Installation / Configuration

Clone the repository, create a virtual environment and install dependencies:

git clone https://github.com/cr2007/mcp-wordle-python.git
cd mcp-wordle-python

python -m venv .venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt

Configure the server (environment variables are commonly supported; replace names according to the repo if different):

# Point to the JSON or CSV file that contains the Wordle answers.
export WORDLE_ANSWERS_FILE=./data/wordle-answers.json

# Optional: change host/port before starting the server
export HOST=0.0.0.0
export PORT=8080

Start the server (typical FastAPI/uvicorn command):

uvicorn app:app --host ${HOST:-127.0.0.1} --port ${PORT:-8080} --reload

After startup the server usually listens on http://localhost:8080.

Note: check the repository README or app entrypoint (app.py, main.py) for exact environment variable names and startup command if they differ.

Available Resources

The server exposes a simple HTTP interface. Typical endpoints are listed below — confirm exact paths in the repository if they differ.

Example response (JSON):

{
  "date": "2022-01-01",
  "solution": "TREAT",
  "source": "wordle-answers.json"
}

Common behaviors:

• Date format: ISO 8601 (YYYY-MM-DD).
• If the date is not present, the server usually returns a 404 or a JSON error with an explanatory message.
• The POST /mcp endpoint accepts a JSON payload and returns result in MCP-style wrapper (check repo for exact schema).

Example Requests

Using curl (GET):

curl "http://localhost:8080/wordle?date=2022-01-01"

Using curl (POST to MCP endpoint):

curl -X POST "http://localhost:8080/mcp" \
  -H "Content-Type: application/json" \
  -d '{"model": "wordle", "input": {"date": "2022-01-01"}}'

Using Python requests:

import requests

resp = requests.get("http://localhost:8080/wordle", params={"date": "2022-01-01"})
resp.raise_for_status()
data = resp.json()
print(data["solution"])  # -> TREAT

Use Cases

• Automated testing: verify a Wordle-solving algorithm against the canonical answer for a specific historical date.
• Chatbot integrations: embed a small helper that can answer “What was the Wordle on 2022-03-15?” without scraping or web lookup.
• Educational demos: show students how a deterministic model responds to date-based inputs.
• Analytics and verification: reproduce user sessions or issues by replaying the daily answer used at a specific date/time.

Example scenario — CI test that verifies solver accuracy on a known date:

1. Start the MCP Wordle server in a job step.
2. Query the server for the target date.
3. Run your solver against the returned word and assert expected behavior.

Troubleshooting & Tips

• Ensure the data file contains entries for the date you request; otherwise the server will return an error.
• If you want production reliability, run the server behind a process manager or container (systemd, Docker).
• To extend the dataset, edit or replace the answers file and restart the server.
• Check the repository for exact endpoint names, environment variables and request schemas — they may vary slightly depending on the implementation.

Links

• GitHub: https://github.com/cr2007/mcp-wordle-python

This documentation provides the essentials to install, configure and use the MCP Wordle server to retrieve solutions by date. For implementation-specific details consult the repository source files and README.