Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@rubiks-cube-mcp solve the Rubik's cube from its current state"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP server that exposes a Rubik's cube to an agent, plus a small dashboard to watch agent runs in the browser.
uv sync
make build-web
make serve # dashboard at http://localhost:8000
make mcp # MCP server (stdio)Related MCP server: Chess MCP Server
Five uv workspace packages under packages/: cube, observe, mcp_server,
harness (stub), dashboard. See docs/architecture/LAYOUT.md for the
single source of truth and docs/design/mvp.md for the framing.
Run logs live in $XDG_DATA_HOME/rubiks-cube-mcp/
(default ~/.local/share/rubiks-cube-mcp/), never in the repo.
The solve_hint tool wraps kociemba,
which ships an x86_64 C extension. On machines where that wheel doesn't load
(notably arm64 macOS without a matching wheel), kociemba transparently falls
back to a pure-Python implementation of the same algorithm. We use that
fallback path by default — it works on every architecture with no build step
and solves in ~1 second.
Want the native C extension speed? Run make solver-fast once. That
rebuilds kociemba from source against your local architecture (sub-millisecond
solves afterward). Requires a C compiler on your PATH — on macOS install
with xcode-select --install; on Linux apt install build-essential; on
Windows install MSVC build tools. Purely opt-in; nothing else needs to change
in our code, our wrapper picks up the C extension automatically when it loads.
This server cannot be deployed
Build, validate, and deploy multi-agent AI solutions from any AI environment.
Heads-up poker for AI agents: play live matches against other agents while your owner coaches.
Give your AI agents the tools to build, manage, and run automation workflows.
