BNBChain MCP (Model Context Protocol)

@bnb-chain

About BNBChain MCP (Model Context Protocol)

A MCP server for BNB Chain that supports BSC, opBNB, Greenfield, and other popular EVM-compatible networks.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "bnbchain-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@bnb-chain/mcp@latest"
      ],
      "env": {
        "PRIVATE_KEY": "your_private_key_here. (optional)",
        "BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION": "false"
      }
    }
  }
}

Tools

Register 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).

Update the metadata URI for an existing ERC-8004 agent. Caller must be the owner of the agent NFT.

Get agent info from the ERC-8004 Identity Registry: owner address and tokenURI (metadata URI).

Get 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 block metadata by hash. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).

Get block metadata by number. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).

Get the latest block metadata. Returns number, hash, timestamp, gasUsed, transaction count, and optionally transaction hashes (not full tx data).

Check if an address is a smart contract or an externally owned account (EOA)

Read data from a smart contract by calling a view/pure function. Response is truncated if it exceeds maxResponseSize bytes.

Write 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.

Get chain information for a specific network

Get list of supported networks

Get ERC20 token information

Get native token balance for an address

Get ERC20 token balance for an address

Create a new ERC20 token

Get detailed information about a specific transaction by its hash. Includes sender, recipient, value, data, and more.

Estimate the gas cost for a transaction

Get the EVM address derived from a private key

Transfer 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.

Approve 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.

Transfer 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.

Get detailed information about a specific NFT (ERC721 token), including collection name, symbol, token URI, and current owner if available.

Get 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.

Transfer 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.

Transfer 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.

Get the balance for an account

Get a list of all storage providers in the Greenfield network

Create a new bucket in Greenfield storage

Upload a file to a Greenfield bucket

Create a folder in a Greenfield bucket

List buckets owned by the account with pagination. Returns totalCount and hasMore for paging.

List objects in a bucket with pagination. Returns totalCount and hasMore for paging.

Delete an object from a bucket

Delete a bucket

Get detailed information about a bucket

Get bucket basic information and quota usage

Get detailed information about an object in a bucket

Download an object from a bucket

Get the payment accounts for a given address

Create 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.

Deposit 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.

Withdraw 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.

Get the info for a payment account

Execute 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.

Overview

What is BNBChain MCP?

BNBChain MCP is a Model Context Protocol (MCP) server that enables AI-powered interaction with BNB Chain and other EVM-compatible networks. It provides tools and resources for blockchain development, smart contract interaction, and network management through natural language.

How to use BNBChain MCP?

Install and configure with your MCP client (Cursor, Claude Desktop) by adding a JSON entry that runs npx -y @bnb-chain/mcp@latest with optional environment variables PRIVATE_KEY and BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION. For local development, clone the repo, install dependencies with bun install, and run bun dev:sse.

Key features of BNBChain MCP

Query blocks, transactions, and native/ERC20 balances
Transfer native tokens, ERC20, NFTs, and ERC1155 tokens
Interact with smart contracts (read/write)
Support for Greenfield file operations and ERC-8004 AI agent identities
Preview-then-confirm flow for all transfer and payment tools
Available as stdio or SSE transport

Use cases of BNBChain MCP

Analyze an EVM address, block, or transaction through natural language prompts
Transfer BNB, ETH, or ERC20 tokens with a confirmation step
Check NFT ownership and retrieve token metadata
Register and resolve on-chain AI agent identities (ERC-8004)
Compare different EVM-compatible networks

FAQ from BNBChain MCP

How do I set up BNBChain MCP with Claude Desktop?

Open Claude Desktop Settings, go to Developer, click “Edit Config”, and add the JSON configuration with command: "npx" and args: ["-y", "@bnb-chain/mcp@latest"]. Optionally set PRIVATE_KEY and BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION in the env object.

How does the transfer confirmation flow work?

By default, calling a transfer or payment tool returns a preview with a short-lived confirmToken. No transaction is sent until you call confirm_transfer with that token and your private key. You can skip confirmation per call with skipConfirmation: true or server‑wide by setting BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true.

Is it safe to deploy this server publicly?

No. The SSE endpoint has no built‑in authentication, so anyone who can reach it can use the server. If public deployment is required, add an authentication layer (API keys, JWT, reverse proxy) or deploy a keyless version with only read‑only tools.

What are the system requirements?

You need Node.js v17 or higher and bun v1.2.10 or higher for local development. The server itself runs on any platform where Node.js is available.

Can I use BNBChain MCP with other clients besides Cursor and Claude Desktop?

Yes. The repository contains an examples directory that demonstrates how to set up an MCP client, authenticate, make API calls, and handle responses. You can integrate it into any custom client that supports the Model Context Protocol.

Frequently asked questions

How do I set up BNBChain MCP with Claude Desktop?

Open Claude Desktop Settings, go to Developer, click “Edit Config”, and add the JSON configuration with `command: "npx"` and `args: ["-y", "@bnb-chain/mcp@latest"]`. Optionally set `PRIVATE_KEY` and `BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION` in the `env` object.

How does the transfer confirmation flow work?

By default, calling a transfer or payment tool returns a preview with a short-lived `confirmToken`. No transaction is sent until you call `confirm_transfer` with that token and your private key. You can skip confirmation per call with `skipConfirmation: true` or server‑wide by setting `BNBCHAIN_MCP_SKIP_TRANSFER_CONFIRMATION=true`.

Is it safe to deploy this server publicly?

What are the system requirements?

You need Node.js v17 or higher and [bun](http://bun.sh/) v1.2.10 or higher for local development. The server itself runs on any platform where Node.js is available.

Can I use BNBChain MCP with other clients besides Cursor and Claude Desktop?

Yes. The repository contains an `examples` directory that demonstrates how to set up an MCP client, authenticate, make API calls, and handle responses. You can integrate it into any custom client that supports the Model Context Protocol.

Comments

Basic information

More Other MCP servers

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

MCP Go 🚀

mark3labs

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.

8.9K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

About BNBChain MCP (Model Context Protocol)

Config

Tools

register_erc8004_agent

set_erc8004_agent_uri

get_erc8004_agent

get_erc8004_agent_wallet

get_block_by_hash

get_block_by_number

get_latest_block

is_contract

read_contract

write_contract

get_chain_info

get_supported_networks

get_erc20_token_info

get_native_balance

get_erc20_balance

create_erc20_token

get_transaction

estimate_gas

get_address_from_private_key

transfer_native_token

approve_token_spending

transfer_erc20

get_nft_info

get_erc1155_token_metadata

transfer_nft

transfer_erc1155

gnfd_get_account_balance

gnfd_get_all_sps

gnfd_create_bucket

gnfd_create_file

gnfd_create_folder

gnfd_list_buckets

gnfd_list_objects

gnfd_delete_object

gnfd_delete_bucket

gnfd_get_bucket_info

gnfd_get_bucket_full_info

gnfd_get_object_info

gnfd_download_object

gnfd_get_payment_accounts

gnfd_create_payment_account

gnfd_deposit_to_payment

gnfd_withdraw_from_payment

gnfd_get_payment_account_info

confirm_transfer

Overview

What is BNBChain MCP?

How to use BNBChain MCP?

Key features of BNBChain MCP

Use cases of BNBChain MCP

FAQ from BNBChain MCP

How do I set up BNBChain MCP with Claude Desktop?

How does the transfer confirmation flow work?

Is it safe to deploy this server publicly?

What are the system requirements?

Can I use BNBChain MCP with other clients besides Cursor and Claude Desktop?

Frequently asked questions

How do I set up BNBChain MCP with Claude Desktop?

How does the transfer confirmation flow work?

Is it safe to deploy this server publicly?

What are the system requirements?

Can I use BNBChain MCP with other clients besides Cursor and Claude Desktop?

Comments

More Other MCP servers

Glasswarp

Unity MCP ✨

MCP Go 🚀

Codelf

Mcp