ThemeParks.wiki API MCP Server

What is ThemeParks.wiki API MCP Server?

It is an MCP server that exposes theme park data—operating hours, attraction wait times, and show times—from the ThemeParks.wiki API as tools for MCP clients.

How to use ThemeParks.wiki API MCP Server?

Build the server as an executable JAR (requires Java 21+) using ./gradlew build, or as a Docker image with ./gradlew bootBuildImage. Then configure an MCP client such as Claude Desktop by adding the server to claude_desktop_config.json with the Java command and JAR path.

Key features of ThemeParks.wiki API MCP Server

• Get a list of all parks with names and entity IDs
• Search parks by name or resort name
• Retrieve park operating hours for a specific date
• List attractions and shows in a park
• Get live wait times for attractions or show times
• Look up any entity by its entity ID

Use cases of ThemeParks.wiki API MCP Server

• Find operating hours for a theme park on a planned visit date
• Check current wait times for rides before heading to the park
• List all attractions and shows available in a particular park
• Quickly look up park names and IDs for further queries

FAQ from ThemeParks.wiki API MCP Server

What Java version is required?

Java 21 or higher is required. The README recommends using SDKMAN! to manage Java versions.

How do I build the server?

Run ./gradlew build. The JAR file will be placed in build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar.

Can I run the server as a Docker container?

Yes, build a Docker image with ./gradlew bootBuildImage --imageName=habuma/tpapi-mcp-server. Do not run the container directly; let the MCP client launch it.

How do I use this server with Claude Desktop?

Add the server to claude_desktop_config.json with the Java command and path to the built JAR file. Example configuration is provided in the README.

What tools does the server provide?

Six tools: getAllParks, getParksByName, getEntityScheduleForDate, getEntityChildren, getEntity, and getEntityLive. They return park lists, schedules, attraction/show lists, entity details, and live wait/show times.