odh-mcp-server
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., "@odh-mcp-server Find accommodations near Bolzano center with pool"
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.
odh-mcp-server
A FastMCP server that exposes hospitality data — accommodations, events, and gastronomy — through a unified MCP interface. Part of the GaiaWM ecosystem, it is open source, self-hostable, and designed to work both locally (stdio) and remotely (SSE / streamable-http).
The server maintains a "current world" in session context. A set_world tool switches the active world. All other tools query the current world transparently. The same find_accommodations call returns real hotel data from South Tyrol or fictional inn listings from a Spelljammer asteroid city.
Quickstart
# Install with uv (recommended)
pip install uv
# Run locally via stdio (Claude Desktop, etc.)
uvx odh-mcp-server --stdio
# Or clone and run directly
git clone https://github.com/openfantasymap/odh-mcp-server
cd odh-mcp-server
uv run server.py --stdioRelated MCP server: FastMCP
Available worlds
World ID | Name | Data source | Notes |
| South Tyrol | Open Data Hub ( | Real hotels, events, restaurants. WGS84 coordinates. |
| The Rock of Bral | JSON fixtures | Spelljammer city-asteroid. Mock data for demo/roleplay. |
Tools
Tool | Description |
| Switch the active world. Returns world description on success. |
| Describe the current world and how to query it. |
| Search for hotels / inns with optional geo, feature, and date filters. |
| Search for events with optional geo, date, and topic filters. |
| Search for restaurants and food places with geo and cuisine filters. |
Example session
# 1. Start in South Tyrol
set_world("earth-313")
→ World set to: South Tyrol (earth-313)
Real hospitality data from the Open Data Hub...
# 2. Find hotels near Bolzano with a pool
find_accommodations(near="Bolzano centro", features=["pool"], max_results=3)
→ Found 2 accommodations in South Tyrol (earth-313), near Bolzano centro...
# 3. Switch to the Rock of Bral
set_world("bral")
→ World set to: The Rock of Bral
A city-asteroid drifting through Wildspace...
# 4. Find an inn near the Great Market
find_accommodations(near="great market", radius_m=800)
→ Found 1 inn in the Rock of Bral, near great market...
1. The Raised Cup [inn] (budget) — A lively taproom in the lower city...Claude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"odh-world": {
"command": "uv",
"args": ["run", "/path/to/odh-mcp-server/server.py", "--stdio"]
}
}
}Or, once published to PyPI:
{
"mcpServers": {
"odh-world": {
"command": "uvx",
"args": ["odh-mcp-server", "--stdio"]
}
}
}Session context notes
The server uses contextvars.ContextVar to track the current world per session.
SSE / streamable-http transport: each client connection gets its own context — multiple users can be in different worlds simultaneously.
stdio transport: single process, single context — fine for local single-user use (Claude Desktop, CLI).
Adding a new world
Create
worlds/myworld.pyand implement theWorldAdapterabstract base class:
from worlds.base import WorldAdapter, Accommodation, Event, GastronomyPlace, WorldInfo
class MyWorldAdapter(WorldAdapter):
async def find_accommodations(self, ...) -> list[Accommodation]: ...
async def find_events(self, ...) -> list[Event]: ...
async def find_gastronomy(self, ...) -> list[GastronomyPlace]: ...
async def describe(self) -> WorldInfo: ...Register it in
worlds/__init__.py:
from .myworld import MyWorldAdapter
WORLD_REGISTRY = {
"earth-313": Earth313Adapter(),
"bral": BralAdapter(),
"myworld": MyWorldAdapter(), # add this line
}That's it. All tools will automatically support your new world once it's in the registry.
Configuration
Copy .env.example to .env and adjust as needed:
DEFAULT_WORLD=earth-313
ODH_BASE_URL=https://tourism.api.opendatahub.com/v1
ODH_TIMEOUT=10
NOMINATIM_URL=https://nominatim.openstreetmap.org
NOMINATIM_USER_AGENT=odh-mcp-server/0.1 (opensource hospitality MCP)License
MIT
Available Tools
5 toolsdescribe_worldA
Return a narrative description of the current world, including what data is available and how to query it.
Inputs: no named parameters. Returns: result
find_accommodationsA
Find accommodations in the current world.
Parameters:
near: place name (geocoded automatically for earth-313, landmark-resolved for other worlds)
lat/lon: alternative to near, direct coordinates
radius_m: search radius in meters / units (default 5000)
features: list of desired features. For earth-313: family, pool, sauna, parking, wifi, accessible, pets, meeting, pickup, allergy For bral: spacefarer-friendly, private-rooms, common-room, stabling, secure-storage, pets
category: star rating for earth-313 (1star to 5stars), ignored for bral
available_from/available_to: date range (yyyy-MM-dd), earth-313 only
max_results: maximum number of results (default 5)
Returns a formatted narrative list of accommodations with key details.
Inputs: lat, lon, near, category, +5 more. Returns: result
find_eventsA
Find events in the current world.
Parameters:
near: place name (geocoded for earth-313, landmark-resolved for bral)
lat/lon: direct coordinates, alternative to near
radius_m: search radius in meters / units (default 10000)
date_from/date_to: date range filter (yyyy-MM-dd), primarily for earth-313
topic: topic or category keyword (e.g. "music", "sport", "culture", "market")
max_results: maximum number of results (default 5)
Returns a formatted narrative list of events.
Inputs: lat, lon, near, topic, +4 more. Returns: result
find_gastronomyA
Find restaurants, food stalls, and gastronomy places in the current world.
Parameters:
near: place name (geocoded for earth-313, landmark-resolved for bral)
lat/lon: direct coordinates, alternative to near
radius_m: search radius in meters / units (default 5000)
cuisine: cuisine type keyword (e.g. "italian", "shou", "bakery", "tavern")
features: desired features (e.g. ["vegetarian-options", "outdoor-seating"])
max_results: maximum number of results (default 5)
Returns a formatted narrative list of gastronomy places.
Inputs: lat, lon, near, cuisine, +3 more. Returns: result
set_worldA
Set the current world context for all subsequent queries.
Available worlds:
earth-313: South Tyrol / Alto Adige, Italy. Real hospitality data from the Open Data Hub.
Any OFM world ID (e.g. 'bral'): fixture-backed fantasy worlds from the OpenFantasyMap project.
Returns a confirmation message with the world's description and available tools.
Inputs: world (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct operation: set_world establishes context, describe_world explains it, and the three find_* tools query for accommodations, events, and gastronomy separately. Even though they share parameters like near and radius_m, the entity types are clearly different, so an agent can easily select the right tool.
All tool names follow a consistent verb_noun pattern in snake_case: set_world, describe_world, find_accommodations, find_events, find_gastronomy. The verbs (set, describe, find) are clear and the nouns are specific, making the pattern predictable.
With 5 tools, the server is well-scoped for its purpose of exploring hospitality and tourism data in a world context. Each tool earns its place: world management (set, describe) and three distinct search types (accommodation, events, gastronomy). No redundancy or bloat.
The server's domain is read-only exploration of world-based hospitality data, and it covers the core workflow: set the world to establish context, understand what data is available via describe_world, and then search for the three primary POI types. There are no obvious dead ends, and all CRUD operations beyond reading are outside the stated purpose.
Maintenance
Related MCP Connectors
Hotel booking MCP server. Search, book, and manage reservations across 250K+ properties worldwide.
Official MCP server for MAQAMI, a hotel and flight booking platform with 3M+ hotels. Search live hotel rates and flights, look up places, airports and hotel details, then prebook and book. Remote Streamable HTTP endpoint, no API key required.
Unofficial read-only MCP server for VeryChic hotel offers
Hosted MCP server for live public-data APIs and Skills for AI agents.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP server that provides safe, read-only access to SQLite databases through MCP. This server is built with the FastMCP framework, which enables LLMs to explore and query SQLite databases with built-in safety features and query validation.108-
- AlicenseNot gradedqualityDmaintenanceFastMCP is a comprehensive MCP server allowing secure and standardized data and functionality exposure to LLM applications, offering resources, tools, and prompt management for efficient LLM interactions.3MIT
- AlicenseAqualityDmaintenanceMCP server providing cosiness scores for about 6,300 independent hotels, with tools to find hotels by city/country and retrieve detailed feeling data.2MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server exposing the internal Ticket API to MCP clients, built with FastMCP's OpenAPI integration.2-