beeper-mcp
Automated beeper transactions and token operations on Binance Smart Chain
Key Features
Use Cases
README
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.
Features
- 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
Prerequisites
- Python >=3.10
- Access to BSC network (mainnet or testnet)
- Wallet account and private key
Environment Variables
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
API Endpoints
The service exposes the following MCP tools:
Wallet and Token Management
get_default_wallet_address() -> str: Get the default wallet addressget_default_token_address() -> str: Get the default token addressswitch_default_token_address(new_token_address: str) -> str: Switch to a new default token address
Balance Operations
get_balance(address: str) -> str: Get BNB balance of an addressget_token_balance(address: str, token_address: str) -> str: Get token balance of an address
Transfer Operations
transfer(recipient_address: str, amount: Decimal = 0.01) -> dict: Transfer BNB to an addresstransfer_token(recipient_address: str, token_address: str, amount: Decimal = 0.01) -> dict: Transfer tokens to an address
Trading Operations
swap_token(token_in: str, token_out: str, amount: Decimal = 0.01) -> dict: Swap between tokensget_token_price(token_address: str) -> float: Get token price in BNBbuy_token(token_address: str, amount: Decimal = 0.01) -> dict: Buy tokens with BNBsell_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 token
Running the Service
git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
# start server over stdio
uv run src/beeper_mcp/server.py
- start using sse
The sse service will start on port 8000 by default. You can specify a different port using the --port argument:
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>"
}
}
}
}
Notes
- All amounts are in native units (e.g., BNB, tokens)
- Token addresses should be provided in the correct format
- Make sure you have sufficient BNB for gas fees
- The service supports both BSC mainnet and testnet
- All operations return detailed response objects with transaction hashes and status information
- The service includes built-in error handling and status tracking for transactions
Usage
call functions in llm chat
- show wallet and buy tokens
- sell tokens
Star History
Repository Owner
Organization
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
Wallet Inspector MCP
Empowering AI agents to inspect wallet balances and onchain activity across multiple blockchains.
Wallet Inspector MCP is an MCP server that enables AI agents to query wallet balances and view onchain activity on major EVM chains as well as the Solana blockchain. It supports flexible output formats, multi-chain querying, and is designed for integration with MCP-compatible clients such as Claude Desktop CLI. The tool facilitates secure, natural language interactions to check balances, activities, and transaction histories for any supported wallet address.
- ⭐ 7
- MCP
- kukapay/wallet-inspector-mcp
Binance Alpha MCP
Real-time Binance Alpha trade monitoring and analytics for AI agents
Binance Alpha MCP is an MCP server designed to track Binance Alpha trades and assist AI agents in accumulating alpha points more effectively. It monitors buy-side activity on Binance Alpha tokens, calculates USD-based metrics using real-time price feeds, and provides data persistence with automatic cleanup. The server exposes standardized MCP tools for fetching top tokens by trading volume and trade statistics, facilitating seamless integration with model context client platforms.
- ⭐ 8
- MCP
- kukapay/binance-alpha-mcp
Uniswap Trader MCP
Automate token swaps on Uniswap across multiple blockchains for AI agents.
Uniswap Trader MCP provides an MCP server interface enabling AI agents to automate token swaps on Uniswap V3 across several EVM-compatible blockchains. It offers real-time price quoting, optimized trade route suggestions, and direct execution of swaps with configurable slippage and deadlines. Multi-chain support allows seamless integration with networks such as Ethereum, Polygon, Arbitrum, and others for robust DeFi trading automation.
- ⭐ 34
- MCP
- kukapay/uniswap-trader-mcp
Crypto Portfolio MCP
Real-time crypto portfolio management and analysis via MCP.
Crypto Portfolio MCP is an MCP server that enables users and AI agents to track, manage, and optimize cryptocurrency portfolio allocations with live Binance price integration. It allows querying of portfolio status, addition of holdings, price fetching, value history chart generation, and portfolio analysis suggestions. The server provides persistent storage using SQLite and exposes API-like tools for seamless interaction through an MCP client. Designed for integration with platforms like Claude Desktop, it facilitates dynamic crypto asset management and insight generation.
- ⭐ 9
- MCP
- kukapay/crypto-portfolio-mcp
Freqtrade-MCP
MCP server bridge for Freqtrade automated crypto trading bots
Freqtrade-MCP acts as a Model Context Protocol (MCP) server that connects AI agents to the Freqtrade cryptocurrency trading bot via its REST API. It exposes Freqtrade operations as standardized MCP tools, enabling automated trading workflows through programmatic access. The system ensures AI agents can manage market data, trigger trades, and monitor performance in a uniform context protocol environment. It supports secure and configurable deployment with support for relevant API endpoints.
- ⭐ 92
- MCP
- kukapay/freqtrade-mcp
Crypto Liquidations MCP
Streams real-time Binance liquidation events to AI agents via MCP.
Crypto Liquidations MCP is an MCP server that streams real-time cryptocurrency liquidation events from Binance. It provides tools for retrieving the latest liquidations in a user-friendly Markdown table and generates prompts for AI agents to analyze market trends. The server maintains an in-memory record of up to 1000 recent events and is designed for easy integration with MCP clients such as Claude Desktop.
- ⭐ 3
- MCP
- kukapay/crypto-liquidations-mcp
Didn't find tool you were looking for?