API & MCP – Tourism.one Data

Access

You can read open data without a key. These are objects that come exclusively from sources with an open licence.

A tenant key gives access to the data of a region or a customer and, for own data, also write access. It is issued on request only and sent in the header “Authorization: Bearer <key>”.

Request a key

REST interface

Base address: https://data.tourism.one. The interface is marked as version 0; changes are still possible.

GET /api/v0/objects: Search objects. Filters: query, type (Place, Accommodation, Event, Tour, Organization), category, limit.
GET /api/v0/objects/{id}: One object with all its details and their origin.
GET /objects/{id}: The same object as JSON-LD (Schema.org). Choose the language with lang.
GET /schema/v0.1/object.schema.json: JSON Schema of the objects.
GET /api/v0/sources: Source register. Filters: mode, category, status.
GET /api/v0/stats: Overall figures for the open data.
GET /api/v0/categories: Categories (taxonomy).
GET /api/v0/changes: Changes since a point in time (since).

Example requests

curl "https://data.tourism.one/api/v0/sources?mode=read-only"
curl "https://data.tourism.one/api/v0/objects?type=Event&limit=5"
curl -H "Authorization: Bearer <key>" "https://data.tourism.one/api/v0/objects?query=sauna"

MCP for AI assistants

Through the MCP endpoint https://mcp.tourism.one, AI assistants search the data, list sources and categories and check where individual details come from. Without a key, access is read-only and limited to open data.

The address mcp.tourism.one is currently being set up.

Example configuration for an MCP client

Without a key (open data, read-only). The configuration syntax differs from client to client.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one"
    }
  }
}

With a tenant key (the tenant’s data; own data can also be written). Replace the placeholder with your key and never store it in a repository.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Tools

Without a key (read-only)

search_objects
get_object
find_nearby
list_events
list_changes
describe_schema
list_sources
list_categories

With a tenant key

tenant_stats
search_tenant_objects
upsert_own_object
delete_own_object
export_tourismus_one

The range grows with each version; the tool list returned by the server itself is authoritative.