Build Faster With AI Tools

HYTOPIA's SDK was built out of the box to work extremely well with popular AI coding editors and tools like Cursor and Claude Code. Our SDK's development patterns, documentation, and examples make AI assistants capable of building many complex features and ideas using the HYTOPIA SDK with as little as a single prompt.

AI tools are also a fantastic way to assist you in quickly getting up to speed with how to use the HYTOPIA SDK. By using these tools to ask how to implement specific ideas you have, they can fast-track your learning of how the HYTOPIA SDK works by coding what you're trying to do!

To supercharge your development experience beyond just regular AI tooling, HYTOPIA provides a specialized MCP server that runs in parallel with your development environment.

What is the HYTOPIA MCP Server?

The HYTOPIA MCP (Model Context Protocol) Server provides tools and resources to help developers build games with the HYTOPIA SDK.

It enables AI assistants like Claude to provide accurate, up-to-date guidance specific to HYTOPIA game development. It turns a generalized AI assistant into a supercharged game development expert with full knowledge of the HYTOPIA SDK.

HYTOPIA MCP Installation

First, let's start by installing the HYTOPIA MCP for a new project or an existing project. Here's how to do that.

Option 1: New Project Setup

When creating a new HYTOPIA project, you can have the MCP server automatically configured for you:

bunx hytopia init

During the initialization process, you'll be presented with a questionnaire. Answer the questions, and the MCP server will be set up for you.

Option 2: Adding to an existing project

If you're integrating the MCP server into an existing HYTOPIA project:

bunx hytopia init-mcp

Follow the prompts to configure the MCP server for your environment.

Using the HYTOPIA MCP Server

Once configured, the HYTOPIA MCP Server provides the following tools to AI assistants:

• getDocumentation - Retrieve HYTOPIA SDK documentation for a specific topic

• listDocumentation - List all available HYTOPIA SDK documentation topics

• search - Search across documentation and projects. Use semantic/keyword matching by default, or enable regex mode for pattern matching in code

• askQuestion - Ask a question and get an AI-generated answer with citations from documentation and code examples

• listProjects - List all available example projects

• searchProject - Search for code within a specific project

• readProjectFile - Read the complete content of a specific file from a project

• listProjectFiles - List all files in a specific project

Best Practices

For best results, ensure you are using a model that is sufficiently capable. We recommend using Claude 4 Sonnet as it performs extremely well at agentic coding. Sonnet is capable of taking your game request and breaking it down into individual components that it can search for using the HYTOPIA MCP Server.

Troubleshooting

If the MCP server isn't functioning as expected:

• Verify the MCP server is enabled in your IDE settings

• Check that you're in the correct project directory with a valid HYTOPIA project

• Try reinitializing the MCP server with bunx hytopia init-mcp

• Restart your IDE

Manual HYTOPIA MCP Connection

{
  "mcpServers": {
    "hytopia-mcp": {
      "url": "https://ai.hytopia.com/mcp"
    }
  }
}

The manual connection string can be used with any valid MCP client that supports Streamable HTTP.

Discord Help Bot

HYTOPIA also hosts a free SDK help bot in Discord. Check out the sdk-help channel and use /ask to get high-quality answers about building with the SDK.