beeper-mcp

A backend service for executing beeper transactions on Binance Smart Chain (BSC). This service provides a set of tools for interacting with the BSC blockchain, including balance checking, balance transfers, token transfers, token swaps in Pancakeswap and beeper reward claims.

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

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

Create a .env file in the project root 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

The service exposes the following MCP tools:

• 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

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

• 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

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