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"
      ]
    }
  }
}