AgentGateway

AgentGateway is a Roblox library for defining actions an agent can perform with a plugin in Studio through a small, MCP-inspired gateway.

Installation

Wally

[dependencies]
AgentGateway = "flipbook-labs/agent-gateway@x.x.x"

Usage

Define your plugin's actions, register them, and stand up a gateway. Registered actions are discoverable and invokable by in-Studio agents.

local AgentGateway = require(path.to.AgentGateway)

type Context = { plugin: Plugin }

local config: AgentGateway.Config = {
	name = "MyPluginGateway",
	protocolVersion = 1,
}

local context: Context = { plugin = plugin }

local actions: { AgentGateway.Action<Context> } = {
	{
		name = "insertPart",
		title = "Insert Part",
		description = "Insert a new anchored Part into the Workspace.",
		inputSchema = {
			type = "object",
			properties = {
				name = { type = "string", description = "Name for the new Part" },
			},
		},
		run = function(ctx, params)
			local part = Instance.new("Part")
			part.Anchored = true
			part.Parent = workspace
			return { name = part.Name }
		end,
	},
}

local registry = AgentGateway.createActionRegistry(config, context, actions)
local cleanup = AgentGateway.createGateway(registry, config)

plugin.Unloading:Connect(cleanup)

An agent then talks to the gateway BindableFunction (parented to CoreGui by default):

local gateway = game:GetService("CoreGui").MyPluginGateway

-- Discover available actions
gateway:Invoke({ method = "list" })

-- Invoke one
gateway:Invoke({ method = "call", action = "insertPart", params = { name = "AgentPart" } })

For a complete, runnable plugin see examples/agent-plugin.

License

The contents of this repository are available under the MIT License. For full license text, see LICENSE.