Getting Started

MagicBlock Console provides three ways to manage Ephemeral Rollups on Solana: a Web Dashboard, a CLI, and an MCP Server for AI-agent workflows. All three share the same Core SDK underneath.

Installation

Web Dashboard

No installation needed. Run npm run dev -w packages/web and open the dashboard to start managing your ERs.

CLI

npm install -g @magicblock-console/cli

Verify the installation:

mb-console --version

MCP Server

Add MagicBlock Console to your MCP client configuration:

{
  "mcpServers": {
    "magicblock-console": {
      "command": "npx",
      "args": ["@magicblock-console/mcp"]
    }
  }
}

Quick Start

1. Authentication

Web: Open the dashboard — the web interface runs in simulated mode by default. Wallet adapter integration is planned for production.

CLI: Set your Solana keypair path:

export MB_KEYPAIR_PATH=~/.config/solana/id.json

If no keypair is found, the CLI runs in simulated mode with realistic mock data.

MCP: Configure your keypair path in the MCP server settings:

{
  "mcpServers": {
    "magicblock-console": {
      "command": "npx",
      "args": ["@magicblock-console/mcp"],
      "env": {
        "MB_KEYPAIR_PATH": "~/.config/solana/id.json"
      }
    }
  }
}

2. Create a Project

A project is a logical group that holds your ER configuration, delegated accounts, and monitoring data.

Web: Dashboard → “New Project” → enter name and select region.

CLI:

mb-console project create my-game --region us

MCP:

“Create a new project called my-game in the US region”

3. Configure Features

Enable the features your application needs:

mb-console project configure my-game 
  --gasless 
  --vrf

Available features:

4. Delegate an Account

Delegating an account moves it from Solana to your Ephemeral Rollup for high-speed execution:

mb-console er delegate <ACCOUNT_ADDRESS> --project my-game

The account is now running on the ER. Transactions execute with near-instant finality and zero fees (if gasless is enabled).

5. Monitor

mb-console monitor status --project my-game

This shows a project status overview including:

• ER status and uptime
• Delegated accounts
• Transaction throughput
• Cost accumulation

Regions

MagicBlock operates ER validators in three regions:

Choose the region closest to your users for optimal performance.

Network

MagicBlock Console operates on Solana Devnet by default. All transactions, delegations, and ER operations use devnet SOL.

Next Steps

• ER Lifecycle — understand delegation, execution, and commits
• Gasless Transactions — zero-fee execution
• Privacy Mode — confidential state with TEE
• CLI Reference — full command reference
• MCP Reference — AI-agent tool reference