> ## Documentation Index
> Fetch the complete documentation index at: https://docs.streampixel.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Working with Unreal MCP

> How Epic's Unreal MCP, the Streampixel command line and the Streampixel MCP work together: edit the project, package and deploy it, test it, then diagnose the test session.

> [!NOTE]
>
> **Beta.** The Streampixel command line (version 0.1.0-beta.1) and the Streampixel MCP server are in beta. Commands, tools and their output can still change before the stable release.

Unreal MCP is Epic's MCP server inside the Unreal Editor (5.8 and later, experimental in Unreal). An AI coding agent connected to it can change your project. Add the Streampixel command line and the Streampixel MCP, and the same agent can put the project live and check how it streams.

## The loop

**1. Edit the project**

The agent changes assets, Blueprints, levels or settings through Unreal MCP. Without Unreal MCP, it edits the project files.

**2. Check and package**

`streampixel doctor` checks the project is ready to stream. `streampixel package` packages a Windows build. When either reports a problem, with a file and line or an asset, the agent fixes it through Unreal MCP and runs the same step again.

**3. Upload, deploy and test**

`streampixel upload`, then `streampixel deploy`, then `streampixel test`. The test starts one short session and reports whether a picture arrived. It also prints the session id.

**4. Diagnose**

The agent passes that session id to `diagnose_session` on the Streampixel MCP. It reads the session's records and the application's own log, and says what went wrong and what to do. For a build that stays in processing, it uses `get_build_status` with the build id.

If the diagnosis points at the project, the loop starts again at step 1.

## Who does what

* In this loop the agent packages, uploads and deploys with the command line, because the Streampixel MCP runs in the cloud and cannot reach the files on your computer. Outside it, you can still [upload it in the dashboard](https://docs.streampixel.io/resources/dashboard/builds.md), let [cloud builds](https://docs.streampixel.io/resources/cloud-builds/overview.md) package it from your repository, or give the REST API's [Upload File](https://docs.streampixel.io/resources/api-reference/upload-file-api.md) endpoint a download link to a zip you host.
* The Streampixel MCP can tell an assistant the command line steps for a project. Ask *"How do I put my Unreal project live?"* and it uses `deploy_from_my_computer`.
* Unreal MCP is set up in the Unreal Editor. See Epic's documentation for it.

## Set it up

1. [Install the command line and sign in](https://docs.streampixel.io/resources/ai-and-cli/command-line/install-and-sign-in.md).
2. [Connect your agent to the Streampixel MCP](https://docs.streampixel.io/resources/ai-and-cli/mcp/connect.md).
3. Run [`streampixel init`](https://docs.streampixel.io/resources/ai-and-cli/command-line/ai-coding-agents) in your Unreal project folder, so the agent knows these steps.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.