Sui Logo

Quick Start

Get up and running with Sui a402 in minutes. This guide will help you set up the MCP server for Claude Desktop and start accepting payments on the Sui network.

Prerequisites

  • Node.js >= 20
  • Claude Desktop (latest version)
  • Beep API key from app.justbeep.it
  • SUI wallet for testing payments

Installation Steps

1. Install Dependencies

npm install

2. Build the Server

npm run build

3. Configure Environment

Create a .env file:

cp env.example .env

Edit .env and add your Beep API key and optional SUI private key:

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

Note: SUI_PRIVATE_KEY is optional. Required only for autonomous payments (payWithWallet tool). Supports bech32, hex (0x...), or base64 formats.

Next Steps

After installation, configure Claude Desktop. See the Claude Desktop Config guide for detailed instructions.