# tibiawiki-mcp

Query TibiaWiki data about creatures, items, NPCs, quests and more. Use it to check stats, loot sources, vendor prices and travel routes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: tibia-sh
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tibia-sh/tibiawiki-mcp
- Updated: 2026-09-28
- HTML: https://affpapa.org/en/nevibecode/mcp/tibiawiki-mcp

## What it does

tibiawiki-mcp gives an AI assistant tools for looking up structured TibiaWiki information. It can filter creatures and items by attributes, check where an item comes from, find NPCs that buy loot, and look up spells, quests, houses or travel routes. One tool also parses loot messages into item counts and values.

The local server reads a SQLite snapshot. Once the package and index have been downloaded, it can run offline; local setup requires Node 22.13 or later. The index represents a snapshot, and answers include its generation time. You can also install the data package separately and open the database read-only with SQLite.

Claude Code can connect to the hosted server or run a local instance with `npx`. The hosted option needs no key; the local one needs Node 22.13+. The data is licensed CC BY-SA, so credit TibiaWiki when distributing it.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.tibia.sh/wiki`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http tibiawiki-mcp https://mcp.tibia.sh/wiki
```

2. **Platform CLI**
```bash
claude mcp add tibiawiki-mcp -- npx -y @tibia.sh/tibiawiki-mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tibiawiki-mcp --url https://mcp.tibia.sh/wiki
```

2. **Platform CLI**
```bash
codex mcp add tibiawiki-mcp -- npx -y @tibia.sh/tibiawiki-mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tibiawiki-mcp": {
            "url": "https://mcp.tibia.sh/wiki"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tibiawiki-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@tibia.sh/tibiawiki-mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tibiawiki-mcp": {
            "type": "http",
            "url": "https://mcp.tibia.sh/wiki"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tibiawiki-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tibia.sh/tibiawiki-mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tibiawiki-mcp https://mcp.tibia.sh/wiki
```

2. **Platform CLI**
```bash
gemini mcp add tibiawiki-mcp npx -y @tibia.sh/tibiawiki-mcp
```

## When to use it
- filter creatures by combat stats or behaviour
- find where an item drops or which NPC sells it
- compare NPC buy prices for loot across cities
- parse a loot message and calculate item values
- look up spells, quests, houses or boat routes

## Example prompts
- Where can I get a Dragon Shield, and how likely is it to drop?
- Parse this loot message and calculate each item's value.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25137
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4534
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 982
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 732

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md