bitget-wallet-mcp
mcp
MCP server for Bitget Wallet DEX aggregator — token info, swap quotes, calldata generation, and transaction submission across 10+ chains.
README.md
Bitget Wallet MCP Server
An MCP (Model Context Protocol) server that exposes Bitget Wallet ToB API as tools for AI agents.
Features
- Token Info — price, market cap, holders, social links
- Batch Price Query — multi-token lookup in one call
- K-line Data — candlestick data across multiple timeframes
- Transaction Stats — buy/sell volume and trader counts
- Rankings — top gainers and top losers
- Liquidity Pools — LP pool information
- Security Audit — honeypot detection, permission checks, blacklist analysis
- Swap Quote — best-route quotes for same-chain and cross-chain swaps
- Swap Calldata — generate unsigned transaction data for wallet signing
- Order Quote — cross-chain + gasless aware price quotes
- Order Create — create orders with unsigned tx/signature data
- Order Submit — submit signed transactions for an order
- Order Status — track order lifecycle (init → processing → success)
✨ Order Mode — Gasless & Cross-Chain Swaps
- Gasless Transactions (EIP-7702) — swap with zero native token balance; gas is deducted from the input token
- One-Step Cross-Chain — swap tokens across chains in a single order, no manual bridging
- Supported on all EVM chains: Ethereum, Base, BNB Chain, Arbitrum, Polygon, Morph
Supported Chains
Ethereum · Solana · BNB Chain · Base · Arbitrum · Tron · TON · Sui · Optimism · Polygon · Morph
Quick Start
Install
pip install -e .
Run
python server.py
Or via MCP CLI:
mcp run server.py
Configure in Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"bitget-wallet": {
"command": "python",
"args": ["/path/to/bitget-wallet-mcp/server.py"]
}
}
}
Configure in Cursor / Windsurf
Add to your MCP settings:
{
"bitget-wallet": {
"command": "python",
"args": ["/path/to/bitget-wallet-mcp/server.py"]
}
}
Tools
| Tool | Description |
|---|---|
token_info |
Detailed token information (price, market cap, supply, holders) |
token_price |
Quick price lookup |
batch_token_info |
Multi-token info in one call |
kline |
Candlestick data (1s to 1w periods) |
tx_info |
Transaction volume and trader statistics |
rankings |
Top gainers / top losers |
liquidity |
Liquidity pool information |
security_audit |
Contract security checks |
swap_quote |
Best-route swap quotes |
batch_tx_info |
Batch transaction statistics for multiple tokens |
historical_coins |
Discover new tokens by timestamp |
swap_send |
Broadcast signed transactions (MEV-protected) |
swap_calldata |
Generate unsigned swap transaction data |
⚠️ Swap amounts are human-readable — pass
"0.1"for 0.1 USDT, NOT"100000000000000000". ResponsetoAmountis also human-readable.
Environment Variables
| Variable | Default | Description |
|---|---|---|
BGW_API_KEY |
Built-in demo key | Bitget Wallet ToB API appId |
BGW_API_SECRET |
Built-in demo secret | Bitget Wallet ToB API apiSecret |
BGW_PARTNER_CODE |
bgw_swap_public |
Partner code for swap endpoints |
Note: The built-in demo keys are for testing purposes and may change over time. If they stop working, please update to get the latest keys.
Related Projects
- bitget-wallet-skill — OpenClaw AI Agent skill (with platform compatibility guide)
- bitget-wallet-cli — CLI tool for terminal users
Security
Security
- Only communicates with
https://bopenapi.bgwapi.io— no other external endpoints - No
eval()/exec()or dynamic code execution - No file system access outside the project directory
- Built-in API keys are public demo credentials (safe to commit)
- No data collection, telemetry, or analytics
- No access to sensitive files (SSH keys, credentials, wallet files, etc.)
- Swap calldata only generates unsigned transaction data — actual execution requires wallet signing
- Dependencies:
requests,mcp(stdlib:hmac,hashlib,json,base64) - We recommend auditing the source yourself before installation
License
MIT
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found