Beeper-MCP is a server designed to facilitate interactions with the Binance Smart Chain (BSC) for AI models. It provides a suite of tools for managing cryptocurrency transactions, including checking balances, transferring BNB and tokens, and executing token swaps on PancakeSwap. This MCP solution empowers AI agents to engage with decentralized finance (DeFi) applications on BSC.

The service offers key functionalities such as retrieving token prices, buying and selling tokens, and claiming Beeper rewards. It seamlessly integrates with AI models through standard input/output or HTTP/SSE, allowing them to execute trades and manage digital assets programmatically. By handling the complexities of blockchain interaction, Beeper-MCP simplifies the development of AI-powered DeFi applications, enabling developers to focus on high-level logic and user experience. It supports both BSC mainnet and testnet, providing a flexible environment for development and deployment.

BSC Interaction Toolkit

The beeper-mcp provides a comprehensive toolkit for interacting with the Binance Smart Chain (BSC). It allows AI models to query balances, transfer BNB and tokens, and execute swaps on PancakeSwap. This functionality is crucial for AI agents that need to manage digital assets or participate in decentralized finance (DeFi) activities on the BSC network. For example, an AI-powered trading bot could use this toolkit to automatically rebalance a portfolio by swapping tokens based on market conditions. The toolkit abstracts away the complexities of interacting directly with the blockchain, providing a simplified interface for AI models to execute transactions securely and efficiently. This includes handling transaction signing, gas estimation, and error handling.

Token Management Automation

This feature automates the management of default wallet and token addresses, streamlining interactions with specific tokens on the BSC network. AI models can dynamically switch between different token addresses, enabling them to interact with various DeFi protocols or manage multiple token holdings. For instance, an AI-driven yield farming strategy could use this feature to automatically switch between different liquidity pools based on the highest yield opportunities. By managing default token addresses, the beeper-mcp simplifies the process of specifying token contracts for each transaction, reducing the risk of errors and improving the overall efficiency of AI-driven DeFi strategies. The switch_default_token_address function allows for seamless transitions between tokens, enhancing the flexibility of AI agents.

Beeper Reward Claiming

The beeper-mcp facilitates the claiming of beeper token rewards, enabling AI models to automatically collect earned rewards. This is particularly useful for AI agents participating in staking or liquidity mining programs that distribute rewards in beeper tokens. For example, an AI agent could be programmed to automatically claim rewards on a regular basis, maximizing returns and minimizing the risk of missed opportunities. The claim_rewards function simplifies the process of interacting with the reward contract, handling the necessary transaction signing and submission. This feature ensures that AI models can efficiently manage their reward earnings and reinvest them as needed.

Trading Operations on PancakeSwap

The beeper-mcp enables AI models to execute trading operations on PancakeSwap, a decentralized exchange on the BSC network. This includes swapping tokens, buying tokens with BNB, and selling tokens for BNB. This functionality is essential for AI-powered trading bots that need to automatically execute trades based on market conditions or algorithmic strategies. For example, an AI trading bot could use this feature to automatically buy tokens when the price drops below a certain threshold or sell tokens when the price reaches a target level. The swap_token, buy_token, and sell_token functions provide a simplified interface for interacting with the PancakeSwap exchange, handling the complexities of liquidity pools and slippage.

Technical Implementation

The beeper-mcp is implemented in Python and leverages the uv package for running the server. It uses environment variables for configuration, including the wallet address, private key, and default token address. The service exposes a set of API endpoints that can be accessed via standard input/output (stdio) or HTTP/SSE. The use of environment variables allows for easy configuration and deployment in different environments. The service includes built-in error handling and status tracking for transactions, providing detailed response objects with transaction hashes and status information. This ensures that AI models can reliably execute transactions and monitor their progress.