Board Mcp

What is Board Mcp?

Board Mcp is an MCP server that gives AI assistants structured access to the Board SDK (fun.board v3.2.1) for Unity game development, replacing hallucinated API guesses with correct C# code including platform guards, async patterns, and caveats. When Unity Editor is running with the MCP for Unity package, the server automatically discovers and proxies Unity's tools and resources as well, making it a single MCP server for both Board SDK knowledge and live Unity Editor control.

How to use Board Mcp?

Install with npx board-sdk-mcp-server (requires Node.js 20+). Add the server configuration to your AI agent (Claude Desktop, Cursor, Windsurf, VS Code Copilot, or Claude Code) using the command: "npx" and args: ["-y", "board-sdk-mcp-server"] pattern. No build step or cloning is needed.

Key features of Board Mcp

• 25 tools across 4 SDK domains (Input, Session, Save Game, Application)
• 7 physical game piece set catalogs with model files and versions
• 8 resources providing type schemas, changelog, error catalog, and platform guard references
• Auto-proxies Unity Editor MCP tools when Unity is running with the MCP bridge
• Every tool response includes API signature, complete C# code example, parameter docs, caveats, and related tools
• Unity integration requires no extra configuration beyond installing the MCP for Unity package

Use cases of Board Mcp

• Generate correct C# code for Board SDK APIs with proper platform guards and async patterns
• Configure physical game piece detection by listing available piece sets and setting up glyph models
• Manage save game operations including creation, cover image loading, and storage limit queries
• Control the live Unity Editor through proxied MCP tools from the same server
• Access SDK documentation, error catalogs, and platform guard references on demand

FAQ from Board Mcp

What does Board Mcp do that alternatives don't?

Instead of hallucinating SDK APIs, Board Mcp generates correct C# code with proper platform guards, async patterns, and caveats on the first attempt.

What are the runtime requirements?

Node.js 20+ is required. Unity integration requires the MCP for Unity package installed in the Unity project and the bridge started from Window > MCP for Unity.

Where does data live and what are the storage limits?

Board Mcp provides SDK documentation and piece set metadata locally. The Board SDK save system has a 16 MB payload limit and 64 MB total storage per game.

Are there any known limits?

Only one physical piece set can be active at a time. To recognize pieces from multiple games simultaneously, a combined piece set (e.g., chop_chop_mushka) must be used.

What transports or auth does it use?

The server communicates via STDIO (standard MCP transport for AI agents). Unity integration uses HTTP to http://127.0.0.1:8090/mcp and can be disabled by setting UNITY_MCP_ENABLED=false. No authentication is required.