@remix-gg/mcp 0.4.3

package/dist/server/create-server.test.js

@@ -0,0 +1,37 @@
+import { describe, expect, it, mock } from 'bun:test';
+import { SERVER_INSTRUCTIONS, createServer } from './create-server.js';
+class MockMcpServer {
+    definition;
+    options;
+    static instances = [];
+    constructor(definition, options) {
+        this.definition = definition;
+        this.options = options;
+        MockMcpServer.instances.push(this);
+    }
+}
+const registerAllTools = mock(() => { });
+const registerSkillResources = mock(() => { });
+describe('createServer()', () => {
+    it('builds the MCP server with the expected metadata and registrations', () => {
+        MockMcpServer.instances = [];
+        const server = createServer({
+            McpServerClass: MockMcpServer,
+            registerTools: registerAllTools,
+            registerResources: registerSkillResources,
+        });
+        expect(MockMcpServer.instances).toHaveLength(1);
+        const createdServer = server;
+        expect(createdServer).toBe(MockMcpServer.instances[0]);
+        expect(createdServer.definition).toEqual({
+            name: 'remix-mcp',
+            version: '0.1.0',
+        });
+        expect(createdServer.options).toEqual({
+            instructions: SERVER_INSTRUCTIONS,
+        });
+        expect(registerAllTools).toHaveBeenCalledWith(server);
+        expect(registerSkillResources).toHaveBeenCalledWith(server);
+    });
+});
+//# sourceMappingURL=create-server.test.js.map

package/dist/server/create-server.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-server.test.js","sourceRoot":"","sources":["../../src/server/create-server.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtE,MAAM,aAAa;IACjB,UAAU,CAAS;IACnB,OAAO,CAAS;IAChB,MAAM,CAAC,SAAS,GAAoB,EAAE,CAAA;IAEtC,YAAY,UAAmB,EAAE,OAAgB;QAC/C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAA;QAC5B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,aAAa,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpC,CAAC;;AAGH,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AACvC,MAAM,sBAAsB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;AAE7C,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC5E,aAAa,CAAC,SAAS,GAAG,EAAE,CAAA;QAE5B,MAAM,MAAM,GAAG,YAAY,CAAC;YAC1B,cAAc,EAAE,aAAsB;YACtC,aAAa,EAAE,gBAAgB;YAC/B,iBAAiB,EAAE,sBAAsB;SAC1C,CAAC,CAAA;QAEF,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;QAC/C,MAAM,aAAa,GAAG,MAAkC,CAAA;QAExD,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;QACtD,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;YACvC,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC;YACpC,YAAY,EAAE,mBAAmB;SAClC,CAAC,CAAA;QACF,MAAM,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;QACrD,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAA;IAC7D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":""}

package/dist/server/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './create-server.js';
+const server = createServer();
+const transport = new StdioServerTransport();
+// biome-ignore lint/suspicious/noExplicitAny: upstream SDK has duplicate installs with incompatible Transport types
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAA;AAChF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAA;AAC7B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAA;AAC5C,oHAAoH;AACpH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAgB,CAAC,CAAA"}

package/dist/server/lib/config.d.ts

@@ -0,0 +1,2 @@
+export { getConfig, type RemixConfig } from '../../core/config.js';
+//# sourceMappingURL=config.d.ts.map

package/dist/server/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/server/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/server/lib/config.js

@@ -0,0 +1,2 @@
+export { getConfig } from '../../core/config.js';
+//# sourceMappingURL=config.js.map

package/dist/server/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/server/lib/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAoB,MAAM,sBAAsB,CAAA"}

package/dist/server/resources/skills.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSkillResources(server: McpServer, loadFile?: (filename: string) => string): void;
+//# sourceMappingURL=skills.d.ts.map

package/dist/server/resources/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../../src/server/resources/skills.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAyCxE,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,QAAQ,GAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAsB,QAwCvD"}

package/dist/server/resources/skills.js

@@ -0,0 +1,60 @@
+import { loadSkillFile } from '../../core/skills.js';
+const SKILL_WORKFLOWS = {
+    'game-creation': {
+        file: 'workflows/game-creation.md',
+        description: 'Create a new HTML5 game from scratch with Remix scaffolding.',
+    },
+    'upload-game': {
+        file: 'workflows/upload-game.md',
+        description: 'Package and upload a finished game to the Remix platform.',
+    },
+    'implement-multiplayer': {
+        file: 'workflows/implement-multiplayer.md',
+        description: 'Integrate turn-based multiplayer using the Remix SDK.',
+    },
+    'integrate-save-game': {
+        file: 'workflows/integrate-save-game.md',
+        description: 'Add save/load game state using the Remix SDK.',
+    },
+    'add-image-to-game': {
+        file: 'workflows/add-image-to-game.md',
+        description: 'Add and manage image assets in a Remix game project.',
+    },
+    'manage-shop-items': {
+        file: 'workflows/manage-shop-items.md',
+        description: 'Create, list, update, delete, and integrate shop items.',
+    },
+    'add-sprite-to-game': {
+        file: 'workflows/add-sprite-to-game.md',
+        description: 'Generate and integrate animated sprite sheets in a Remix game.',
+    },
+};
+const SKILL_ACTIONS = {
+    'open-game': {
+        file: 'actions/open-game.md',
+        description: 'Open a game in the Remix Studio for preview and editing.',
+    },
+};
+export function registerSkillResources(server, loadFile = loadSkillFile) {
+    // Static resource: master skill overview
+    server.registerResource('skills-overview', 'skills://overview', {
+        description: 'Master overview of all available agent skills for the Remix Platform. ' +
+            'Read this first to understand what workflows are available.',
+        mimeType: 'text/markdown',
+    }, async (uri) => ({
+        contents: [{ uri: uri.href, text: loadFile('SKILL.md') }],
+    }));
+    // Individual workflow skill resources
+    for (const [key, { file, description }] of Object.entries(SKILL_WORKFLOWS)) {
+        server.registerResource(`skill-${key}`, `skills://${key}`, { description, mimeType: 'text/markdown' }, async (uri) => ({
+            contents: [{ uri: uri.href, text: loadFile(file) }],
+        }));
+    }
+    // Individual action skill resources
+    for (const [key, { file, description }] of Object.entries(SKILL_ACTIONS)) {
+        server.registerResource(`skill-${key}`, `skills://${key}`, { description, mimeType: 'text/markdown' }, async (uri) => ({
+            contents: [{ uri: uri.href, text: loadFile(file) }],
+        }));
+    }
+}
+//# sourceMappingURL=skills.js.map

package/dist/server/resources/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../../src/server/resources/skills.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEpD,MAAM,eAAe,GAA0D;IAC7E,eAAe,EAAE;QACf,IAAI,EAAE,4BAA4B;QAClC,WAAW,EAAE,8DAA8D;KAC5E;IACD,aAAa,EAAE;QACb,IAAI,EAAE,0BAA0B;QAChC,WAAW,EAAE,2DAA2D;KACzE;IACD,uBAAuB,EAAE;QACvB,IAAI,EAAE,oCAAoC;QAC1C,WAAW,EAAE,uDAAuD;KACrE;IACD,qBAAqB,EAAE;QACrB,IAAI,EAAE,kCAAkC;QACxC,WAAW,EAAE,+CAA+C;KAC7D;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,sDAAsD;KACpE;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,gCAAgC;QACtC,WAAW,EAAE,yDAAyD;KACvE;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,iCAAiC;QACvC,WAAW,EAAE,gEAAgE;KAC9E;CACF,CAAA;AAED,MAAM,aAAa,GAA0D;IAC3E,WAAW,EAAE;QACX,IAAI,EAAE,sBAAsB;QAC5B,WAAW,EAAE,0DAA0D;KACxE;CACF,CAAA;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,WAAyC,aAAa;IAEtD,yCAAyC;IACzC,MAAM,CAAC,gBAAgB,CACrB,iBAAiB,EACjB,mBAAmB,EACnB;QACE,WAAW,EACT,wEAAwE;YACxE,6DAA6D;QAC/D,QAAQ,EAAE,eAAe;KAC1B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;KAC1D,CAAC,CACH,CAAA;IAED,sCAAsC;IACtC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,gBAAgB,CACrB,SAAS,GAAG,EAAE,EACd,YAAY,GAAG,EAAE,EACjB,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC1C,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;SACpD,CAAC,CACH,CAAA;IACH,CAAC;IAED,oCAAoC;IACpC,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzE,MAAM,CAAC,gBAAgB,CACrB,SAAS,GAAG,EAAE,EACd,YAAY,GAAG,EAAE,EACjB,EAAE,WAAW,EAAE,QAAQ,EAAE,eAAe,EAAE,EAC1C,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YACd,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;SACpD,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/server/resources/skills.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=skills.test.d.ts.map

package/dist/server/resources/skills.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.test.d.ts","sourceRoot":"","sources":["../../../src/server/resources/skills.test.ts"],"names":[],"mappings":""}

package/dist/server/resources/skills.test.js

@@ -0,0 +1,44 @@
+import { describe, expect, it, mock } from 'bun:test';
+const loadSkillFile = mock((filename) => `contents:${filename}`);
+const { registerSkillResources } = await import('./skills.js');
+describe('registerSkillResources()', () => {
+    it('registers overview, workflows, and actions with expected loaders', async () => {
+        const registrations = [];
+        const server = {
+            registerResource: mock((name, uri, metadata, handler) => {
+                registrations.push({ name, uri, metadata, handler });
+            }),
+        };
+        registerSkillResources(server, loadSkillFile);
+        expect(server.registerResource).toHaveBeenCalledTimes(9);
+        expect(registrations.map((registration) => registration.uri)).toEqual([
+            'skills://overview',
+            'skills://game-creation',
+            'skills://upload-game',
+            'skills://implement-multiplayer',
+            'skills://integrate-save-game',
+            'skills://add-image-to-game',
+            'skills://manage-shop-items',
+            'skills://add-sprite-to-game',
+            'skills://open-game',
+        ]);
+        const overviewRegistration = registrations[0];
+        const openGameRegistration = registrations[8];
+        expect(overviewRegistration).toBeDefined();
+        expect(openGameRegistration).toBeDefined();
+        if (!overviewRegistration || !openGameRegistration) {
+            throw new Error('Missing expected skill registrations');
+        }
+        const overview = await overviewRegistration.handler(new URL('skills://overview'));
+        const openGame = await openGameRegistration.handler(new URL('skills://open-game'));
+        expect(loadSkillFile).toHaveBeenCalledWith('SKILL.md');
+        expect(loadSkillFile).toHaveBeenCalledWith('actions/open-game.md');
+        expect(overview).toEqual({
+            contents: [{ uri: 'skills://overview', text: 'contents:SKILL.md' }],
+        });
+        expect(openGame).toEqual({
+            contents: [{ uri: 'skills://open-game', text: 'contents:actions/open-game.md' }],
+        });
+    });
+});
+//# sourceMappingURL=skills.test.js.map

package/dist/server/resources/skills.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.test.js","sourceRoot":"","sources":["../../../src/server/resources/skills.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,UAAU,CAAA;AAErD,MAAM,aAAa,GAAG,IAAI,CAAC,CAAC,QAAgB,EAAE,EAAE,CAAC,YAAY,QAAQ,EAAE,CAAC,CAAA;AACxE,MAAM,EAAE,sBAAsB,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;AAE9D,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,kEAAkE,EAAE,KAAK,IAAI,EAAE;QAChF,MAAM,aAAa,GAKd,EAAE,CAAA;QAEP,MAAM,MAAM,GAAG;YACb,gBAAgB,EAAE,IAAI,CACpB,CACE,IAAY,EACZ,GAAW,EACX,QAAiC,EACjC,OAAuC,EACvC,EAAE;gBACF,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;YACtD,CAAC,CACF;SACF,CAAA;QAED,sBAAsB,CAAC,MAAe,EAAE,aAAa,CAAC,CAAA;QAEtD,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAA;QACxD,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC;YACpE,mBAAmB;YACnB,wBAAwB;YACxB,sBAAsB;YACtB,gCAAgC;YAChC,8BAA8B;YAC9B,4BAA4B;YAC5B,4BAA4B;YAC5B,6BAA6B;YAC7B,oBAAoB;SACrB,CAAC,CAAA;QAEF,MAAM,oBAAoB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,oBAAoB,GAAG,aAAa,CAAC,CAAC,CAAC,CAAA;QAC7C,MAAM,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,CAAC,oBAAoB,CAAC,CAAC,WAAW,EAAE,CAAA;QAC1C,IAAI,CAAC,oBAAoB,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAA;QACjF,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,oBAAoB,CAAC,CAAC,CAAA;QAElF,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAA;QACtD,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAA;QAClE,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,mBAAmB,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;SACpE,CAAC,CAAA;QACF,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACvB,QAAQ,EAAE,CAAC,EAAE,GAAG,EAAE,oBAAoB,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC;SACjF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/server/tools/register.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerAllTools(server: McpServer, toolDefs?: import("../../core/tool-defs.js").ToolDefinition<import("zod").ZodObject<any, import("zod/v4/core").$strip>>[]): void;
+//# sourceMappingURL=register.d.ts.map

package/dist/server/tools/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/server/tools/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,iHAAY,QAyBvE"}

package/dist/server/tools/register.js

@@ -0,0 +1,26 @@
+import { TOOL_DEFS } from '../../core/tool-defs.js';
+export function registerAllTools(server, toolDefs = TOOL_DEFS) {
+    for (const def of toolDefs) {
+        server.registerTool(def.name, {
+            title: def.title,
+            description: def.description,
+            inputSchema: def.inputSchema.shape,
+        }, 
+        // biome-ignore lint/suspicious/noExplicitAny: MCP callback input is schema-validated at runtime
+        async (input) => {
+            try {
+                const result = await def.execute(input);
+                return {
+                    content: [{ type: 'text', text: def.formatResult(result) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: 'text', text: err.message }],
+                    isError: true,
+                };
+            }
+        });
+    }
+}
+//# sourceMappingURL=register.js.map

package/dist/server/tools/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../src/server/tools/register.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,QAAQ,GAAG,SAAS;IACtE,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,CAAC,YAAY,CACjB,GAAG,CAAC,IAAI,EACR;YACE,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,WAAW,EAAE,GAAG,CAAC,WAAW,CAAC,KAAK;SACnC;QACD,gGAAgG;QAChG,KAAK,EAAE,KAAU,EAAE,EAAE;YACnB,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;gBACvC,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;iBACrE,CAAA;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAG,GAAa,CAAC,OAAO,EAAE,CAAC;oBAClE,OAAO,EAAE,IAAI;iBACd,CAAA;YACH,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/server/tools/register.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=register.test.d.ts.map

package/dist/server/tools/register.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.test.d.ts","sourceRoot":"","sources":["../../../src/server/tools/register.test.ts"],"names":[],"mappings":""}

package/dist/server/tools/register.test.js

@@ -0,0 +1,85 @@
+import { describe, expect, it, mock } from 'bun:test';
+const executeOk = mock(async () => ({ gameId: 'game-1' }));
+const executeError = mock(async () => {
+    throw new Error('boom');
+});
+const formatOk = mock(() => 'formatted success');
+const formatUnused = mock(() => 'formatted error');
+const { registerAllTools } = await import('./register.js');
+const toolDefs = [
+    {
+        name: 'createGame',
+        title: 'Create Game',
+        description: 'Creates a game',
+        inputSchema: {
+            shape: {
+                name: { type: 'string' },
+            },
+        },
+        execute: executeOk,
+        formatResult: formatOk,
+    },
+    {
+        name: 'uploadVersion',
+        title: 'Upload Version',
+        description: 'Uploads a version',
+        inputSchema: {
+            shape: {
+                gameId: { type: 'string' },
+            },
+        },
+        execute: executeError,
+        formatResult: formatUnused,
+    },
+];
+describe('registerAllTools()', () => {
+    it('registers each tool and formats successful executions', async () => {
+        const registrations = [];
+        const server = {
+            registerTool: mock((name, metadata, handler) => {
+                registrations.push({ name, metadata, handler });
+            }),
+        };
+        registerAllTools(server, toolDefs);
+        expect(server.registerTool).toHaveBeenCalledTimes(2);
+        expect(registrations[0]?.name).toBe('createGame');
+        expect(registrations[0]?.metadata).toEqual({
+            title: 'Create Game',
+            description: 'Creates a game',
+            inputSchema: {
+                name: { type: 'string' },
+            },
+        });
+        const registration = registrations[0];
+        expect(registration).toBeDefined();
+        if (!registration)
+            throw new Error('Missing createGame registration');
+        const result = await registration.handler({ name: 'Test Game' });
+        expect(executeOk).toHaveBeenCalledWith({ name: 'Test Game' });
+        expect(formatOk).toHaveBeenCalledWith({ gameId: 'game-1' });
+        expect(result).toEqual({
+            content: [{ type: 'text', text: 'formatted success' }],
+        });
+    });
+    it('returns MCP error payloads when tool execution throws', async () => {
+        const registrations = [];
+        const server = {
+            registerTool: mock((_name, _metadata, handler) => {
+                registrations.push({ handler });
+            }),
+        };
+        registerAllTools(server, toolDefs);
+        const registration = registrations[1];
+        expect(registration).toBeDefined();
+        if (!registration)
+            throw new Error('Missing uploadVersion registration');
+        const result = await registration.handler({ gameId: 'game-1' });
+        expect(executeError).toHaveBeenCalledWith({ gameId: 'game-1' });
+        expect(formatUnused).not.toHaveBeenCalled();
+        expect(result).toEqual({
+            content: [{ type: 'text', text: 'boom' }],
+            isError: true,
+        });
+    });
+});
+//# sourceMappingURL=register.test.js.map

package/dist/server/tools/register.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.test.js","sourceRoot":"","sources":["../../../src/server/tools/register.test.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/**
+ * Configuration schema for Remix MCP
+ */
+export declare const ConfigSchema: z.ZodObject<{
+    gameId: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type Config = z.infer<typeof ConfigSchema>;
+/**
+ * Schema for set_config tool input
+ */
+export declare const SetConfigInputSchema: z.ZodObject<{
+    gameId: z.ZodOptional<z.ZodString>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    apiUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type SetConfigInput = z.infer<typeof SetConfigInputSchema>;
+/**
+ * Schema for upload_version tool input
+ */
+export declare const UploadVersionInputSchema: z.ZodObject<{
+    codePath: z.ZodString;
+}, z.core.$strip>;
+export type UploadVersionInput = z.infer<typeof UploadVersionInputSchema>;
+/**
+ * Game object returned from API
+ */
+export interface Game {
+    id: string;
+    name: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * API response when listing games
+ */
+export interface ListGamesResponse {
+    success: boolean;
+    games?: Game[];
+    error?: string;
+}
+/**
+ * Schema for create_game tool input
+ */
+export declare const CreateGameInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    codePath: z.ZodString;
+}, z.core.$strip>;
+export type CreateGameInput = z.infer<typeof CreateGameInputSchema>;
+/**
+ * API response when creating a game
+ */
+export interface CreateGameResponse {
+    success: boolean;
+    game?: Game;
+    error?: string;
+}
+/**
+ * API response when creating a game version
+ */
+export interface UploadVersionResponse {
+    success: boolean;
+    version?: {
+        id: string;
+        title: string;
+        createdAt: Date;
+    };
+    error?: string;
+    details?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,YAAY;;;;iBAIvB,CAAA;AAEF,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;iBAI/B,CAAA;AAEF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;iBAEnC,CAAA;AAEF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAEzE;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB;;;iBAGhC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEnE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,IAAI,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE;QACR,EAAE,EAAE,MAAM,CAAA;QACV,KAAK,EAAE,MAAM,CAAA;QACb,SAAS,EAAE,IAAI,CAAA;KAChB,CAAA;IACD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/types.js

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+/**
+ * Configuration schema for Remix MCP
+ */
+export const ConfigSchema = z.object({
+    gameId: z.string().optional(),
+    apiKey: z.string().optional(),
+    apiUrl: z.string().url().optional(),
+});
+/**
+ * Schema for set_config tool input
+ */
+export const SetConfigInputSchema = z.object({
+    gameId: z.string().optional().describe('The game ID to upload versions for'),
+    apiKey: z.string().optional().describe('API key for authentication'),
+    apiUrl: z.string().url().optional().describe('API URL (defaults to https://remix.gg)'),
+});
+/**
+ * Schema for upload_version tool input
+ */
+export const UploadVersionInputSchema = z.object({
+    codePath: z.string().describe('Path to the game code file to upload'),
+});
+/**
+ * Schema for create_game tool input
+ */
+export const CreateGameInputSchema = z.object({
+    name: z.string().describe('Name of the game to create'),
+    codePath: z.string().describe('Path to the game code file'),
+});
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC,CAAA;AAIF;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;IAC5E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACpE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;CACvF,CAAC,CAAA;AAIF;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CACtE,CAAC,CAAA;AAuBF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;CAC5D,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@remix-gg/mcp",
+  "version": "0.4.3",
+  "description": "MCP server + skills for building remix HTML games",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": ["dist", "skills", "README.md"],
+  "exports": {
+    ".": "./dist/client-helpers/index.js",
+    "./core": "./dist/core/index.js",
+    "./server": "./dist/server/index.js",
+    "./skills": "./skills/"
+  },
+  "bin": {
+    "remix-mcp": "./dist/server/index.js"
+  },
+  "scripts": {
+    "generate:server-api-sdk": "bun run scripts/generate-server-api-sdk.ts",
+    "prepublishOnly": "tsc",
+    "build": "tsc",
+    "test": "bun test src",
+    "dev": "tsx --watch src/server/index.ts",
+    "start": "node dist/server/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.26.0",
+    "openapi-fetch": "0.17.0",
+    "zod": "^4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "openapi-typescript": "7.13.0",
+    "tsx": "^4.21.0",
+    "typescript": "5.8.3"
+  }
+}

package/skills/SKILL.md

@@ -0,0 +1,82 @@
+# Remix Platform — Agent Skills
+
+You are an agent working with the Remix Platform. This document provides
+the master overview of how to build, validate, and publish HTML games.
+
+## Authentication
+
+This server requires a Remix API key via the `REMIX_API_KEY` environment variable.
+Keys can be obtained from https://remix.gg.
+
+## Game Settings
+
+Game IDs are persisted in a `.remix-settings.json` file in the project root.
+
+**CRITICAL:** Before calling `createGame` or any tool that requires `gameId`
+or `versionId`, you MUST read this file to check for existing values. If it
+contains `gameId` and `versionId`, **do NOT call `createGame`** — use the
+existing IDs. Calling `createGame` when IDs already exist creates a duplicate.
+
+After calling `createGame` (only when no IDs exist), write the returned IDs
+(and game name) back to `.remix-settings.json` so they persist across sessions.
+
+```json
+{
+  "gameId": "uuid-here",
+  "versionId": "uuid-here",
+  "name": "My Game"
+}
+```
+
+## Available Tools
+
+- **validateGame** — Validates an HTML game file for common issues (missing
+  DOCTYPE, viewport, inline handlers, infinite loops). Takes a `filePath` — do
+  NOT read the game file yourself. Call this before uploading.
+- **createGame** — Creates a new game on the Remix platform. Takes a `name`,
+  returns the game ID and version ID needed for subsequent tool calls.
+- **uploadVersion** — Uploads an HTML game file to an existing game version.
+  Requires `gameId` and `versionId` from createGame. Takes a `filePath` — do
+  NOT read the game file yourself.
+- **generateImage** — Generates an AI image from a text prompt. Returns base64
+  image data as an MCP image content block.
+- **uploadGameAsset** — Uploads a local file as a game asset. Takes a
+  `filePath`, returns JSON with the hosted asset URL.
+- **listShopItems** — Lists the current shop items for a game.
+- **createShopItem** — Creates a Bits shop item for a game.
+  Use this for consumables, one-time unlocks, and tier unlock items. When
+  `iconUrl` is omitted for `CONSUMABLE` or `ONE_TIME`, the tool auto-generates
+  and uploads a shop icon.
+- **updateShopItem** — Updates an existing shop item.
+- **deleteShopItem** — Deletes or deactivates an existing shop item.
+- **updateGame** — Updates game settings (name, multiplayer flag). Takes a
+  `gameId` and optional `name` and `isMultiplayer` fields.
+
+## Available Workflows
+
+- **game-creation** — How to create a new game from scratch
+- **upload-game** — How to validate and upload a game to the Remix platform
+- **integrate-save-game** — How to persist and restore game state across sessions
+- **add-image-to-game** — How to generate, upload, and integrate images into a game
+- **manage-shop-items** — How to create, list, update, delete, and consume shop items
+- **implement-multiplayer** — How to integrate turn-based multiplayer into a game
+
+## Available Actions
+
+- **open-game** — Open a game in the Remix Studio for preview
+
+## How to Use
+
+**Always load the appropriate workflow or action skill before taking action.**
+Each skill contains the exact steps, tool calls, and validation checks needed.
+Do not act on general knowledge — follow the skill instructions.
+
+1. Identify which workflow or action matches the task (see "Available Workflows"
+   and "Available Actions" above).
+2. Load it via the `getSkill` resource (e.g. `skills://upload-game`,
+   `skills://open-game`).
+3. Follow its step-by-step instructions exactly.
+
+If you're unsure which skill to use, start with **game-creation** for
+building games, **upload-game** for deploying them, or **open-game** for
+previewing them in the Remix Studio.

package/skills/actions/open-game.md

@@ -0,0 +1,18 @@
+# Open Game in Remix Studio
+
+Open the current game in the Remix Studio for preview and editing.
+
+## Steps
+
+1. **Read game settings** from `.remix-settings.json` in the project root.
+   Extract `gameId` and `versionId`. If either is missing, tell the user
+   they need to create/upload a game first.
+
+2. **Construct the Studio URL:**
+   ```
+   https://remix.gg/games/{gameId}/v/{versionId}
+   ```
+
+3. **Open in the user's default browser:**
+   - macOS: `open <url>`
+   - Linux: `xdg-open <url>`