ThemeParks.wiki

Exposes ThemeParks.wiki data via MCP tools for park hours, attractions, and show times

other

3

GitHub Stars

other

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "habuma-tpapi-mcp-server": {
      "command": "/path/to/java",
      "args": [
        "-jar",
        "/path/to/project/build/libs/tpapi-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

You deploy the ThemeParks.wiki API MCP Server to expose ThemeParks.wiki data as easy-to-use tools. This server provides up-to-date theme park hours, attraction wait times, and show times through a simple MCP interface you can query from your MCP client.

How to use

Use an MCP client to connect to the ThemeParks.wiki API MCP Server. You will run the server process locally or remotely and then call the available tools to fetch data such as park schedules, attractions, and live wait times for attractions or shows.

Available tools include getting a park’s attractions and shows, retrieving operating hours for a park on a specific date, listing all parks, searching parks by name, fetching a specific entity by ID, and obtaining live wait times or show times for an entity. You will supply the required input fields described with each tool to obtain the corresponding data.

How to install

Prerequisites you need installed before building and running the MCP server are Java (version 21 or higher) and a build tool compatible with your environment.

Steps to build the MCP server into an executable JAR:

./gradlew build

The JAR file will be created at the following location after a successful build:

build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar

Optionally, you can also build a Docker image for the MCP server:

./gradlew bootBuildImage --imageName=habuma/tpapi-mcp-server

Note: Do not attempt to run the executable JAR directly in your environment. The MCP Client (such as Claude Desktop) will manage running the server for you.

Usage with Claude Desktop requires configuring the MCP server in your Claude Desktop configuration file. Use the exact command and jar path shown below to point the client to the server executable.

{
  "mcpServers": {
    "tpapi": {
      "command": "/path/to/java",
      "args": [
        "-jar",
        "/path/to/project/build/libs/tpapi-mcp-server-0.0.1-SNAPSHOT.jar"
      ]
    }
  }
}

Additional notes

If you prefer a Docker-based workflow, you can create the image as shown above, and the MCP Client can still launch and manage the server for you. Ensure the Java runtime and Gradle wrapper are available in the environment where you build the image.

Available tools

getEntityChildren

Return a list of attractions and shows in a park given the park's entity ID.

getEntityScheduleForDate

Return a park's operating hours for a specific date in yyyy-MM-dd format, given the park's entity ID.

getAllParks

Return a list of all parks with their names and entity IDs.

getParksByName

Return parks that match a given park or resort name, including their names and entity IDs.

getEntity

Return an entity by its entity ID.

getEntityLive

Return an attraction's wait times or a show's show times for a given entity ID.