What is Wordle Mcp

wordle-mcp is a Model Context Protocol (MCP) server that enables AI assistants, such as Claude, to play the popular word game Wordle. It allows users to compete against their AI companions in a fun and engaging way.

Use cases

Use cases for wordle-mcp include casual gaming with friends or AI, educational tools for vocabulary building, and competitive scenarios where users can challenge their AI companions to see who can guess the word faster.

How to use

To use wordle-mcp, you can connect through various methods: using the Toolbase desktop app, a local MCP client, or directly via SSE. Simply follow the instructions provided in the README to get started.

Key features

Key features of wordle-mcp include multiple connection methods (Direct SSE, Local MCP client, Toolbase integration), daily word updates, a hint system integrated with Stripe for payments, and a persistent game state that allows users to continue from where they left off.

Where to use

wordle-mcp can be used in gaming, education, and AI interaction domains, providing a fun way to engage with language and vocabulary while leveraging AI capabilities.

Wordle MCP

Play Wordle with your LLM companion and see who is the best in the world.

A Model Context Protocol (MCP) server that allows AI assistants like Claude to play Wordle.

Every day at midnight UTC, the word is reset for you to keep climbing the leaderboard.

If you need a hint, feel free to pay me a Blue Bottle coffee.

Built with:

• Stripe for hint payments
• Clerk for auth
• Cloudflare Workers, Workers AI, Agents, DO, KV, D1 for basically all the heavy lifting

🎮 Features

• Multiple connection methods:
  • Direct SSE connection
  • Local MCP client connection
  • Toolbase desktop app integration
• Daily word updates
• Hint system with Stripe integration
• Persistent game state

🚀 Quick Start

Using Toolbase Desktop

1. Download and install Toolbase
2. Open Toolbase and connect to Wordle
3. Start playing Wordle with Claude!

Using Local MCP Client

npx mcp-remote https://wordle.gettoolbase.ai/mcp

Using SSE Directly

https://wordle.gettoolbase.ai/sse

🛠️ Development

Prerequisites

• Node.js 18+
• pnpm
• Cloudflare account
• Stripe account (for hint system)
• Clerk account (for authentication)

Setup

1. Clone the repository:

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

2. Install dependencies:

pnpm install

3. Set up environment variables in .dev.vars:

CLERK_INSTANCE_URL="your-clerk-url"
CLERK_SECRET_KEY="your-clerk-key"
CLERK_BACKEND_URL="clerk-backend-url"
HINT_SUCCESS_URL="your-success-url"
STRIPE_SECRET_KEY="your-stripe-key"
HINT_PRICE_ID="your-price-id"

4. Start the development server:

pnpm dev

Building

pnpm build

Deployment

The project is configured to deploy to Cloudflare Workers. Deploy using:

pnpm run deploy

📝 License

MIT License - see LICENSE for details.

🙏 Acknowledgements

• Cloudflare Workers
• Clerk
• Stripe