Tpapi MCP Server

🚀 Theme Park.wiki API MCP Server

This is an MCP server that exposes data from the Theme Park.wiki API as a tool.

🚀 Quick Start

This MCP server serves as a tool to expose data from the Theme Park.wiki API.

✨ Features

• Retrieve the opening hours of theme parks.
• Get the waiting times of rides.
• Obtain the schedules of shows.

📚 Documentation

API

Tools

• getEntityChildren
  • Returns a list of entertainment items and shows within a park based on the park's entity ID.
  • Input: entityId (string)
• getEntityScheduleForDate
  • Retrieves the opening hours of a park based on the park's entity ID and a specific date (in the format yyyy-MM-dd).
  • Input:
    • entityId (string)
    • date (string; yyyy-MM-dd)
• getAllParks
  • Gets a list of all parks (including names and entity IDs).
• getParksByName
  • Retrieves a list of parks (including names and entity IDs) based on the park name or resort name.
  • Input: searchTerm (string)
• getEntity
  • Gets an entity based on the entity ID.
  • Input: entityId (string)
• getEntityLive
  • Obtains the waiting time or show schedule of a ride or show based on its entity ID.
  • Input: entityId (string)

📦 Installation

Building the Server

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

./gradlew build

This requires Java 21 or a higher version to be installed. It is recommended to use SDKMAN! to install and manage Java versions.

The JAR file will be located at build/libs/kt-mcp-server-0.0.1-SNAPSHOT.jar. Do not run this executable JAR file on your own. The MCP client (e.g., Claude Desktop) will start the server for you.

As an optional step, 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 on your own. The MCP client (e.g., Claude Desktop) will start the server for you.

💻 Usage Examples

Using with Claude Desktop

You can use the Theme Park.wiki API MCP server in Claude Desktop by adding a configuration to the claude_desktop_config.json file. Change the following paths to suit your environment:

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