beeper-mcp is a backend service that executes beeper transactions on Binance Smart Chain (BSC), developed by intentos-labs. The service provides a set of tools for interacting with the BSC blockchain, including balance checks, balance transfers, token transfers, PancakeSwap token swaps, and beeper reward claiming.
Purpose
beeper-mcp is designed to provide an interface for transaction operations on the BSC blockchain, supporting users in executing common on-chain operations through MCP tools, such as querying balances, transferring funds, trading, and claiming rewards.
Main Capabilities
According to official information, the service provides 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 the specified address
- get_token_balance(address: str, token_address: str) -> str: Get the token balance of the specified address
Transfer Operations
- transfer(recipient_address: str, amount: Decimal = 0.01) -> dict: Transfer BNB to the specified address
- transfer_token(recipient_address: str, token_address: str, amount: Decimal = 0.01) -> dict: Transfer tokens to the specified address
Trading Operations
- swap_token(token_in: str, token_out: str, amount: Decimal = 0.01) -> dict: Swap between tokens
- get_token_price(token_address: str) -> float: Get the tokenprice denominated in BNB
- buy_token(token_address: str, amount: Decimal = 0.01) -> dict: Buy tokens using 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 the specified token
Usage
The service requires access to the BSC network (mainnet or testnet), and requires a wallet account and private key. Users need to create a .env file in the project root directory to configure environment variables.
The service can be started via sse, with a default port of 8000, and the --port parameter can be used to specify another port. The service supports configuration in tools such as Claude, Windsurf, Cursor, and Cline. All amounts are expressed in native units (e.g., BNB, tokens), and token addresses must be provided in the correct format. Users need to ensure they have enough BNB to pay gas fees.
Applicable Scenarios
This service is suitable for scenarios that require executing transaction operations on BSC, such as querying balances, transferring funds, swapping tokens on PancakeSwap, buying and selling tokens, and claiming beeper rewards. Users can call these functions in LLM chats, for example, to view the wallet and buy tokens.
Limitations
The information does not provide specific details about fees, pricing, platform restrictions, or other unmentioned information. All operations return a detailed response object containing the transaction hash and status information, and the service has built-in error handling and transaction status tracking.
