Wordle MCP

Overview

Wordle MCP is a lightweight Model Context Protocol (MCP) server that exposes the daily New York Times Wordle puzzle solutions to AI agents and large language models. It fetches data directly from the official Wordle API, covering puzzles from the game's launch on May 19, 2021, up to 23 days into the future.

This tool allows AI assistants (such as Claude) to interact with real Wordle data—guessing words, receiving feedback, or even competing on leaderboards—without manual intervention.

Features

• Daily Wordle Solutions: Retrieve the exact solution for any supported date.
• Date Range Support: Access historical puzzles (from 2021-05-19) and upcoming ones (up to 23 days ahead).
• MCP Compatibility: Seamlessly integrates with MCP clients and AI agents following the Model Context Protocol.
• Multiple Implementations: Available in Python and Go for flexibility.
• Simple API: Clean tool interface designed for LLMs to query solutions programmatically.
• Reset Mechanism: Daily word reset at midnight UTC for fresh gameplay experiences.

Implementations

• Python Version: https://github.com/cr2007/mcp-wordle-python
• Go Version: https://github.com/cr2007/mcp-wordle-go
• Game-Focused Variant: Some implementations (e.g., corey-stidston/mcp-wordle) turn it into a full interactive Wordle game server for AI play.

Use Cases

• AI-Powered Wordle Gameplay: Let your LLM agent play Wordle autonomously, testing its reasoning and vocabulary.
• Educational Tools: Build tutors that explain Wordle strategies using real past puzzles.
• Leaderboards & Competitions: Compete with AI friends or track solving performance (see Toolbase integration at wordle.gettoolbase.ai).
• Pattern Analysis: Query historical solutions to study letter frequencies, optimal opening words, or solver algorithms.
• Multi-Agent Orchestration: Combine with browser automation (e.g., Playwright MCP) for voice-controlled or visual Wordle experiences.

How It Works

The server acts as a secure bridge between AI models and the NYT Wordle API. Agents call MCP tools to request a solution by date, receiving the five-letter answer along with any additional metadata. This keeps gameplay fair while giving LLMs real-time access to puzzle data.

Getting Started

1. Clone the repository (Python or Go version).
2. Install dependencies and run the MCP server locally.
3. Connect your MCP-compatible client or AI assistant (e.g., Claude via Toolbase or custom integration).
4. Query the Wordle solution for today's date or any valid historical date.

Note: Solutions are limited to the official NYT date range and reset daily.

Related Resources

• Play Wordle with MCP: https://wordle.gettoolbase.ai/
• Awesome MCP Servers directory listings for community examples.

Wordle MCP exemplifies how simple MCP servers can turn everyday games into interactive AI experiences.