# BlockCypher MCP

> The BlockCypher MCP lets you interact with major blockchains like Bitcoin, Ethereum, and Litecoin directly through your AI client. Query block heights, audit wallet balances across chains, generate keypairs, or even broadcast signed transactions—all using natural language commands.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** bitcoin, ethereum, blockchain-api, crypto-data, web3

## Description

This connector gives your agent a direct line into the multi-chain world. Instead of jumping between dozen different block explorer websites to check on asset movements, you talk to your AI client and it handles the complex calls for you. You can audit any public wallet address or pull detailed historical data just by asking a question. Need to test something? Your agent can generate new keypairs and addresses programmatically. Even if you're ready to make changes, this MCP lets you create skeleton transactions, sign them up inside your workflow, and broadcast them right back onto the network. Everything is accessible through Vinkius, so whether you use Claude, Cursor, or another compatible client, you get one place for all major blockchain data.

## Tools

### fund_bcy_test_address
Adds funds to a specific address on the BCY test chain for testing purposes.

### fund_beth_test_address
Adds funds to a specific address on the BETH test chain for testing purposes.

### call_eth_contract_method
Executes a specified function or method within an existing Ethereum smart contract.

### create_eth_contract
Deploys and creates a brand new Ethereum smart contract on the network.

### create_webhook
Sets up real-time notifications for events, like unconfirmed transactions or newly mined blocks.

### generate_address
Creates a brand new public address and its corresponding private keypair for use in development.

### get_address_balance
Retrieves only the current total balance associated with a specific wallet address.

### get_address
Fetches comprehensive details about an address, including its transaction history references and metadata.

### get_block_by_hash
Retrieves all detailed information about a block using its unique cryptographic hash identifier.

### get_block_by_height
Fetches the complete details for a specific block based on its sequential height number.

### get_blockchain
Retrieves the current operational state, including fees and heights, for an entire blockchain network.

### get_transaction
Gets detailed information about a transaction using its unique hash ID.

### new_transaction
Creates the basic structure of a transaction, ready for you to sign and verify before broadcast.

### send_transaction
Transmits a fully signed transaction from your agent directly out to the live blockchain network.

### get_token_info
Retrieves diagnostic information about your API token used for accessing the service.

## Prompt Examples

**Prompt:** 
```
Get the current status of the Bitcoin mainnet.
```

**Response:** 
```
I've retrieved the Bitcoin mainnet status. The current height is 834,291 with a hash of 0000...a1b2. High priority fees are currently around 45 sat/vB.
```

**Prompt:** 
```
Check the balance for BTC address 1A1zP1eP5QGefi2DMPTfTL5SLmv7DivfNa.
```

**Response:** 
```
The address has a total balance of 99.98 BTC with 0 unconfirmed transactions.
```

**Prompt:** 
```
Generate a new address for the Dogecoin testnet.
```

**Response:** 
```
I've generated a new Dogecoin testnet address. Public Address: n1...xyz, Private Key: [hidden]. Make sure to save your private key securely.
```

## Capabilities

### Check Chain Status
Retrieve real-time metrics like block heights and fee estimates across multiple testnets and mainnets.

### Audit Wallet Assets
Query the balance and transaction history for any public wallet address instantly, eliminating manual block explorer searches.

### Inspect Block Data
Pull deep details on specific blocks using either a hash or the block's height to analyze network activity.

### Manage Keys and Addresses
Generate new, secure public/private keypairs and addresses for supported cryptocurrencies.

### Execute Transactions
Create the necessary structure for a transaction, sign it within your workflow, and send it to the active blockchain network.

## Use Cases

### Checking for suspicious funds movement
A security analyst notices an unusual address. Instead of manually checking five different block explorers, they ask their agent to run `get_address` and analyze the transaction references across multiple chains.

### Automating contract upgrades
A fintech team needs to deploy a new feature. They use the MCP's capability to `create_eth_contract` and then call `call_eth_contract_method` against an existing contract to verify its current logic before deployment.

### Validating testnet transactions
A developer is building a wallet interface. They use the MCP to generate fresh keypairs with `generate_address`, fund them on a test chain using `fund_beth_test_address`, and then simulate the entire transaction flow.

### Monitoring payment status
A payments system needs constant updates. It uses the MCP to establish a web hook (`create_webhook`) that immediately alerts it when funds are confirmed or if a critical block is mined, ensuring zero downtime.

## Benefits

- Instantly audit assets: You can check a wallet's full balance or transaction history using the `get_address` tool without ever leaving your agent environment. No manual block explorer lookups needed.
- Automate network monitoring: Set up real-time alerts via `create_webhook`. Your workflow will get notifications for things like new blocks or unconfirmed transactions, keeping you ahead of changes.
- Test complex operations safely: Before deploying code, use tools like `generate_address` to create keypairs and testnet funds using `fund_bcy_test_address`, minimizing risk.
- Full transaction lifecycle control: The workflow is simple. You first call `new_transaction` to build the skeleton, then sign it, and finally use `send_transaction` to broadcast it—all managed by your agent.
- Deep historical analysis: Whether you need data on a specific block using `get_block_by_height` or just want to know what's happening generally with `get_blockchain`, the information is always one prompt away.

## How It Works

The bottom line is that you get full, programmatic control over reading and writing complex, multi-chain blockchain data using simple text prompts.

1. First, subscribe to this MCP on Vinkius and provide your personal BlockCypher API Token.
2. Next, prompt your AI client with a natural language query (e.g., 'What's the current balance of X?').
3. Your agent executes the necessary tool calls against the blockchain data and returns the requested details directly to you.

## Frequently Asked Questions

**How do I check the current state of Bitcoin using BlockCypher MCP?**
You can use the `get_blockchain` tool. This retrieves the real-time metrics, including block heights and fee estimates for the entire network.

**Can I test sending a transaction without risking real funds?**
Yes, you can manage transactions using tools like `new_transaction`. You build the skeleton, verify it, and then use testing functions such as `fund_bcy_test_address` to simulate the process safely.

**What is the best way to monitor for new events?**
Use the `create_webhook` tool. This sets up persistent notifications that alert your workflow immediately when critical events, like unconfirmed transactions or new blocks, happen.

**Does this MCP help me interact with smart contracts?**
Yes. You can use the `call_eth_contract_method` tool to execute specific functions on an existing Ethereum contract, and even use `create_eth_contract` to deploy entirely new ones.

**How do I get a secure keypair for testing?**
Use the `generate_address` tool. It securely creates both a public address and its corresponding private keypair, which is essential for development work.