# Wynncraft

> Wynncraft is a freemium MCP server for games and play. MCP server giving AI clients read access to Wynncraft player, guild, leaderboard and item. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI, self-hosted
- **Website:** https://pipeworx.io/packs/wynncraft
- **Repository:** https://github.com/pipeworx-io/mcp-wynncraft
- **MCP Registry name:** io.github.pipeworx-io/wynncraft
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play)
- **Listing updated:** 2026-11-18

## About

The README describes this as an unofficial integration that wraps the public Wynncraft API, so an AI client can look up player stats, guild details, online players and the item database without writing its own requests. Calls go through the Pipeworx gateway, which is where the endpoint, rate limits and billing live.

The server is available over streamable HTTP at the gateway URL or as a local stdio bridge run with npx. The stdio package lists only this pack's tools by default; setting PIPEWORX_META_TOOLS=1 also exposes the gateway-wide tools such as ask_pipeworx. An optional Pipeworx API key raises the daily call cap from 50 to 200 calls.

It suits Minecraft players and community tool builders who want to query Wynncraft data from an assistant or script, and it is not affiliated with the game's developers.

## Features

- **Player stats lookup:** Retrieves playtime, XP, guild, ranking, veteran status and per-class totals by UUID or username.
- **Guild details:** Fetches guild members, level, XP, territories and seasonal rating by name or prefix.
- **Leaderboard queries:** Returns ranked entries for a chosen leaderboard type, up to a set result limit.
- **Item database search:** Provides the full item database and a search by item name.
- **Online players and news:** Lists currently online players per server and the official news feed.

## Good for

- Check a player's stats, class totals or guild membership from an AI assistant
- Build a guild roster or territory overview for a community site
- Find top players on a specific leaderboard
- Search the item database while planning gear or crafting
- Track which servers have players online right now

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http wynncraft https://gateway.pipeworx.io/wynncraft/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/wynncraft/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "wynncraft": {
      "url": "https://gateway.pipeworx.io/wynncraft/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "wynncraft": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/wynncraft/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "wynncraft": {
      "serverUrl": "https://gateway.pipeworx.io/wynncraft/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "wynncraft": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/wynncraft/mcp"
    }
  }
}
```

## Tools

- `player`: Fetch a player's stats by UUID or username.
- `player_characters`: Character list for a player.
- `guild`: Fetch guild details by name or prefix.
- `guild_list`: List all guilds.
- `online_players`: Currently online players by server.
- `leaderboard`: Fetch a leaderboard by type with a result limit.
- `item_database`: Full item database.
- `item_search`: Search items by name.
- `news`: Official news feed.

## FAQ

### Do I need an API key to use it?

No. The README says calls are anonymous without a key and capped at 50 per day; a free Pipeworx account raises the cap to 200 per day.

### How do I connect it to an MCP client?

Use the streamable-http endpoint https://gateway.pipeworx.io/wynncraft/mcp, or run the stdio package @pipeworx/mcp-wynncraft with npx.

### Is this an official Wynncraft product?

No. The README states it is an independent, unofficial integration not affiliated with or endorsed by the upstream provider.

### Does the stdio package list only Wynncraft tools?

By default yes. Setting PIPEWORX_META_TOOLS=1 also lists ask_pipeworx and other shared gateway tools.

### Is Wynncraft free?

Wynncraft has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

### How do I add Wynncraft to Claude Code?

Run this command in your terminal: claude mcp add --transport http wynncraft https://gateway.pipeworx.io/wynncraft/mcp

### What are the best alternatives to Wynncraft?

The closest alternatives to Wynncraft are Guild Wars 2, Steam, Clash Royale, Roblox and Opendota.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Guild Wars 2](https://ai-powered.com/mcp/guild-wars-2): Guild Wars 2 is a freemium MCP server for games and play.
- [Steam](https://ai-powered.com/mcp/steam): Steam is a freemium MCP server for games and play.
- [Clash Royale](https://ai-powered.com/mcp/clash-royale): Clash Royale is a freemium MCP server for games and play.
- [Roblox](https://ai-powered.com/mcp/roblox): Roblox is a freemium MCP server for games and play.
- [Opendota](https://ai-powered.com/mcp/opendota): Opendota is a freemium MCP server for games and play.
- [Boardgamegeek](https://ai-powered.com/mcp/boardgamegeek): Boardgamegeek is a freemium MCP server for games and play.
- [Warframe](https://ai-powered.com/mcp/warframe): Warframe is a freemium MCP server for games and play.

---
Source: https://ai-powered.com/mcp/wynncraft
