tibiawiki-mcp
Read-only, offline MCP server for querying a bundled TibiaWiki SQLite snapshot.
Search wiki pages and fetch full details for creatures, items, NPCs, quests, spells, achievements, houses, imbuements, charms, mounts, outfits, books, worlds, and updates.
Filter creatures by stats, weaknesses/resistances, behavior, bestiary, experience, and gold per kill.
Filter items by class/type, combat stats, resistances, skill bonuses, imbuement slots, weight, hands, client ID, stackability, and pickupability.
Find spells by vocation/level/group/element, quests by level/location/rewards, and houses by city/rent/beds/size.
Trace how to obtain an item via drops, NPC vendors, and quest rewards.
Search game updates by text/date and retrieve matching change details.
Find the best NPC buyers for loot and parse in-game loot messages into counts and gold values.
Look up boat/carpet travel routes and fares.
Supports pagination, inactive-content inclusion, and returns index-freshness timestamps.
Provides tools to search and retrieve TibiaWiki content (hosted on Fandom), including creature stats and elemental weaknesses, item attributes, drops, vendor prices, and quest rewards.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tibiawiki-mcp which creatures are weak to fire and give over 500 experience?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
tibiawiki-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-mcpAny 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.
Related MCP server: tibiawiki_en_mcp
Tools
You ask questions, and your assistant calls these:
Tool | Answers |
| "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" |
| "Tell me everything about X." X is a wiki title or its |
| "Which creatures match these stats?" Also by behaviour, like seeing invisible or being pushable, and ranked by gold per kill |
| "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 |
| "Which healing spells can a level 30 druid cast?" |
| "Which quests can a level 20 character do, and what do they give?" |
| "What is the cheapest house in Thais with two beds?" |
| "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 |
| "What changed for knights in 2026?" Game updates by text and release date |
| "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 |
| "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 |
| "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 |
| "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 |
| "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-dataIt 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.
Available Tools
14 toolstibia_find_creaturesARead-onlyInspect
Find Tibia creatures matching stat filters. Damage modifiers are percentages where 100 is neutral: "weak_to" means the creature takes MORE than 100% damage from that element, "resistant_to" means less. Use this for questions like "which creatures are weak to fire and give over 500 experience". Behaviour filters skip creatures whose value is unrecorded.
Inputs: sort, limit, cursor, is_boss, +16 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_housesARead-onlyInspect
Find Tibia houses and guildhalls by city, rent, beds and size. Use this for questions like "cheapest house in Thais with two beds". Call tibia_get with a title for its location and position.
Inputs: city, sort, limit, cursor, +5 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_itemsARead-onlyInspect
Find Tibia items matching class, type and stat filters such as attack, defense, armor and required level, resistances, skill bonuses, imbuement slots, weight and hands. Use this for questions like "which two-handed swords need level 100 or less" or "which sorcerer items resist fire". Vocation and weapon type match by membership, so "knight" matches "knights". Call tibia_get on a title for the full item.
Inputs: sort, hands, leech, limit, +19 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_npcsARead-onlyInspect
Find NPCs by city, job and the items they buy or sell, e.g. "who in Thais buys Dragon Shield". tibia_get has the rest.
Inputs: job, buys, city, sort, +4 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_offersARead-onlyInspect
Find NPC trade offers with prices by NPC, item, direction and currency, e.g. "everything Rashid buys" or "what costs Gold Tokens".
Inputs: npc, item, limit, cursor, +3 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_questsARead-onlyInspect
Find Tibia quests by level, premium, Rookgaard and location, with their rewards. Use this for questions like "which quests can a level 20 character do". Call tibia_get with a title for the legend and dangers.
Inputs: sort, limit, cursor, level_max, +4 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_spellsBRead-onlyInspect
Find Tibia spells by vocation, level, group, element, type and words. Use this for questions like "which healing spells can a level 30 druid cast". Call tibia_get with a title for cooldowns, effect and area.
Inputs: sort, group, limit, words, +8 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_travelARead-onlyInspect
Find boat, carpet and other travel routes to or from a place, with fares. Each row is one leg with its start (origin) and the NPC's recorded city, location and position. Rows are single legs: this does not plan journeys.
Inputs: to, from, sort, limit, +2 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_find_updatesARead-onlyInspect
Find Tibia game updates by text and release date, for questions like "what changed for knights in 2026" or "which update added X". Matches the text, case-insensitive for ASCII letters, in an update's title, name, summary and change list, newest first, and returns the matching change lines. For the full changes, call tibia_get with type "update" and the returned title.
Inputs: text, limit, cursor, released_after, +1 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_getARead-onlyInspect
Full detail for one Tibia page of any kind, with a creature's loot, abilities and max damage, the NPCs that buy an item and what an NPC buys and sells. Takes exactly one of an exact page name or an article_id. Use tibia_search first for an uncertain or in-game name, or tibia_find_updates for an update. Pass type for a shared name. Creature abilities may carry an area: Grid of map tiles, row-major, as the caster faces. '.' unaffected tile, '#' effect tile, '@' the caster, '*' the target tile, digits 4-8 a second effect the scene draws on extra sprite layers, '?' an unrecognised value. effectTiles counts effect tiles only. effectOnCaster, from the wiki rather than the grid, says whether the caster is caught in its own effect.
Inputs: name, type, verbosity, article_id, +1 more. Returns: object
tibia_how_to_obtainARead-onlyInspect
Every in-game source for one item: which creatures drop it and how likely, which NPCs sell it and for how much (the price the player pays), and which quests reward it. Droppers come up to 100 at a time, with a cursor for the rest. Vendors and quest rewards always come whole. Prefer this over three separate lookups.
Inputs: item_name (required), limit, cursor, include_inactive. Returns: item, note, source, status, +8 more
tibia_parse_lootARead-onlyInspect
Parses loot messages as the game prints them, one per line, such as "12:34 Loot of a dragon: 2 small diamonds, a steel shield (active prey bonus)." It reads in-game names, not wiki titles. Gives totals by item with count and value, and entries it cannot resolve. Prices are NPC prices in gold, coins at face value. Other lines come back unparsed. Both lists stop at 100, their counts in totals do not.
Inputs: text (required), include_lines. Returns: lines, totals, unparsed, indexGeneratedAt, +1 more
tibia_searchARead-onlyInspect
Find Tibia pages of any kind whose name contains a substring. Items also match by the name and plural the game prints. Turns an approximate or in-game name into the exact page name tibia_get expects. With a query, shortest name first, so the closest match leads. With types and no query, lists every page of those types by title, as in "list every mount".
Inputs: limit, query, types, cursor, +1 more. Returns: results, nextCursor, totalMatches, indexGeneratedAt
tibia_where_to_sellARead-onlyInspect
Answers "where do I sell all this": for each item, the active NPC paying the most, grouped by city and NPC. Prices are NPC prices in gold. Call tibia_get on an NPC for more.
Inputs: items (required). Returns: cities, noGoldBuyer, unknownItems, ambiguousItems, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have clearly distinct targets: creatures, items, spells, quests, houses, updates, travel, offers, and NPCs are separated by entity. The main overlap is around NPC trade/item-source queries among tibia_find_offers, tibia_find_npcs, tibia_how_to_obtain, and tibia_where_to_sell, though their descriptions distinguish the intended use cases.
All names use a tibia_ prefix and snake_case, with most following a tibia_find_<entity> pattern. A few tools use different verb styles (tibia_get, tibia_search, tibia_parse_loot, tibia_how_to_obtain, tibia_where_to_sell), but the set remains predictable and readable.
At 14 tools, the set is well scoped for a rich Tibia wiki domain. Each tool covers a meaningful query class, and the count stays within a practical range for an agent to navigate.
The surface covers generic page lookup and search plus filtered discovery for creatures, items, spells, quests, houses, updates, travel, NPC offers, item sources, selling locations, and loot parsing. As a read-only wiki server, there are no obvious CRUD lifecycle gaps, and tibia_get/tibia_search provide a fallback for page kinds without dedicated finders.
Maintenance
Related MCP Connectors
Search a curated directory of agent tools, MCP servers, APIs, protocols and skills. No auth.
Query Klaaro datasets, documents, and extracted records from any agent.
Store, query, and update structured data from any AI agent
SEC filings, Wikipedia, arXiv, US Census and more for AI agents, with every answer source-linked.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to query TibiaWiki data including creatures, items, NPCs, quests, and more via 19 MCP tools.10-
- FlicenseNot gradedqualityCmaintenanceA server that downloads, parses, and indexes TibiaWiki content, providing 19 MCP tools for AI agents to query structured data such as creatures, items, and quests.-
- FlicenseNot gradedqualityCmaintenanceEnables agents to search a local, fully offline personal document library (Markdown/txt/PDF/docx) via SQLite FTS5 trigram search with subject-terminology expansion, returning every hit with its domain, document title, section path, and page or offset provenance. It also exposes domain statistics, incremental ingestion, and document deprecation as tools, alongside a read-only, runtime-persona-scoped ask/coverage mode.-
- AlicenseAqualityCmaintenanceEnables AI agents to search a local folder of Markdown, AsciiDoc, and text files through a SQLite FTS5 keyword index, returning the most relevant sections with file paths, line ranges, and heading breadcrumbs instead of grepping through a repo. It also exposes tools to list indexed documents and refresh the index incrementally, all offline with no dependencies, network calls, or embeddings.3MIT