Bloctopus MCP

The instructions in this guide will walk you through installing the latest version of the Bloctopus MCP.

I. Install & Start Docker

1. If you don't already have Docker installed, follow the instructions here to install the Docker application specific to your machine (e.g. Apple Intel, Apple M1, etc.).

2. Start the Docker daemon (e.g. open Docker Desktop)

3. Verify that Docker is running:

   docker image ls

II. Install Kurtosis

1. If you don't already have Kurtosis installed, follow the instructions here to install it.
2. Start the Kurtosis engine using kurtosis engine start

III. Install the Bloctopus MCP

Choose the package manager that matches your environment:

Homebrew (macOS)

brew install 0xbloctopus/tap/blocmcp

info

Homebrew might warn you that your Xcode is outdated or missing entirely. This is a Homebrew requirement, and has nothing to do with Kurtosis (which ships as prebuilt binaries).

To install or update your Xcode, run:

xcode-select --install

apt (Ubuntu)

curl -1sLf 'https://dl.cloudsmith.io/public/bloctopus/blocmcp/setup.deb.sh' | sudo -E bash && sudo apt-get install blocmcp

yum (RHEL)

curl -1sLf 'https://dl.cloudsmith.io/public/bloctopus/blocmcp/setup.rpm.sh' | sudo -E bash && sudo yum install blocmcp

IV. Keep Bloctopus MCP Up to Date

Use the matching package manager to upgrade to the latest release whenever a new version ships:

Homebrew (macOS)

brew update && brew upgrade 0xbloctopus/tap/blocmcp

apt (Ubuntu)

sudo apt-get update && sudo apt-get install --only-upgrade blocmcp

yum (RHEL)

sudo yum update blocmcp

V. Add Bloctopus MCP to Your Agent

Before connecting the MCP to an agent, create an API key in the Bloctopus platform and note both the key and secret.

Cursor

1. Press Cmd + Shift + J to open Cursor settings.
2. Select Tools & Integrations.
3. Click New MCP Server.
4. Add the entry below to your configuration.

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "BloctopusMCP": {
      "type": "stdio",
      "command": "blocmcp",
      "args": ["serve"],
      "env": {"BLOCTOPUS_API_KEY": "<API_KEY>", "BLOCTOPUS_API_SECRET": "<API_SECRET>"}
    }
  }
}

VS Code

1. Open VS Code settings.
2. Search for “MCP”.
3. Add a new MCP server configuration.
4. Restart VS Code to load the server.

Config file: ~/.vscode/mcp.json

{
  "servers": {
    "BloctopusMCP": {
      "type": "stdio",
      "command": "blocmcp",
      "args": ["serve"],
      "env": {"BLOCTOPUS_API_KEY": "<API_KEY>", "BLOCTOPUS_API_SECRET": "<API_SECRET>"}
    }
  }
}

Claude Desktop

1. Open Claude Desktop settings.
2. Select Developer.
3. Choose Edit Config.
4. Append the server definition below.

Config file: claude_desktop_config.json

{
  "mcpServers": {
    "BloctopusMCP": {
      "command": "blocmcp",
      "args": ["serve"],
      "env": {
        "BLOCTOPUS_API_KEY": "<API_KEY>",
        "BLOCTOPUS_API_SECRET": "<API_SECRET>"
      }
    }
  }
}

Claude Code

Command:

claude mcp add -t stdio BloctopusMCP blocmcp serve --env BLOCTOPUS_API_KEY=<API_KEY> --env BLOCTOPUS_API_SECRET=<API_SECRET>

Windsurf

1. Press Cmd + , to open Windsurf settings.
2. Go to MCP Servers.
3. Choose Manage MCP servers > View raw config.
4. Merge in the snippet below.

Config file: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "BloctopusMCP": {
      "command": "blocmcp",
      "args": ["serve"],
      "env": {
        "BLOCTOPUS_API_KEY": "<API_KEY>",
        "BLOCTOPUS_API_SECRET": "<API_SECRET>"
      }
    }
  }
}

Gemini CLI

1. Open your Gemini CLI settings file.
2. Add a Bloctopus MCP server entry.
3. Set the environment variables shown below.
4. Restart the CLI.

Config file: ~/.gemini/settings.json

{
  "mcpServers": {
    "BloctopusMCP": {
      "command": "blocmcp",
      "args": ["serve"],
      "env": {
        "BLOCTOPUS_API_KEY": "<API_KEY>",
        "BLOCTOPUS_API_SECRET": "<API_SECRET>"
      }
    }
  }
}

Codex

Command:

codex mcp add BloctopusMCP --env BLOCTOPUS_API_KEY=<API_KEY> --env BLOCTOPUS_API_SECRET=<API_SECRET> -- blocmcp serve