Skip to content

internet-court/internet-court-skill / vendored/bnb-chain/bnbchain-mcp

bnbchain-mcp

Verified

BNB Chain MCP server connection and tool usage. Covers npx @bnb-chain/mcp@latest, PRIVATE_KEY and RPC, and every MCP tool — blocks, transactions, contracts, ERC20/NFT transfers, wallet, ERC-8004 agent registration, Greenfield. Use when connecting to bnbchain-mcp, querying or transacting on BNB Chain/opBNB/EVM, registering as ERC-8004 agent, or using Greenfield.

references/evm-tools-reference.md

View on GitHub
# EVM tools reference

**`network`**: string like `bsc`, `opbnb`, `ethereum`, `base`, or chain ID. Use **get_supported_networks** to list options.

- **Read-only tools:** `network` is optional; default is `bsc`.
- **Write tools** (`transfer_native_token`, `transfer_erc20`, `transfer_nft`, `transfer_erc1155`, `approve_token_spending`, `write_contract`): **`network` is REQUIRED.** No default. If the user does not specify the network, the agent MUST ask before calling; do not default to mainnet.

Tools that require **PRIVATE_KEY** in the MCP server env are marked with **(write)**.

---

## Blocks

| Tool | Description | Parameters |
|------|-------------|------------|
| get_latest_block | Get the latest block | `network` (optional) |
| get_block_by_number | Get a block by number | `blockNumber` (string), `network` |
| get_block_by_hash | Get a block by hash | `blockHash`, `network` |

---

## Transactions

| Tool | Description | Parameters |
|------|-------------|------------|
| get_transaction | Get transaction by hash | `txHash`, `network` |
| get_transaction_receipt | Get receipt by hash | `txHash`, `network` |
| estimate_gas | Estimate gas for a tx | `to`, `value` (optional, e.g. "0.1"), `data` (optional hex), `network` |

---

## Network

| Tool | Description | Parameters |
|------|-------------|------------|
| get_chain_info | Chain ID, block number, RPC URL | `network` |
| get_supported_networks | List supported networks | (none) |

---

## Wallet and balances

| Tool | Description | Parameters |
|------|-------------|------------|
| get_address_from_private_key | Derive EVM address from private key | `privateKey` (or env PRIVATE_KEY) |
| get_native_balance | Native token balance (BNB, ETH, etc.) | `address` (optional) or `privateKey`, `network` |
| get_erc20_balance | ERC20 balance for an address | `tokenAddress`, `address`, `network` (and optionally `privateKey` for default address) |

**(Write)** — require PRIVATE_KEY in env:

| Tool | Description | Parameters |
|------|-------------|------------|
| transfer_native_token | Send native token | `privateKey`, `toAddress`, `amount` (string e.g. "0.1"), `network` |
| transfer_erc20 | Send ERC20 tokens | `privateKey`, `tokenAddress`, `toAddress`, `amount` (string), `network` |
| approve_token_spending | Approve spender for ERC20 | `privateKey`, `tokenAddress`, `spenderAddress`, `amount` (string), `network` |
| transfer_nft | Transfer ERC721 NFT | `privateKey`, `tokenAddress`, `tokenId`, `toAddress`, `network` |
| transfer_erc1155 | Transfer ERC1155 | `privateKey`, `tokenAddress`, `tokenId`, `amount`, `toAddress`, `network` |

---

## Contracts

| Tool | Description | Parameters |
|------|-------------|------------|
| is_contract | Check if address is contract or EOA | `address`, `network` |
| read_contract | Call view/pure function | `contractAddress`, `abi` (JSON array), `functionName`, `args` (optional array), `network` |
| write_contract | **(Write)** Call state-changing function | `contractAddress`, `abi`, `functionName`, `args`, `privateKey` (or env), `network` |

**read_contract:** Pass the ABI of the single function (or full contract ABI). Example args: `[]` or `["0x...", "123"]`.

---

## Tokens (ERC20)

| Tool | Description | Parameters |
|------|-------------|------------|
| get_erc20_token_info | Name, symbol, decimals | `tokenAddress`, `network` |

---

## NFT (ERC721 / ERC1155)

| Tool | Description | Parameters |
|------|-------------|------------|
| get_nft_info | ERC721 metadata, owner | `tokenAddress`, `tokenId`, `network` |
| get_erc1155_token_metadata | ERC1155 token metadata | `tokenAddress`, `tokenId`, `network` |
| check_nft_ownership | Whether address owns NFT | (Check with get_nft_info or contract read if available) |
| get_nft_balance | NFT count for address in collection | (Use read_contract with balanceOf if needed) |
| get_erc1155_balance | Balance of ERC1155 token ID for address | (Use read_contract with balanceOf if needed) |

Transfer tools: see **Wallet and balances** above (`transfer_nft`, `transfer_erc1155`).

---

## ENS

| Tool | Description | Parameters |
|------|-------------|------------|
| resolve_ens | Resolve ENS name to address | `ensName`, `network` (typically ethereum) |

Note: ENS is not supported on BSC; use on Ethereum or other chains where ENS is deployed.
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexUnverifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall