ThemeParks.wiki API MCP Server: Real-Time Data & Seamless Integration

How to use ThemeParks.wiki API MCP Server: Real-Time Data & Seamless Integration?

Start by building the server:

# For Java users
./gradlew build

Then configure Claude Desktop with your adjusted paths:

{
  "mcpServers": {
    "tpapi": {
      "command": "/usr/lib/jvm/java-21/bin/java",
      "args": ["-jar", "/home/user/tpapi-server/build/libs/tpapi-mcp-server-0.0.1-SNAPSHOT.jar"]
    }
  }}

Let the MCP client handle server management—no manual Docker runs needed despite the option existing.

Use cases of ThemeParks.wiki API MCP Server: Real-Time Data & Seamless Integration?

Imagine a family planning Orlando trips using getParksByName to filter Florida parks, then checking getEntityLive for Hogwarts Castle wait times on their planned visit day. Or theme park operators monitoring multiple attractions' performance in real time through automated queries. The server also supports developers building custom itinerary planners with data from getEntityChildren

FAQ from ThemeParks.wiki API MCP Server: Real-Time Data & Seamless Integration?

Do I need coding skills?

No. The server works out-of-the-box with Claude Desktop—just configure paths.

What if my park isn't listed?

Use getAllParks to discover supported locations first. New parks are added regularly.

Can I run it on Mac/Linux?

Yes. The Gradle build and Java runtime work cross-platform. Docker is optional but not required.

Why no manual JAR runs?

The MCP protocol integration requires the client to manage lifecycle. Focus stays on data, not server maintenance.

ThemeParks.wiki API MCP Server

This is an MCP Server that exposes data from the ThemeParks.wiki API as tools.

Features

• Get theme park operating hours
• Get attraction wait times
• Get show times

API

Tools

• getEntityChildren
  • Get a list of attractions and shows in a park given the park's entity ID
  • input: entityId (string)
• getEntityScheduleForDate
  • Get a park's operating hours given the park's entity ID and a specific date (in yyyy-MM-dd format).
  • input:
    • entityId (string)
    • date (string; yyyy-MM-dd)
• getAllParks
  • Get a list of all parks (including their name and entity ID)
• getParksByName
  • Get a list of parks (including their name and entity ID) given a park name or resort name
  • input: entityId (string)
• getEntity
  • Get an entity given its entity ID
  • input: entityId (string)
• getEntityLive
  • Get an attraction's wait times or a show's show times given the attraction or show entity ID
  • input: entityId (string)

Building the server

To build the server as an executable JAR file, run the following command:

./gradlew build

This will require Java 21 (or higher) to be installed. I recommend using SDKMAN! to install and manage Java versions.

The JAR file will be placed in build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar. Do not try to run this executable JAR file yourself. The MCP Client (such as Claude Desktop) will run the server for you.

Optionally, to build the server as a Docker image, run the following command:

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

Do not attempt to run this Docker image yourself. The MCP Client (such as Claude Desktop) will run the server for you.

Usage with Claude Desktop

You can use the ThemeParks.wiki API MCP Server in Claude Desktop by adding configuration to claude_desktop_config.json. Change the paths below to correctly reference the Java command line and the location of the executable JAR file:

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