Exposes Bitget Wallet ToB API as tools for AI agents.
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
Tools (13)
token_infoDetailed token information (price, market cap, supply, holders)token_priceQuick price lookupbatch_token_infoMulti-token info in one callklineCandlestick data (1s to 1w periods)tx_infoTransaction volume and trader statisticsrankingsTop gainers / top losersliquidityLiquidity pool informationsecurity_auditContract security checksswap_quoteBest-route swap quotesbatch_tx_infoBatch transaction statistics for multiple tokenshistorical_coinsDiscover new tokens by timestampswap_sendBroadcast signed transactions (MEV-protected)swap_calldataGenerate unsigned swap transaction dataEnvironment Variables
BGW_API_KEYBitget Wallet ToB API appIdBGW_API_SECRETBitget Wallet ToB API apiSecretBGW_PARTNER_CODEPartner code for swap endpointsConfiguration
{"mcpServers": {"bitget-wallet": {"command": "python", "args": ["/path/to/bitget-wallet-mcp/server.py"]}}}