# Hathora MCP for AI Agents AI Agent Connect > Hathora MCP lets you manage multiplayer game host infrastructure directly from your AI agent. You can create applications, upload builds, and deploy game instances across global regions. It also handles game room orchestration, lobby management, and process monitoring to keep your game backend running smoothly. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_lblkC9JZNZr4yIkSYSD3Wb0QWve8vPqvdGNAIBGT/ai-agent-connect - **Tags:** multiplayer-hosting, game-servers, hathora-cloud, deployment-automation, serverless-gaming ## Description Connect your Hathora account to any AI agent and take full control of your multiplayer game host orchestration through natural conversation. Imagine you're in the middle of a sprint and need to spin up a new game room in London just to test a fix. Instead of jumping into a dashboard, logging in, and clicking through three different menus, you just tell your AI agent to do it. This Connector gives your agent the hands it needs to reach into your infrastructure. You can ask it to create a new application, upload your latest build, and set up a deployment with specific memory and CPU limits. It handles the tedious parts of game host orchestration, like checking if a process is actually running or grabbing connection info for a new session. Whether you're a dev trying to verify a build or an ops person keeping an eye on global health, having these actions available in your chat interface changes how you handle game backend tasks. It's one of the specialized tools you'll find in the Vinkius catalog that turns complex infrastructure management into a conversation. Instead of wrestling with manual configuration files or waiting for manual updates to propagate, you can keep your focus on the actual game logic. Your agent handles the heavy lifting of the backend, ensuring that your infrastructure stays in sync with your development goals. ## Tools ### create_lobby Create a new lobby for players. Use this to set up matchmaking spaces for your game. ### create_room Create a new game room or session. This lets your agent spin up active game instances in specific regions. ### get_application Get details for a specific Hathora application. Use this to check the status and configuration of your game services. ### get_room_connection_info Get connection info for a room. This helps your agent provide the necessary details for players to join a session. ### list_active_processes List active processes for an application. Use this to see what's currently running and check host health. ### create_deployment Create a deployment for a build. This lets you set up your game environment with exact hardware specs. ### upload_build Upload a build file for a specific build ID. This lets you push new host binaries to the cloud. ### create_application Create a new Hathora application. Use this to register new game services in your account. ### create_build Initiate a new build process. This starts the cycle of preparing your game binaries for deployment. ## Prompt Examples **Prompt:** ``` Can you spin up a game room in Frankfurt and give me the connection details? ``` **Response:** ``` Requesting room creation in Frankfurt... Success! **Room Details:** - **ID:** `room-992-xyz` - **Status:** Active - **Region:** Frankfurt **Connection Info:** - **Address:** `frankfurt-01.hathora.dev:7777` - **Port:** `7777` ``` **Prompt:** ``` I need to upload a new build and set up a deployment with 4GB of RAM. ``` **Response:** ``` I've started the process for you: 1. **Upload:** Sending `build_v2.tar` to Hathora... 2. **Deployment:** Creating a new instance with **4GB RAM** and **2 CPUs**. I'll let you know as soon as the deployment is live. ``` **Prompt:** ``` Are my Seattle game applications running correctly right now? ``` **Response:** ``` I checked the active processes for your Seattle application. Here is the status: | Host | Status | Load | | :--- | :--- | :--- | | Seattle-01 | **Healthy** | 12% | | Seattle-02 | **Healthy** | 15% | | Seattle-03 | **Healthy** | 11% | ``` ## Capabilities ### Spin up game rooms Create new game sessions in specific global regions instantly. ### Manage deployments Set up game host environments with custom environment variables and hardware limits. ### Handle lobby creation Set up public or private spaces for player matchmaking. ### Monitor active processes Check the health and status of running game applications. ### Upload game builds Send your host binaries to the cloud for deployment. ### Manage applications Create and inspect the core game services in your account. ## Use Cases ### Testing a London fix A dev needs to see if a bug is fixed in the UK. They ask the agent to use `create_room` in London and get the connection info. ### Rolling out a new version A studio lead wants to push a build. They ask the agent to use `upload_build` and `create_deployment` to update the production fleet. ### Checking host health A DevOps engineer wants to know if the Seattle hosts are up. They ask the agent to `list_active_processes` and report the status. ### Setting up a new project A developer creates a new project. They ask the agent to use `create_application` and `create_build` to get the environment ready. ## Benefits - Faster room creation with `create_room` allows you to test global latency in seconds. - Precise hardware control with `create_deployment` ensures your game has the right CPU and memory. - Instant build updates with `upload_build` means you can push hotfixes to the cloud faster. - Real-time health checks with `list_active_processes` let you spot host crashes before players do. - Easy matchmaking setup with `create_lobby` simplifies how you handle player sessions. - Quick application inspection with `get_application` gives you a snapshot of your entire fleet. ## How It Works The bottom line is you get to manage your entire multiplayer game backend through a chat interface instead of a web dashboard. 1. Connect your Hathora Developer Token to the Connector. 2. Open your AI client and describe the infrastructure task you need. 3. Get confirmation on the new deployment, room ID, or process status. ## Frequently Asked Questions **How does Hathora help with game host management?** Hathora lets you manage your game host infrastructure through a chat interface. You can deploy builds, create rooms, and monitor your host health without leaving your favorite AI client. **Can I use Hathora to manage game rooms in different regions?** Yes. You can ask your agent to spin up game rooms in specific regions like London, Seattle, or Frankfurt and get the connection info immediately. **How do I deploy a new game build using this Connector?** You can simply tell your agent to upload your build file and create a new deployment. It will handle the configuration and hardware limits for you. **Can I monitor my game host health through my AI agent?** Yes. You can ask your agent to list active processes to see what's currently running and check the status of your game applications. **How does Hathora handle game lobbies and matchmaking?** You can use it to create public or private lobbies. This helps you set up the spaces where players find and join your game sessions. **Can I use this to set specific CPU and memory limits?** Yes. When creating a deployment, you can specify the exact CPU and memory requirements for your game host environment. **How do I get connection info for my players?** Once a room is created, you can ask your agent to retrieve the connection info. It will provide the address and port for your players to join. **How do I find the IP and port for players to connect to a specific game session?** Use the `get_room_connection_info` tool with your App ID and Room ID. The agent will return the exact host and port details required for client-side connection. **Can I see how many server processes are currently running for my application?** Yes! Run the `list_active_processes` action. It will provide a list of all active server processes associated with your specific Application ID. **How do I set up a matchmaking lobby for my game?** You can use the `create_lobby` tool. You'll need to specify the App ID, visibility (public/private), and the region where the session should be hosted.