Skip to main content
Glama
Shonas301

headless-unity-mcp

by Shonas301

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
unity_compileA

Import and compile all assemblies. The verdict is a error CS grep of the unity log, never the exit code — unity exits 0 on compile errors.

unity_testA

Run EditMode and/or PlayMode tests. The results XML is the evidence: a missing XML is a FAIL, any result="Failed" is a FAIL. Returns parsed per-platform totals.

unity_sceneA

(Re)generate a target's scene by invoking its configured scene_method. Only for projects that author scenes from code. Call unity_targets to list target names.

unity_buildB

Build the standalone player for a target, via its configured build_method. Call unity_targets to list target names.

unity_shotA

Launch the built player and screenshot its window by CGWindowID. Needs an existing build, the macOS Screen Recording grant, and an unlocked screen. Returns the PNG's path — read it in a throwaway subagent, not your main context.

unity_targetsA

List the build targets this project defines in unity-mcp.toml. Never takes the lock.

unity_statusA

Who, if anyone, holds the machine lock right now. Never takes the lock.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Shonas301/headless-unity-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server