com.IvanMurzak.Brutal.MCP
0.2.3
dotnet add package com.IvanMurzak.Brutal.MCP --version 0.2.3
NuGet\Install-Package com.IvanMurzak.Brutal.MCP -Version 0.2.3
<PackageReference Include="com.IvanMurzak.Brutal.MCP" Version="0.2.3" />
<PackageVersion Include="com.IvanMurzak.Brutal.MCP" Version="0.2.3" />
<PackageReference Include="com.IvanMurzak.Brutal.MCP" />
paket add com.IvanMurzak.Brutal.MCP --version 0.2.3
#r "nuget: com.IvanMurzak.Brutal.MCP, 0.2.3"
#:package com.IvanMurzak.Brutal.MCP@0.2.3
#addin nuget:?package=com.IvanMurzak.Brutal.MCP&version=0.2.3
#tool nuget:?package=com.IvanMurzak.Brutal.MCP&version=0.2.3
Brutal-MCP connects AI agents (Claude Code, Codex, Cursor …) to games built on the BRUTAL C# framework. It is a NuGet package, com.IvanMurzak.Brutal.MCP, that runs inside your game process: agents inspect and change the running game with RQL, read its logs and learn how to write BRUTAL code from generated skills.
BRUTAL has no editor, so there is no in-game UI either: the plugin starts itself in Debug builds and is configured through the AI Game Developer App or environment variables.
Features
- ✅ Live game state — query and change registered objects, statics and logs with RQL
- ✅ Main-thread safe — agent changes run between your frames in
BrutalMcp.Tick() - ✅ BRUTAL types —
float3,floatQuat,float4x4, colors read and written as text - ✅ Run C# —
script-executeruns agent code in the game (Debug builds only) - ✅ Skills —
brutal-rqlandbrutal-frameworkgenerated from the live game - ✅ Extensions — ImGui, Glfw, Sdl, Jolt, Box2D, Fmod, RakNet, Vma, RenderDoc
- ✅ Never in the way — no call throws into your game; it never kills your process
Install
With the AI Game Developer App (recommended). Open your BRUTAL game project in the App and enable the BRUTAL integration: the App adds the package to your .csproj, writes .ai-game-dev/brutal-mcp.json, generates the agent skills and launches the game with the right BRUTAL_MCP_* environment variables. Sign-in is shared with the App.
Manually.
dotnet add package com.IvanMurzak.Brutal.MCP
That is all for Debug builds: the package adds a module initializer that starts the plugin before Main. Release builds need <BrutalMcpAutoStart>true</BrutalMcpAutoStart>. The target framework is net10.0. See Configuration for connection modes, sign-in and every setting.
Two lines in your game
using com.IvanMurzak.Brutal.MCP;
BrutalMcp.Register(world, "World"); // make objects visible to agents (any C# object)
BrutalMcp.Register(scheduler, "Simulation");
while (!window.ShouldClose && !BrutalMcp.QuitRequested)
{
Glfw.PollEvents();
Update();
BrutalMcp.Tick(); // once per frame: agents' main-thread work runs here
}
Register(obj, name)/Unregister(obj)choose what agents see. Static fields and properties of your game assembly are visible without registration.Tick()drains the main-thread queue within a small budget (default 4 ms). Without it, writes fail after 5 s with an explanation.QuitRequested/QuitRequestedEvent: an agent asked the game to quit (game-quit).- Mark methods agents may invoke with
[Rql.RqlCallable("what it does")].
What an agent does with it
The agent can read and change virtually anything your game registers, through a few compact tools: one RQL query answers a question in one call, so the agent needs fewer calls and tokens and works faster and cheaper. All tools, RQL sources and skills: What agents get.
Extensions
Optional packages com.IvanMurzak.Brutal.MCP.<Feature> for BRUTAL feature packages. Each adds RQL sources and usually needs one registration line:
| Extension | Adds |
|---|---|
| ImGui | windows, IO and style, ini settings, console commands |
| Glfw / Sdl | windows (and monitors with GLFW) |
| Jolt / Box2D | 3D / 2D physics worlds and bodies |
| Fmod | banks, events, instances, buses, VCAs |
| RakNet | peers, connections, ping and packet statistics |
| Vma | GPU device, memory budget and heaps |
| RenderDoc | trigger and list frame captures |
Catalog, registration lines and the API for writing your own: Extensions.
Documentation
- Configuration — settings, sign-in, auto start
- What agents get — RQL tools and sources,
script-execute, skills - Extensions — catalog and extension API
- Architecture — design and runtime lifecycle
- Testing — unit tests and the live smoke · Releasing — maintainers, through the release train
Related: RQL · GameDev-MCP-Server · ai-game.dev
Licence
Brutal-MCP is licensed under the Apache License 2.0. It depends on McpPlugin / ReflectorNet (Apache-2.0) and on com.IvanMurzak.Rql and com.IvanMurzak.CodeExec (PolyForm Shield License 1.0.0). PolyForm Shield restricts only companies that build competing AI tools for game development: game developers can use everything freely, commercial games included.
BRUTAL itself is licensed by Ahwoo Limited under the BRUTAL License (MIT + attribution). Its attribution duties — credits line, BRUTAL logo before gameplay, shipping NOTICE.txt, third-party notices — apply to your game, as a product built with BRUTAL, not to this package. Brutal-MCP is an independent project, not affiliated with Ahwoo.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- Ahwoo.BRUTAL.Collections (>= 2026.10.1)
- Ahwoo.BRUTAL.Concurrency (>= 2026.10.1)
- Ahwoo.BRUTAL.Core (>= 2026.10.1)
- Ahwoo.BRUTAL.Localization (>= 2026.10.2)
- Ahwoo.BRUTAL.Logging (>= 2026.10.2)
- Ahwoo.BRUTAL.Numerics (>= 2026.10.1)
- com.IvanMurzak.CodeExec (= 0.4.1)
- com.IvanMurzak.McpPlugin (>= 8.24.0)
- com.IvanMurzak.ReflectorNet (>= 5.5.3)
- com.IvanMurzak.Rql (>= 0.4.0)
- Microsoft.AspNetCore.SignalR.Client (>= 8.0.33)
- Microsoft.AspNetCore.SignalR.Common (>= 8.0.33)
- Microsoft.CodeAnalysis.CSharp (>= 5.9.0)
NuGet packages (9)
Showing the top 5 NuGet packages that depend on com.IvanMurzak.Brutal.MCP:
| Package | Downloads |
|---|---|
|
com.IvanMurzak.Brutal.MCP.Jolt
Brutal-MCP extension for Ahwoo.BRUTAL.Jolt: exposes live Jolt physics to AI agents through RQL. |
|
|
com.IvanMurzak.Brutal.MCP.Box2D
Brutal-MCP extension for Ahwoo.BRUTAL.Box2D: exposes live Box2D physics to AI agents through RQL. |
|
|
com.IvanMurzak.Brutal.MCP.Fmod
Brutal-MCP extension for Ahwoo.BRUTAL.Fmod: FMOD Studio (banks, events, live instances, buses, VCAs; play / stop / parameters), exposed to AI agents through RQL. |
|
|
com.IvanMurzak.Brutal.MCP.RakNet
Brutal-MCP extension for Ahwoo.BRUTAL.RakNet: RakNet peers and connections (pings, statistics, network simulator), exposed to AI agents through RQL. |
|
|
com.IvanMurzak.Brutal.MCP.RenderDoc
Brutal-MCP extension for Ahwoo.BRUTAL.RenderDoc: RenderDoc in-application API (captures, trigger capture, replay UI), exposed to AI agents through RQL. |
GitHub repositories
This package is not used by any popular GitHub repositories.