Lets an AI assistant query a local SQLite snapshot of TibiaWiki to answer complex questions about creatures, items, NPCs, quests, and spells.
Also known as tibia-sh/tibiawiki-mcp, @tibia.sh/tibiawiki-mcp
- Stars
- 0
- Tools
- 14
- Downloads, 30 days
- —
- Latest version
- 0.22.0
- Last commit
- Oct 31, 2026
- License
- —
What is TibiaWiki MCP?
TibiaWiki lets an AI assistant query a local SQLite snapshot of TibiaWiki to answer complex questions about creatures, items, NPCs, quests, and spells. It exposes 14 tools, such as tibia_search, tibia_get, tibia_find_creatures.
Summary generated from the project's README
About TibiaWiki MCP server
Querying specific game attributes like creature weaknesses or item drop rates from inside an AI assistant is what this server enables for Tibia players. It provides a way to ask complex questions that the standard wiki search cannot handle by using a local SQLite snapshot of TibiaWiki data. Because the data is stored locally, queries return in milliseconds and function entirely offline after the initial 18 MB index download.
Developers can use this as a remote server by adding a specific URL to clients like Claude.ai, which requires no accounts or API keys and supports 300 messages per minute per IP. For local setups, it can be installed via Claude Code or added to Claude Desktop and Cursor using npx. The server includes specialized tools such as tibia_find_creatures, tibia_find_items, and tibia_parse_loot to navigate game data. It also includes a skill that helps the agent understand data nuances, such as damage modifiers where 100 represents a neutral value.
What you can do with it
- 1Identify optimal hunting targetsAsk the assistant to find creatures that meet specific experience and elemental weakness criteria.
- 2Locate specific game itemsDetermine where to purchase an item and the exact cost from an NPC.
- 3Calculate loot profitabilityProvide a raw loot message to determine the total gold value of the items collected.
- 4Plan character progressionFind spells or quests that are appropriate for a specific character level.
Written from the project's README. Every use case is checked against a quote from it.
How to install TibiaWiki MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall TibiaWiki MCP in Claude Code
$ claude mcp add tibiawiki-mcp -- npx -y @tibia.sh/tibiawiki-mcpInstall TibiaWiki MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"tibiawiki-mcp": {
"command": "npx",
"args": [
"-y",
"@tibia.sh/tibiawiki-mcp"
]
}
}
}Install TibiaWiki MCP in VS Code
.vscode/mcp.json
{
"servers": {
"tibiawiki-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tibia.sh/tibiawiki-mcp"
]
}
}
}Install TibiaWiki MCP in VS Code CLI
$ code --add-mcp '{"name":"tibiawiki-mcp","type":"stdio","command":"npx","args":["-y","@tibia.sh/tibiawiki-mcp"]}'Install TibiaWiki MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"tibiawiki-mcp": {
"command": "npx",
"args": [
"-y",
"@tibia.sh/tibiawiki-mcp"
]
}
}
}Install TibiaWiki MCP in Codex
$ codex mcp add tibiawiki-mcp -- npx -y @tibia.sh/tibiawiki-mcpInstall TibiaWiki MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.tibiawiki-mcp] command = "npx" args = ["-y", "@tibia.sh/tibiawiki-mcp"]
Install TibiaWiki MCP in Gemini CLI
$ gemini mcp add -s user tibiawiki-mcp npx -- -y @tibia.sh/tibiawiki-mcpInstall TibiaWiki MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"tibiawiki-mcp": {
"command": "npx",
"args": [
"-y",
"@tibia.sh/tibiawiki-mcp"
]
}
}
}TibiaWiki MCP tools 14
Detected from the READMEtibia_searchtibia_gettibia_find_creaturestibia_find_itemstibia_find_spellstibia_find_queststibia_find_housestibia_how_to_obtaintibia_find_updatestibia_where_to_selltibia_parse_loottibia_find_travel
Show all 14 toolsShow fewer tools
tibia_find_offerstibia_find_npcs
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachabletibia-sh/tibiawiki-mcp is public and reachablegithub.com/tibia-sh/tibiawiki-mcp ↗Pass
- Package names this repository as its source@tibia.sh/tibiawiki-mcp names tibia-sh/tibiawiki-mcp as sourcenpmjs.com/package/@tibia.sh/tibiawiki-mcp ↗Pass
- Build provenance (Sigstore attestation)Sigstore attestation for @tibia.sh/tibiawiki-mcpnpmjs.com/package/@tibia.sh/tibiawiki-mcp/v/0.22.0#provenanc ↗Pass
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-31github.com/tibia-sh/tibiawiki-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @tibia.sh/tibiawiki-mcpPass
- No critical advisory in the package or its dependencies7 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 463 msPass
README
View on GitHubtibiawiki-mcp
An MCP server for TibiaWiki. It lets an AI assistant answer the questions the wiki itself cannot:
- Which creatures are weak to fire and give over 500 experience?
- What drops a Dragon Shield, and how likely is it?
- Where do I buy a Steel Helmet, and for how much?
Every answer comes from a SQLite snapshot of the wiki that installs with the server. Queries return in milliseconds and work offline. The server makes no network calls.
Use it
Hosted, nothing to install
Add https://mcp.tibia.sh/wiki to your MCP client as a remote server. It needs no account and no
key. In claude.ai, add it as a custom connector.
It allows about 300 messages a minute per IP address and writes no request logs. The landing page at
https://mcp.tibia.sh shows the versions it runs.
tibia-sh/mcp.tibia.sh has the details.
Claude Code
Install it as a plugin, from your terminal. You get the server and a skill that teaches the agent the traps in the data, like damage modifiers where 100 is neutral:
claude plugin marketplace add tibia-sh/tibiawiki-mcp
claude plugin install tibiawiki-mcp@tibiawiki-mcp
Any other MCP client
Add this to your client's MCP configuration, for example claude_desktop_config.json for Claude
Desktop or .cursor/mcp.json for Cursor. It needs Node 22.13 or later:
{
"mcpServers": {
"tibiawiki": { "command": "npx", "args": ["-y", "@tibia.sh/tibiawiki-mcp"] }
}
}
The first start downloads the package and its 18 MB index. After that it works offline.
Tools
You ask questions, and your assistant calls these:
| Tool | Answers |
|---|---|
tibia_search |
"Is there a page called roughly X?" or "List every mount." Items also match by the name or plural the game prints, like "vial of lifefluid" |
tibia_get |
"Tell me everything about X." X is a wiki title or its articleId, and can be a creature, item, NPC, quest or spell. An item says its client ID, the name and plural the game prints, whether it stacks, can be picked up or is immobile, and which NPCs buy it, for how much and where. A creature says its name as the game prints it, how it behaves, like when it flees, and its gold per kill. An NPC says what it buys and sells |
tibia_find_creatures |
"Which creatures match these stats?" Also by behaviour, like seeing invisible or being pushable, and ranked by gold per kill |
tibia_find_items |
"Which items match these stats?" Also by resistance, skill bonus, imbuement slots, weight, hands, client ID, weapon element, life or mana leech, and whether it stacks or can be picked up |
tibia_find_spells |
"Which healing spells can a level 30 druid cast?" |
tibia_find_quests |
"Which quests can a level 20 character do, and what do they give?" |
tibia_find_houses |
"What is the cheapest house in Thais with two beds?" |
tibia_how_to_obtain |
"Where do I get X?" Drops, vendors and quest rewards in one call. X can be the wiki title or the name the game prints |
tibia_find_updates |
"What changed for knights in 2026?" Game updates by text and release date |
tibia_where_to_sell |
"Where do I sell all this loot?" The NPC paying the most for each item, grouped by city. It takes the names the game prints too, like "gold coins", and lists a name several items share with those items |
tibia_parse_loot |
"What is this loot worth?" Paste loot messages as the game prints them and get each item's count and NPC value in gold, with client IDs per line on request |
tibia_find_travel |
"Which boat goes to Svargrond, and for how much?" Boat and carpet routes to or from a place, with fares. Each row is one leg with its start, not a planned journey |
tibia_find_offers |
"What does Rashid buy, and for how much?" NPC trade offers by NPC, item, direction and currency, every one of them a page at a time |
tibia_find_npcs |
"Who in Thais buys Dragon Shield?" NPCs by city, job and the items they buy or sell |
The server tells your assistant how to read the data, for example that a damage modifier of 100 is neutral. What the skill adds lists the traps.
How fresh the data is
The index is a snapshot. Every answer says when it was taken, as indexGeneratedAt. It ships as
its own package, @tibia.sh/tibiawiki-data, rebuilt
on Tuesdays and Fridays and released when the wiki changed. A fresh install gets the newest one.
The hosted server follows each release by itself.
Take the whole index
The tools answer questions. If you are building a loot filter, a hunt planner or a bot's data layer and want every row, install the index itself:
npm install @tibia.sh/tibiawiki-data
It exports DB_PATH, the absolute path to index.db, and SCHEMA_VERSION. Open the file
read-only with any SQLite client. In Node 22.13 or later, node:sqlite does it:
import { DatabaseSync } from 'node:sqlite'
import { DB_PATH } from '@tibia.sh/tibiawiki-data'
const db = new DatabaseSync(DB_PATH, { readOnly: true })
Its README says what the tables hold and how the versions work. The data stays CC BY-SA, so credit TibiaWiki when you ship it.
Why it exists
TibiaWiki runs on Fandom without Cargo, Semantic MediaWiki or CirrusSearch, so there is
no way to query it by attribute. Every structured value is trapped inside Infobox
wikitext, and the built-in search returns Dragon Necklace for fire resistant dragon.
The public REST API over the same wiki exposes exactly one query parameter. Building a
local index is the only way to ask a real question.
More
- docs/USAGE.md => the plugin in detail, serving over HTTP yourself, building your own index
- docs/MAINTAINING.md => working on the server and releasing it
Attribution
Data from TibiaWiki (https://tibia.fandom.com), licensed CC BY-SA. Tibia is made by CipSoft; game content and images are copyright CipSoft GmbH.
The index is generated by our copy of tibiawiki-sql (Apache-2.0). Images are deliberately never fetched or stored.
This project's own code is MIT licensed, see LICENSE. That covers the code only. The
data it serves is CC BY-SA and not ours to relicense.
TibiaWiki MCP questions
How do I add TibiaWiki MCP to Claude Code?
Run claude mcp add tibiawiki-mcp -- npx -y @tibia.sh/tibiawiki-mcp in your terminal. Add --scope user to make it available in every project.
How do I add TibiaWiki MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does TibiaWiki MCP provide?
It exposes 14 tools, including tibia_search, tibia_get, tibia_find_creatures, tibia_find_items, tibia_find_spells.
Does this server require an internet connection to work?
No, once the initial 18 MB index is downloaded, the server works offline.
How often is the TibiaWiki data updated?
The data index is rebuilt on Tuesdays and Fridays and released whenever the wiki changes.
Can I use this server without installing anything locally?
Yes, you can add the hosted URL to your MCP client as a remote server.
What kind of queries can I perform?
You can perform attribute-based queries such as finding creatures weak to specific elements or finding items by resistance and weight.