MCP SERVER · OFFICIAL PROJECTMove BNB, ERC20s and NFTs, read and write contracts, and keep files in Greenfield storage — with every value-moving call returning a preview before it executes.
LABSCO SUMMARY
Transfers, approvals, contract writes and Greenfield payments all return a preview plus a token that a second call has to present, and that token dies after 5 minutes, so an unattended agent cannot drift from reading a balance into spending it. The same behaviour is switched off account-wide by one environment variable, which is worth knowing before you set it.
An EVM client for BNB Chain that also reaches Greenfield object storage and the ERC-8004 identity registry: 45 tools over blocks, balances, transfers, contracts, buckets and agent identities.
A private key for anything that signs; block, balance and contract-read calls take a network and an address instead. npx on your PATH. BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION set to true removes the preview step.
One command — npx -y @bnb-chain/mcp@latest
USE CASES
The transfer call returns a preview and a confirmToken instead of moving anything; a second call presents the token and executes. The token is good for 5 minutes, so an abandoned intention expires rather than sitting armed.
Find out whether the address is a contract or an externally owned account, read its token metadata, call a view function to see its state, and price the transaction before committing to it.
Create a bucket, upload files into it, and page through what is there — the listing returns totalCount and hasMore so a large bucket can be walked rather than guessed at. Downloads write to a target path you name.
Greenfield storage is billed through payment accounts, so the quota question and the funding question are answered by different calls: read the bucket's quota usage, then look at the payment accounts behind it and deposit if it is running down.
Register the agent against the ERC-8004 Identity Registry, which mints an identity NFT and returns an agent ID, with the metadata living at an agentURI you can update later as the NFT's owner. The registry also carries the wallet other parties should pay.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
approve_token_spendingApprove another address (e.g. a DeFi protocol or exchange) to spend your ERC20 tokens. Use the exact amount needed. WARNING: Large or unlimited approvals increase risk. By default returns a preview—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
confirm_transferExecute a pending transfer or payment that was returned as a preview. Pass the confirmToken from the preview response and your privateKey. The token expires after 5 minutes.
create_erc20_tokenCreate a new ERC20 token
estimate_gasEstimate the gas cost for a transaction
get_address_from_private_keyGet the EVM address derived from a private key
get_block_by_hashGet block metadata by hash. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).
get_block_by_numberGet block metadata by number. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).
get_chain_infoGet chain information for a specific network
get_erc1155_token_metadataGet the metadata for an ERC1155 token (multi-token standard used for both fungible and non-fungible tokens). The metadata typically points to JSON metadata about the token.
get_erc20_balanceGet ERC20 token balance for an address
get_erc20_token_infoGet ERC20 token information
get_erc8004_agentGet agent info from the ERC-8004 Identity Registry: owner address and tokenURI (metadata URI).
get_erc8004_agent_walletGet the verified payment wallet address for an ERC-8004 agent (for x402 / agent payments). Set on-chain via setAgentWallet; defaults to owner on registration.
get_latest_blockGet the latest block metadata. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).
get_native_balanceGet native token balance for an address
get_nft_infoGet detailed information about a specific NFT (ERC721 token), including collection name, symbol, token URI, and current owner if available.
get_supported_networksGet list of supported networks
get_transactionGet detailed information about a specific transaction by its hash. Includes sender, recipient, value, data, and more.
gnfd_create_bucketCreate a new bucket in Greenfield storage
gnfd_create_fileUpload a file to a Greenfield bucket
gnfd_create_folderCreate a folder in a Greenfield bucket
gnfd_create_payment_accountCreate a new payment account. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
gnfd_delete_bucketDelete a bucket
gnfd_delete_objectDelete an object from a bucket
gnfd_deposit_to_paymentDeposit funds into a payment account. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
gnfd_download_objectDownload an object from a bucket
gnfd_get_account_balanceGet the balance for an account
gnfd_get_all_spsGet a list of all storage providers in the Greenfield network
gnfd_get_bucket_full_infoGet bucket basic information and quota usage
gnfd_get_bucket_infoGet detailed information about a bucket
gnfd_get_object_infoGet detailed information about an object in a bucket
gnfd_get_payment_account_infoGet the info for a payment account
gnfd_get_payment_accountsGet the payment accounts for a given address
gnfd_list_bucketsList buckets owned by the account with pagination. Returns totalCount and hasMore for paging.
gnfd_list_objectsList objects in a bucket with pagination. Returns totalCount and hasMore for paging.
gnfd_withdraw_from_paymentWithdraw funds from a payment account. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
is_contractCheck if an address is a smart contract or an externally owned account (EOA)
read_contractRead data from a smart contract by calling a view/pure function. Response is truncated if it exceeds maxResponseSize bytes.
register_erc8004_agentRegister an agent on the ERC-8004 Identity Registry. Mints an on-chain agent identity (NFT) and returns the agent ID. Use BSC or BSC Testnet; the agentURI should point to a JSON metadata file (AgentURI format) with name, description, image, and services (e.g. MCP endpoint).
set_erc8004_agent_uriUpdate the metadata URI for an existing ERC-8004 agent. Caller must be the owner of the agent NFT.
transfer_erc1155Transfer ERC1155 tokens to another address. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
transfer_erc20Transfer ERC20 tokens to an address. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
transfer_native_tokenTransfer native tokens (BNB, ETH, MATIC, etc.) to an address. By default returns a preview and confirmToken—call confirm_transfer with the token to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
transfer_nftTransfer an NFT to an address. By default returns a preview and confirmToken—call confirm_transfer to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
write_contractWrite data to a smart contract by calling a state-changing function. By default returns a preview and confirmToken—call confirm_transfer with the token to execute. Set skipConfirmation=true or BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true to execute immediately.
BEFORE YOU INSTALL
45 tools when we connected; the project documents 54. Transfer and payment tools return a preview and a five-minute confirmToken and move no funds until confirm_transfer is called; BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true makes them execute immediately. The eight documented prompts are not tools.
npx on PATH
PRIVATE_KEY in your environment
Both documented clients run the server on your machine.
INSTALLATION
npx -y @bnb-chain/mcp@latest{
"mcpServers": {
"bnbchain-mcp": {
"command": "npx",
"args": [
"-y",
"@bnb-chain/mcp@latest"
],
"env": {
"PRIVATE_KEY": "<YOUR_PRIVATE_KEY>",
"BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION": "false"
}
}
}
}MCP servers
nirholas
tolenonetwork
kukapay
mcpdotdirect