Beeper MCP 9iv

🚀 beeper-mcp

A backend service for executing beeper transactions on the Binance Smart Chain (BSC). This service provides a set of tools to interact with the BSC blockchain, including balance queries, BNB and token transfers, token swaps on Pancakeswap, and beeper reward claiming.

🚀 Quick Start

Prerequisites

• Python >=3.10
• Access to the BSC network (mainnet or testnet)
• Wallet address and private key

Environment Variables

Create a .env file in the project root directory with the following variables:

BEEPER_CHAIN=<bsc or bsc-testnet>
BEEPER_ACCOUNT=<your-wallet-address>
BEEPER_SECRET_KEY=<your-private-key>
BEEPER_TARGET_TOKEN=<default token address>  # Optional

Running the Service

git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
# Start the server via standard input and output
uv run src/beeper_mcp/server.py 

Running with sse

The sse service runs on port 8000 by default. You can specify a different port using the --port parameter:

uv run src/beeper_mcp/server.py --port 8008 --transport=sse

Configuration on Claude/Windsurf/Cursor/Cline

{
  "mcpServers": {
    "beeper": {
      "command": "uv",
      "args": [
        "--directory",
        "path/to/beeper-mcp",
        "run", 
        "src/beeper_mcp/server.py"
        ],
      "env": {
        "BEEPER_ACCOUNT": "your account, 0x...",
        "BEEPER_SECRET_KEY": "your private key or in .env",
        "BEEPER_TARGET_TOKEN": "default token address",
        "BEEPER_CHAIN": "chain type <bsc/bsc-testnet>"
      }
    }
  }
}

✨ Features

• Get BNB and token balances
• Transfer BNB and tokens
• Swap tokens on Pancakeswap
• Get token prices
• Buy and sell tokens
• Claim beeper token rewards
• Manage default wallet and token addresses

📚 Documentation

API Endpoints

The service exposes the following MCP tools:

Wallet and Token Management

• get_default_wallet_address() -> str: Get the default wallet address
• get_default_token_address() -> str: Get the default token address
• switch_default_token_address(new_token_address: str) -> str: Switch to a new default token address

Balance Operations

• get_balance(address: str) -> str: Get the BNB balance of an address
• get_token_balance(address: str, token_address: str) -> str: Get the token balance of an address

Transfer Operations

• transfer(recipient_address: str, amount: Decimal = 0.01) -> dict: Transfer BNB to an address
• transfer_token(recipient_address: str, token_address: str, amount: Decimal = 0.01) -> dict: Transfer tokens to an address

Transaction Operations

• swap_token(token_in: str, token_out: str, amount: Decimal = 0.01) -> dict: Swap tokens
• get_token_price(token_address: str) -> float: Get the token price (in BNB)
• buy_token(token_address: str, amount: Decimal = 0.01) -> dict: Buy tokens with BNB
• sell_token(token_address: str, amount: Decimal = 0.01) -> dict: Sell tokens for BNB

Reward Operations

• claim_rewards(token_address: str) -> dict: Claim rewards for a specified token

⚠️ Important Note

• All amount parameters use the Decimal type and are represented in the smallest unit (e.g., 0.01 BNB).
• By default, all transactions require manual confirmation.