⚔️Model Context Protocol🛡️

Tibia
MCP Server

Give your AI access to the entire TibiaWiki database

20,000+entities
19tools
20entity types
View on GitHubQuick Start

feito por brasileiros 🇧🇷

▼

What Is This?

🔌

MCP Server

The Model Context Protocol is an open standard that lets AI agents call external tools. This server exposes 19 specialized tools for querying structured Tibia game data — no hallucinations, just real wiki data.

📖

TibiaWiki Data

Over 20,000 entities crawled from TibiaWiki and stored in PostgreSQL. Creatures, items, spells, NPCs, quests, and 15 more entity types — all parsed, normalized, and cross-referenced.

AI Agent
"Ask anything"
→
MCP Server
19 tools
→
PostgreSQL
20,000+ entities

19 Tools for AI Agents

From quick lookups to complex cross-entity analysis

📊Discovery

describe_tables

View database schema, row counts, and column details

describe_tables("creatures")
📋Discovery

list_entities

Browse entities by type with pagination and sorting

list_entities("items", limit=25)
🔍Search

search

Full-text search across all entity types

search("demon helmet")
🏷️Search

search_by_tags

Filter entities by auto-generated tags like "boss" or "immune_fire"

search_by_tags("creatures", ["boss", "high_exp"])
🧠Search

semantic_search

Natural language AI-powered search via embeddings

semantic_search("creatures that heal themselves")
🐲Creatures

creature_full_info

Complete creature profile: stats, loot, hunts, quest appearances

creature_full_info("Demon")
🔥Creatures

creature_weakness

Find creatures weak to a specific damage element

creature_weakness("fire")
⚔️Creatures

compare_creatures

Side-by-side stat and weakness comparison

compare_creatures("Dragon Lord", "Frost Dragon")
📦Items

where_to_get_item

All ways to obtain an item: drops, shops, quest rewards

where_to_get_item("Falcon Longsword")
💰Items

where_to_sell_item

Find NPCs that buy a specific item and their prices

where_to_sell_item("Demon Helmet")
🛡️Items

items_for_vocation

Equipment suitable for your class and body slot

items_for_vocation("knight", "armor")
🎯Hunting

recommend_hunt

Best hunting places by level and vocation

recommend_hunt(250, "paladin")
💲Hunting

profit_analysis

Estimated gold per kill with detailed loot breakdown

profit_analysis("Hydra")
🗺️Map

get_map_url

Generate TibiaWiki interactive map URLs

get_map_url(32369, 32241, 7)
📍Map

search_by_position

Find entities near specific map coordinates

search_by_position(32369, 32241, 7, radius=100)
📎Map

nearby_entities

Entities near a named location — e.g. "near Rashid"

nearby_entities("Rashid", radius=50)
🏆Advanced

rank_entities

Top items by price, strongest creatures, best armor

rank_entities("items", "npc_value")
🗃️Advanced

query_database

Custom read-only SQL SELECT queries

query_database("SELECT name, exp FROM creatures WHERE exp > 10000")
🔎Advanced

get_entity

Full details for any single entity by type and name

get_entity("quests", "The Annihilator")

See It In Action

Ask a question, get structured data

tibiawiki-mcp
> "Best hunts for Paladin level 250?"
Tool: recommend_hunt(250, "paladin")
Hunting Place         | Exp Rating | Loot Rating
----------------------|------------|------------
Asura Palace          | ★★★★★      | ★★★★☆
Cobras                | ★★★★☆      | ★★★★★
Summer Elves          | ★★★★☆      | ★★★★☆
Issavi Surface        | ★★★★☆      | ★★★☆☆
Werelions             | ★★★☆☆      | ★★★★★

Quick Start

Up and running in under a minute

1Start the Server

terminal
$ git clone https://github.com/miltonhit/tibia_mcp
$ cd tibia_mcp
$ docker compose up -d
✔ MCP server running on localhost:8000

2Connect Your AI

mcp-config.json
{
  "mcpServers": {
    "tibiawiki": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

20 Entity Types

Every corner of the Tibia universe, structured and queryable

🐲
Creatures
⚔️
Items
✨
Spells
👤
NPCs
📜
Quests
🏆
Achievements
🐎
Mounts
👕
Outfits
🎯
Hunts
📖
Books
🏠
Buildings
🌍
Worlds
💎
Runes
🧬
Imbuements
🗺️
World Quests
🌀
World Changes
👻
Familiars
📋
Tasks
📦
Updates
🔗
Fansites