Board Mcp

Board SDK MCP Server

MCP server that gives AI assistants structured access to the Board SDK (fun.board v3.2.1) for Unity game development. Instead of hallucinating SDK APIs, your AI generates correct C# code with proper platform guards, async patterns, and caveats — on the first attempt.

When Unity Editor is running with MCP for Unity, this server automatically discovers and proxies Unity's tools and resources too — one MCP server for both Board SDK knowledge and live Unity Editor control.

What's included

- 25 tools across 4 SDK domains (Input, Session, Save Game, Application)
- 7 piece sets — full catalog of physical game piece models (arcade, chop_chop, mushka, omakase, save_the_bloogs, thrasos_arcade, and the combined chop_chop_mushka set)
- 8 resources with type schemas, piece set catalog, changelog, error catalog, and platform guard reference
- Unity Editor integration — automatically proxies Unity MCP tools/resources when Unity is running
- Every tool response includes: API signature, complete C# code example, parameter docs, caveats, and related tools

Install

npx board-sdk-mcp-server

No build step, no cloning. Just add the config below to your AI agent and it runs automatically.

Prerequisites

- Node.js 20+

---

Adding to your AI agent

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "board-sdk": {
      "command": "npx",
      "args": ["-y", "board-sdk-mcp-server"]
    }
  }
}

Restart Claude Desktop. You'll see the Board SDK tools appear in the tool picker (hammer icon).

Cursor

Create or edit .cursor/mcp.json in your project root:

{
  "mcpServers": {
    "board-sdk": {
      "command": "npx",
      "args": ["-y", "board-sdk-mcp-server"]
    }
  }
}

Restart Cursor. The Board SDK tools will be available to the agent in Composer.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "board-sdk": {
      "command": "npx",
      "args": ["-y", "board-sdk-mcp-server"]
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings.json or .vscode/mcp.json:

{
  "mcp": {
    "servers": {
      "board-sdk": {
        "command": "npx",
        "args": ["-y", "board-sdk-mcp-server"]
      }
    }
  }
}

Claude Code (CLI)

claude mcp add board-sdk -- npx -y board-sdk-mcp-server

From source (development)

git clone <repo-url> && cd BoardMCP
npm install
npm run build

Then use "command": "node", "args": ["/path/to/BoardMCP/dist/index.js"] in any config above.

---

Verifying it works

After adding the server to your agent, ask it something like:

> "How do I detect physical piece contacts on a Board?"

The agent should call board_input_get_contacts and return a structured response with a complete C# code example, platform guards, and caveats — not a generic guess.

Other good test prompts:

| Prompt | Expected tools called |
| -------------------------------------- | --------------------------------------------------------- |
| "Set up save games with cover images" | board_save_create, board_save_cover_image |
| "Add a second player to the session" | board_session_add_player, board_session_player_types |
| "Why are my contacts returning empty?" | board_input_get_contacts, board_input_simulator_setup |
| "What piece sets are available?" | board_input_list_piece_sets |
| "Set up Chop Chop piece detection" | board_input_glyph_setup, board_input_list_piece_sets |
| "Configure the pause screen" | board_app_pause_screen, board_app_pause_events |
| "What's the max save file size?" | board_save_storage_info |

Available tools

Input (board_input_)

Session (board_session_)

| Tool | What it returns |
| ------------------------------ | ------------------------------------------------------- |
| board_session_get_players | Player roster access and playersChanged event pattern |
| board_session_add_player | PresentAddPlayerSelector() with async/await pattern |
| board_session_replace_player | PresentReplacePlayerSelector() with IL2CPP notes |
| board_session_reset_players | ResetPlayers() for returning to initial state |
| board_session_player_types | BoardPlayerType (Profile vs Guest) explanation |
| board_session_active_profile | activeProfile vs players[] distinction |

Save Game (board_save_)

Application (board_app_)

| Tool | What it returns |
| ---------------------------- | --------------------------------------------------------- |
| board_app_pause_screen | SetPauseScreenContext() vs UpdatePauseScreenContext() |
| board_app_profile_switcher | Profile switcher overlay visibility control |
| board_app_exit | Clean exit with platform behavior differences |
| board_app_pause_events | Pause screen event subscription pattern |

Board pieces

Board games use physical game pieces (called "glyphs") that are recognized by the Board's built-in camera. Each game has its own piece set — a TensorFlow Lite recognition model that maps physical pieces to unique glyphId integers.

Available piece sets

…