beeper-mcp
About
A backend service for executing beeper transactions on Binance Smart Chain
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
beeper-mcpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- 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
git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
{
"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>"
}
}
}
}
```
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"beeper-mcp": {
"beeper-mcp": {
"command": "uv",
"args": [
"run",
"src/beeper_mcp/server.py"
]
}
}
}
}McpServers
{
"beeper-mcp": {
"command": "uv",
"args": [
"run",
"src/beeper_mcp/server.py"
]
}
}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 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 BNB balance of an address
- get_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 address
- transfer_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 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: Decimal = 0.01) -> dict: Sell tokens for BNB
Reward Operations
-claim_rewards(token_address: str) -> dict: Claim rewards for a token
Running the Service
```bash
git clone https://github.com/unibaseio/beeper-mcp.git
cd beeper-mcp
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
