# BscScan MCP

> BscScan (BNB Chain Explorer) provides deep access into the BNB Chain ledger via your AI agent. Use this MCP to instantly check wallet balances, track every BEP-20 and NFT transfer event, and inspect verifiable smart contract source code directly from natural language prompts.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** bnb-chain, bscscan, smart-contracts, crypto-wallet, web3

## Description

This connector lets you query the entire BNB Chain ecosystem without opening a browser or running complex command lines. You can ask your AI agent to calculate a user's current balance across multiple addresses or find out exactly which tokens moved between two points in time. The system tracks everything, from standard BEP-20 transfers all the way up through unique BEP-721 NFT movements.

For deep audits, you can access verified source code and ABI details for specific contracts. You also get a full picture of transaction activity by checking both normal transactions and internal calls. If you're building tools or analyzing market flows, Vinkius hosts this MCP in its catalog, letting your agent connect to all the data points—block rewards, gas prices, supply levels—and assemble a complete narrative about what happened on the chain.

## Tools

### get_bep20_transfers
Lists all BEP-20 token transfer events associated with a specific address.

### get_bep721_transfers
Lists all NFT (BEP-721) token transfers for an address.

### get_block_countdown
Calculates and returns the estimated time until the next block is mined.

### get_block_reward
Determines the BNB reward amount associated with a specific block number.

### get_bnb_balance_multi
Retrieves the BNB balances for several addresses in one request.

### get_bnb_balance
Checks the current total BNB balance for a single provided address.

### get_bsc_price
Fetches the last recorded price of BNB.

### get_bsc_supply
Gets the total circulating supply amount for BNB on BSC.

### get_contract_abi
Retrieves the Application Binary Interface (ABI) definition for a verified contract source code.

### get_contract_execution_status
Checks if a deployed smart contract finished executing successfully or failed.

### get_contract_source_code
Retrieves the original, verified source code for a specific smart contract address.

### get_eth_block_number
Provides the current block number on the network (proxy function).

### get_eth_transaction_by_hash
Retrieves all details for a transaction using its unique hash ID (proxy function).

### get_internal_transactions
Lists internal calls made by an address that aren't visible in the main transaction list.

### get_normal_transactions
Gets a standard list of all transactions associated with an address.

### get_transaction_receipt_status
Verifies the final status (success or failure) of a transaction receipt.

## Prompt Examples

**Prompt:** 
```
Check the BNB balance for address 0x000000000000000000000000000000000000dEaD
```

**Response:** 
```
I've checked the balance for that address. It currently holds 0.00 BNB.
```

**Prompt:** 
```
List the last 5 BEP-20 token transfers for 0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c
```

**Response:** 
```
I've retrieved the recent BEP-20 transfers for that address. [List of transfers with token names, amounts, and timestamps].
```

**Prompt:** 
```
Get the source code for the contract at 0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82
```

**Response:** 
```
I've fetched the verified source code for the PancakeSwap: Token contract. It includes the Solidity files and compiler settings used for deployment.
```

## Capabilities

### Check multiple wallet balances
Retrieve BNB balances for any single or list of addresses at once.

### Track all token movements
Fetch records detailing BEP-20 and BEP-721 (NFT) transfers across the network to specific addresses.

### Audit contract code and logic
Access a contract's verified source code, ABI, and execution status for technical review.

### Analyze transaction history
Get detailed lists of both normal transactions and internal calls associated with an address.

### Monitor network state
Check things like the current block number, estimated countdown time, and overall BNB market pricing.

## Use Cases

### Investigating a failed DeFi swap
A user suspects their last crypto trade failed. They ask the agent to check the transaction hash using `get_eth_transaction_by_hash` and then use `get_transaction_receipt_status` to confirm if the failure was due to contract logic or external factors.

### Tracking a large NFT collection sale
An analyst needs to monitor a collection's liquidity. They run queries using `get_bep721_transfers` for all tokens linked to the collection, and then use `get_bnb_balance` on the primary wallet to track the resulting BNB inflow.

### Reviewing a smart contract's security
A developer needs to know exactly how an old token was built. They pull the original logic using `get_contract_source_code` and then use `get_contract_abi` to ensure their new code matches the expected structure.

### Auditing multi-step fund movement
A researcher wants to track funds that moved through several intermediaries. They first run a query using `get_normal_transactions`, then use `get_internal_transactions` to map the full, hidden path of money.

## Benefits

- You don't have to jump between tabs. Instead of manually checking a user's balance, your agent calls `get_bnb_balance` or `get_bnb_balance_multi` to get instant data on multiple addresses at once.
- Tracking assets is easier than ever. You can automatically list every BEP-20 transfer using `get_bep20_transfers`, then switch gears and check NFT movement with `get_bep721_transfers`—all in one prompt.
- Deep technical analysis becomes simple. Instead of guessing if a contract is safe, you use `get_contract_source_code` and `get_contract_abi` to review the exact code and structure that was deployed.
- Auditing complex activity means getting more than just transaction records. You can find out what happened with `get_internal_transactions` or check the final outcome using `get_transaction_receipt_status`.
- You always know where you stand on the network. Tools like `get_block_countdown` and `get_bsc_price` give immediate context about the chain's current health, making your analysis complete.

## How It Works

The bottom line is you get verifiable blockchain state and history delivered directly to your chat or IDE.

1. Subscribe to this MCP and enter your BscScan API Key through Vinkius.
2. Instruct your AI client using natural language (e.g., 'What was the BNB balance for address X?').
3. The agent calls the appropriate tool, retrieves raw data, and presents a structured answer.

## Frequently Asked Questions

**How do I check if a transaction was successful using get_transaction_receipt_status?**
You provide the transaction hash, and the tool tells you if the receipt status was 'Success' or 'Failure'. It confirms whether the final action on the chain completed as expected.

**Can I track both ERC-20 and NFT transfers at once using get_bep20_transfers and get_bep721_transfers?**
You must call them separately. Use `get_bep20_transfers` for fungible tokens (like USDC) and then use `get_bep721_transfers` specifically for unique, non-fungible NFTs.

**What is the difference between get_normal_transactions and get_internal_transactions?**
Normal transactions are the primary calls visible on the surface. Internal transactions show the underlying communication that happened when a smart contract executed, which is often where the real action takes place.

**How do I check balances for several addresses using get_bnb_balance_multi?**
You pass a list of multiple wallet addresses to this tool. It returns a single output containing the BNB balance for every address in your provided list simultaneously.

**Does BscScan MCP help me check contract code using get_contract_abi?**
Yes, `get_contract_abi` provides the specific Application Binary Interface needed to interact with a contract. This is crucial for knowing what functions you can call.

**When I need to know the network's total supply, how do I use get_bsc_supply?**
It returns the current circulating BNB total. This tool pulls aggregate data across the whole chain, letting you track overall market metrics without needing individual addresses.

**If I need to know when a block is expected, how does get_block_countdown work?**
It provides an estimate for the remaining time until the next block is mined. This helps you predict transaction finality and manage time-sensitive data queries.

**What happens if I use get_eth_transaction_by_hash with an incorrect hash?**
The API will return a specific error code indicating the invalid hash. You must ensure your transaction identifier is correct before running the query to avoid failed reads.

**Can I check the BNB balance for multiple wallet addresses at once?**
Yes! Use the `get_bnb_balance_multi` tool and provide a comma-separated list of BSC addresses to get all balances in a single request.

**How do I view the NFT transfer history for a specific address?**
You can use the `get_bep721_transfers` tool. Simply provide the target BSC address, and the agent will list the recent BEP-721 token transfer events.

**Is it possible to inspect the source code of a smart contract?**
Yes, provided the contract is verified on BscScan. Use the `get_contract_source_code` tool with the contract address to retrieve its source code and metadata.