Tibiawiki MCP

What tibiawiki-mcp does

tibiawiki-mcp exposes TibiaWiki content as MCP tools for AI assistants. It covers creatures, items, NPCs, quests, spells, houses, game updates and travel routes. The tools can answer structured questions such as which creatures are weak to an element, which items meet equipment requirements, which quests fit a character level, or where an item can be obtained and sold.

It also handles game-specific input. Search accepts approximate names and names as displayed in the game, helping an assistant find the exact wiki title required by detailed lookups. Loot messages can be parsed line by line, with item counts, NPC values in gold and unresolved entries returned separately. Item sourcing combines creature drops, NPC sales and quest rewards in one request.

How it works

The packaged server uses a SQLite index generated from TibiaWiki. Local installations download the package and its index on first start, then answer requests without network calls. Each response includes the time at which the index was generated, so consumers can identify the data snapshot behind an answer.

A hosted deployment is available at https://mcp.tibia.sh/wiki; it requires neither an account nor a key. Local use is available through the npm package and standard MCP configuration. Claude Code can install the project as a plugin, while other clients can launch it through npx.

Search and filter tools are intended for discovery. For richer information, an assistant can pass a returned title to tibia_get. For example, a creature lookup can include loot, abilities and maximum damage; an item lookup can include buyers; and a spell lookup can provide cooldown, effect and area details.

Setup and configuration

For a local MCP client, use Node.js 22.13 or later and configure the server with:

{
  "mcpServers": {
    "tibiawiki": {
      "command": "npx",
      "args": ["-y", "@tibia.sh/tibiawiki-mcp"]
    }
  }
}

The initial launch downloads the package and its approximately 18 MB index. Claude Code users can install the plugin with:

claude plugin marketplace add tibia-sh/tibiawiki-mcp
claude plugin install tibiawiki-mcp@tibiawiki-mcp

Remote users can add https://mcp.tibia.sh/wiki as an MCP server. In claude.ai, it can be added as a custom connector.

Tools and capabilities

• tibia_search finds pages by name substring, including game-printed item names and plurals.
• tibia_get returns detailed data for a named page, including creature, item, NPC, quest or spell information.
• tibia_find_creatures filters creatures by experience, damage modifiers and recorded behaviour.
• tibia_find_items filters equipment and other items by stats, resistances, vocation, weight, hands and related properties.
• tibia_find_spells, tibia_find_quests and tibia_find_houses search those categories by relevant requirements and attributes.
• tibia_how_to_obtain combines drops, NPC vendors and quest rewards for one item.
• tibia_find_updates searches update text and dates, while tibia_find_travel returns individual boat or carpet route legs and fares.
• tibia_where_to_sell identifies the best-paying active NPC for each item and groups results by city and NPC.
• tibia_parse_loot reads in-game loot messages and calculates item totals and NPC value.

Limitations and notes

The database is a snapshot rather than a live query against TibiaWiki. Data packages are rebuilt on Tuesdays and Fridays and released when the wiki changes, so answers may reflect the installed index rather than the latest in-game state.

Travel results describe separate route legs; they do not plan a complete journey. Creature damage modifiers use 100 percent as the neutral value: values above 100 mean increased damage taken, while lower values indicate resistance. The hosted service allows about 300 messages per minute per IP address and writes no request logs.

The server code is MIT licensed. TibiaWiki data remains CC BY-SA, so applications distributing that data should credit TibiaWiki. Tibia game content and images belong to CipSoft GmbH; images are not fetched or stored.