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
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="com.IvanMurzak.Brutal.MCP" Version="0.2.3" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="com.IvanMurzak.Brutal.MCP" Version="0.2.3" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.Brutal.MCP" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add com.IvanMurzak.Brutal.MCP --version 0.2.3
                    
#r "nuget: com.IvanMurzak.Brutal.MCP, 0.2.3"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package com.IvanMurzak.Brutal.MCP@0.2.3
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=com.IvanMurzak.Brutal.MCP&version=0.2.3
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.Brutal.MCP&version=0.2.3
                    
Install as a Cake Tool

Brutal-MCP: AI agents inside your running BRUTAL game, query and change live state with RQL

NuGet .NET 10 License: Apache-2.0 Stand with Ukraine

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.

The App installs, configures and launches the game. Inside the game process your code, the Brutal-MCP core and its extensions expose BRUTAL state; the plugin connects over SignalR to the MCP server, which serves AI agents

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-execute runs agent code in the game (Debug builds only)
  • ✅ Skills — brutal-rql and brutal-framework generated 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

Example session: rql-query finds entities with low health, rql-mutate sets a value on the main thread, a console query reads the latest errors

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

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 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

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.

Version Downloads Last Updated
0.2.3 58 11/14/2026
0.2.2 60 11/14/2026
0.2.1 152 10/22/2026
0.2.0 106 10/20/2026
0.1.1 142 10/17/2026
0.1.0 197 10/17/2026