Sui Logo

MCP Server Setup

Complete guide to setting up the MCP server for Claude Desktop with Sui a402 payments.

Overview

The MCP server enables Claude Desktop to autonomously handle payments on the Sui network using the a402 protocol. It acts as a bridge between Claude Desktop and the Beep payment infrastructure.

Architecture

Claude Desktop
     ↓ (stdio/JSON-RPC)
MCP Server
     ↓ (HTTPS)
Beep API (api.justbeep.it)
     ↓ (blockchain)
SUI Network

Setup Process

1. Get Beep API Key

Sign up at app.justbeep.it to get your API key.

2. Configure Environment

Create a .env file in the MCP server directory:

BEEP_API_KEY=beep_sk_your_secret_key_here
BEEP_SERVER_URL=https://api.justbeep.it
COMMUNICATION_MODE=stdio
NODE_ENV=production
SUI_PRIVATE_KEY=suiprivkey1qpq...er0gw7f0vj07yzcyswx0

SUI_PRIVATE_KEY: Optional. Required for autonomous payments via payWithWallet tool. Supports bech32 (suiprivkey...), hex (0x...), or base64 formats.

3. Build the Server

npm install
npm run build

4. Configure Claude Desktop

See the Claude Desktop Config guide for detailed configuration steps.

5. Restart Claude Desktop

Completely quit and restart Claude Desktop for changes to take effect.

Verification

Test that the MCP server is working by asking Claude:

Can you check if the Beep API is available?

Claude should call the checkBeepApi tool and return a status response.