🧑‍🌾 HayDay MCP Server

Live HayDay game data — crops, products, animals, machines, and level unlocks — served as MCP tools for any AI agent.

Works with opencode, Claude Desktop, Cursor, VS Code, and any MCP-compatible client.

Not a bot. Not an auto-player. This is a read-only data lookup tool. It does not interact with the HayDay game, does not send inputs, does not automate gameplay, and cannot be used to play on your behalf. It only answers questions about game mechanics — like a wiki you can query from your AI.

Why?

HayDay is a deep game with hundreds of items, recipes, and levels. Keeping track of what to plant, what to craft, and what unlocks next is tedious. This MCP server gives your AI assistant the full game data so it can help you plan your farm — not play it for you.

Related MCP server: SovietRepublic-MCP

How It Works

AI agent → MCP protocol → HayDay Data MCP → hayday.info API (live) → structured data
                                    ↓
                           1-hour in-memory cache

Data is fetched live from hayday.info on every tool call, with a 1-hour cache to avoid rate limits. When Supercell updates the game, your AI sees the new data automatically — no manual updates needed.

Quick Start

git clone https://github.com/Mohib1992/hayday-mcp-server.git
cd hayday-mcp-server
npm install
node server.js

The server starts and listens for MCP connections via stdio. Nothing happens until an AI client connects.

Tools

Example Queries

"What's the most profitable crop at level 15?"

→ Call get_best_profit(minLevel: 1, limit: 5) and filter by machine: "Crops".

"Compare bread vs corn bread"

→ Call compare_profit(products: ["Bread", "Corn bread"]).

"What do I unlock at level 30?"

→ Call get_level_unlocks(level: 30).

Client Setup

opencode

Add to opencode.jsonc in your project root:

{
  "mcpServers": {
    "hayday-data": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "/path/to/hayday-data-mcp"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "hayday-data": {
      "command": "node",
      "args": ["server.js"],
      "cwd": "/path/to/hayday-data-mcp"
    }
  }
}

Cursor

Settings → Features → MCP → Add new server:

VS Code (Continue.dev)

Add to ~/.continue/config.json:

{
  "experimental": {
    "mcpServers": {
      "hayday-data": {
        "command": "node",
        "args": ["server.js"],
        "cwd": "/path/to/hayday-data-mcp"
      }
    }
  }
}

Data Source

All data comes from hayday.info — a community-run HayDay database. The /api/production-data endpoint returns 348 items across 48 categories. Data is cached in memory for 1 hour.

What's included:

• Field crops + trees & bushes

• Animal products (eggs, milk, bacon, wool, etc.)

• All machine-made products (Bakery, Dairy, BBQ Grill, etc.)

• Level unlock information

• Profit/hour calculations (provided by source)

• XP and XP/hour

What's not included:

• Ingredient/recipe details (which items combine to make a product)

• Building upgrade costs

• Derby / boat / town data

Architecture

hayday-mcp-server/
  server.js            # MCP server (JSON-RPC over stdio, zero framework deps)
  lib/
    hayday.js          # Fetches & indexes live data from hayday.info
    cache.js           # 1-hour TTL cache
  test/
    api.test.js        # API layer smoke tests
    mcp.test.js        # MCP protocol smoke tests
  package.json
  CHANGELOG.md
  LICENSE              # MIT

Troubleshooting

Testing

npm test

Runs 20+ smoke tests covering the API layer and MCP protocol using Node.js built-in node:test.

Contributing

1. Fork the repo

2. Create a feature branch

3. Run npm test to verify

4. Open a pull request

License

MIT

Legal notice

This project is an independent data tool and is not affiliated with, endorsed by, or connected to Supercell Oy. HayDay is a trademark of Supercell Oy. All game data is sourced from publicly available community resources. This tool is read-only and does not interact with the HayDay game client, its servers, or its APIs. It is designed for informational and educational purposes only.