beeper-mcp
About
A backend service for executing beeper transactions on Binance Smart Chain
Details
- Author
- intentos-labs
- GitHub stars
- 3
- Downloads
- 196
- Categories
- Other
Jump to
- Get BNB and token balances from any address
- Transfer BNB and tokens to a recipient
- Swap tokens via Pancakeswap
- Fetch token prices in BNB
- Buy and sell tokens using BNB
- Claim beeper token rewards
- 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
Clone the repository, set up a .env file with BEEPER_CHAIN, BEEPER_ACCOUNT, BEEPER_SECRET_KEY, and optionally BEEPER_TARGET_TOKEN, then run uv run src/beeper_mcp/server.py over stdio or with --transport=sse on a configurable port (default 8000). Configure it in Claude, Windsurf, Cursor, or Cline using the MCP server JSON block with the same environment variables.
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"
]
}
}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 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.
