# Dogechain Explorer MCP

> Dogechain Explorer (Dogechain Block Explorer API) lets your AI agent query and analyze Dogecoin blockchain data directly. Check real-time address balances, trace complex transaction histories, view unspent outputs (UTXOs), or inspect specific blocks using natural language commands.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** dogecoin, block-explorer, crypto-wallet, on-chain-data, utxo-tracker

## Description

This MCP connects your AI client to the entire Dogechain network history. You can stop manually visiting web explorers and start doing deep on-chain analysis right from your chat window. It lets you verify any wallet balance, track every coin sent or received by an address, and even examine the details of a specific transaction hash.

Whether you're debugging a smart contract failure or just checking how much DOGE moved last week, this MCP handles it all. You get raw blockchain data delivered directly into your workflow. If you’re looking for a centralized source to analyze crypto assets without leaving your primary interface, Vinkius hosts this connection, making deep chain insights available through any compatible AI client.

## Tools

### get_address_balance
Retrieves the current balance of a specified Dogecoin address.

### get_address_received
Calculates the total amount of DOGE ever received by an address.

### get_address_sent
Calculates the total amount of DOGE ever sent from an address.

### get_address_transaction_count
Counts how many transactions have occurred for a given address.

### get_address_transactions
Fetches paginated lists of recent transaction hashes and details for an address.

### get_address_unspent
Lists the unspent outputs (UTXOs) by fetching them in batches up to 10 results at a time.

### get_best_block_hash
Retrieves the current best block hash identifier for the Dogechain network.

### get_block
Fetches detailed information about a specific block using its height or hash.

### get_transaction
Retrieves full details, including inputs and outputs, for a specific transaction hash.

### q_address_balance
Quickly checks the current available balance of an address.

### q_address_to_hash
Converts a Dogecoin address to its corresponding public key hash.

### q_check_address
Validates whether an inputted string is a correctly formatted Dogecoin address.

### q_decode_address
Decodes the structure of a given Dogecoin address for analysis.

### q_get_block_count
Gets the current, latest block height on the network.

### q_get_difficulty
Retrieves the difficulty level associated with the most recent block.

### q_get_received_by_address
Provides the total amount of DOGE ever received by an address (quick query).

### q_get_sent_by_address
Provides the total amount of DOGE ever sent from an address (quick query).

## Prompt Examples

**Prompt:** 
```
What is the current balance of Dogecoin address D8v963B9wS4En543S8Z6eS6S6S6S6S6S6S?
```

**Response:** 
```
I've checked the address. The current balance for D8v963... is 1,250.50 DOGE (Confirmed: 1,250.50, Unconfirmed: 0.00).
```

**Prompt:** 
```
Show me the details for transaction hash 76a4c8...
```

**Response:** 
```
Fetching transaction details... This transaction was included in block 4,500,123. It involved 2 inputs and 1 output, with a total value of 5,000 DOGE and 12 confirmations.
```

**Prompt:** 
```
List the unspent outputs (UTXOs) for address D6r...
```

**Response:** 
```
I found 3 unspent outputs for address D6r... Totaling 450 DOGE. The largest UTXO is 300 DOGE from transaction hash b2f1...
```

## Capabilities

### Audit Wallet Balances
Find the current balance of an address and calculate its total sent or received amounts.

### Track Transaction Flow
Retrieve detailed lists of recent transactions, including inputs, outputs, and confirmation status for any given wallet.

### Identify Unspent Outputs
List the specific unspent transaction outputs (UTXOs) associated with an address to determine its current liquidity pool.

### Analyze Block Data
Get detailed information about a specific block, or find out what the latest block hash is for the network.

### Validate Addresses
Quickly check if an address format is valid and decode it to its public key hash.

## Use Cases

### Debugging a Failed Payment
A developer suspects a payment failed because the source wallet was improperly formatted. They first use `q_check_address` to validate the address, and then they run `get_address_unspent` to confirm if there are enough UTXOs available for the transaction.

### Auditing a Large Fund Transfer
A finance analyst needs to prove where a massive sum of DOGE came from. They use `get_transaction` on the receiving hash and then cross-reference it with `get_address_sent` to verify the origin account's sending history.

### Tracking Whale Activity
A crypto trader monitors a key wallet. They use `q_get_received_by_address` to get a running total of all incoming funds, then check `get_address_transactions` for the latest movements.

### Researching Network Stability
A researcher needs background context. They run `q_get_block_count` and `q_get_difficulty` to understand the current state of the network, then use `get_best_block_hash` for specific research points.

## Benefits

- Stop guessing about account liquidity. Use `get_address_unspent` to list all unspent transaction outputs (UTXOs) for an address, giving you a clear view of its available funds without guesswork.
- Get full context on any movement by running `get_transaction` against a hash. You immediately see the inputs and outputs involved, which is key for debugging or auditing purposes.
- Save time when checking basic stats. The quick query tools like `q_address_balance` let you grab current balances instantly, making rapid checks faster than deep API calls.
- Trace account history thoroughly by combining calls. Start with `get_address_transaction_count`, then use `get_address_transactions` to get the actual details for a full audit trail.
- Confirm data integrity upfront. Use `q_check_address` and `q_decode_address` first. This ensures that any complex query you run afterwards on an address is based on valid input.

## How It Works

The bottom line is that your AI acts like a dedicated blockchain analyst, pulling complex ledger data without you ever leaving your current application.

1. First, connect your AI client to this MCP via Vinkius.
2. Next, use natural language. You just tell your agent what you need—like 'What was the total sent amount for address X?'
3. The system runs the necessary background queries and delivers the raw data or summary directly into your chat interface.

## Frequently Asked Questions

**How do I check a wallet balance using get_address_balance?**
You simply ask your agent for the current balance of the Dogecoin address. The tool runs and returns the real-time DOGE amount, confirming if it's confirmed or unconfirmed.

**What is the difference between get_address_received and q_get_received_by_address?**
They both track total incoming funds. Use `q_get_received_by_address` for a quick number, but use `get_address_received` if you need deeper historical context or data points.

**Can I find out what inputs were used in a transaction?**
Yes. You must run the `get_transaction` tool and provide the specific hash. The results will show all associated inputs, outputs, and confirmation status for that exact event.

**Do I need to worry about address validation? What is q_check_address?**
Always validate first. `q_check_address` confirms if the string you are using is a valid Dogecoin address format, preventing your subsequent queries from failing due to bad input.

**How does my AI client handle authentication when using get_address_balance?**
Your AI agent handles authentication through your Vinkius subscription. You connect once to the catalog, giving access credentials that power all listed tools, including `get_address_balance`.

**What is the best way to check the latest block activity using get_best_block_hash?**
Using `get_best_block_hash` gives you the current tip of the chain. This hash tells your agent exactly which block was most recently confirmed, helping you time transactions accurately.

**When I run get_address_unspent, how do I retrieve all records if there are many?**
The results for `get_address_unspent` are paginated (10 per page). You must instruct your agent to call the tool repeatedly, passing the last retrieved data point until no more unspent outputs are listed.

**If I just run q_decode_address, what happens if I actually need all transaction metadata?**
The quick query `q_decode_address` only provides immediate validation and decoding. To get full details like inputs, outputs, and confirmation status, you must use the comprehensive `get_transaction` tool.

**Can I check the balance of a specific Dogecoin address?**
Yes! Use the `get_address_balance` tool with the target address. The agent will return the confirmed and unconfirmed balance immediately.

**How do I find the latest block hash on the network?**
Simply ask the agent to run the `get_best_block_hash` action. It will retrieve the hash of the most recently mined block on the Dogecoin blockchain.

**Is it possible to verify if a Dogecoin address is valid?**
Yes. Use the `q_check_address` tool. It provides a quick validation check to confirm if the provided string is a valid Dogecoin address format.