Open the desktop version of Blockbench, go to File > Plugins and click the "Load Plugin from URL" and paste in this URL:
https://jasonjgardner.github.io/blockbench-mcp-plugin/mcp.js
Configure the MCP server under Blockbench settings: Settings > General > MCP Server Port and MCP Server Endpoint. The same section holds Enable AI Scratchpad (adds an ai_scratchpad mode that lifts the format's cube size, rotation, and integer-size guardrails while selected) and Disclose AI Usage (stamps ai_used and ai_agents onto projects that MCP tools modify or create).
The following examples use the default values of :3000/bb-mcp
npx mcp-add --type http --url "http://localhost:3000/bb-mcp" --scope project.vscode/mcp.json
{
"servers": {
"blockbench": {
"url": "http://localhost:3000/bb-mcp",
"type": "http"
}
}
}claude_desktop_config.json (macOS/Linux)
{
"mcpServers": {
"blockbench": {
"command": "npx",
"args": ["-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
}
}
}claude_desktop_config.json (Windows)
{
"mcpServers": {
"blockbench": {
"command": "cmd",
"args": ["/c", "npx", "-y", "mcp-remote", "http://localhost:3000/bb-mcp"]
}
}
}claude mcp add blockbench --transport http http://localhost:3000/bb-mcpcodex plugin marketplace add jasonjgardner/blockbench-mcp-project --ref codex
codex plugin add blockbench-mcp@blockbench-mcp-project{
"mcpServers": {
"blockbench": {
"serverUrl": "http://localhost:3000/bb-mcp"
}
}
}
cline_mcp_settings.json
{
"mcpServers": {
"blockbench": {
"url": "http://localhost:3000/bb-mcp",
"type": "streamableHttp",
"disabled": false,
"autoApprove": []
}
}
}uvx ollmcp -u http://localhost:3000/bb-mcpRecommended: jonigl/mcp-client-for-ollama
opencode mcp add
See sample project for prompt examples.
Use Agent Skills to orchestrate tool usage.
See CONTRIBUTING.md for detailed instructions on setting up the development environment and how to add new tools, resources, and prompts.