# Nearblocks MCP for AI Agents AI Agent Connect

> Nearblocks lets you query the Near blockchain directly through your AI client. You can pull account balances, look up specific transaction details, and monitor network health like TPS and gas prices without leaving your chat. It's the fastest way to get real-time blockchain data into your workflow.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mOUL1cNTLhJp3GHXcAMiXlep5sQxPYyaaX4igpsB/ai-agent-connect
- **Tags:** near-protocol, blockchain-explorer, crypto-api, web3, smart-contracts

## Description

Nearblocks lets you query the Near blockchain directly through your AI client. Most people spend their day jumping between different blockchain explorers, copy-pasting transaction hashes, and refreshing tabs to see if a contract update went through. It's a tedious way to work. This Connector changes that by letting your AI agent do the heavy lifting for you. Instead of manually searching for a wallet's history or trying to figure out which tokens a specific account holds, you just ask your agent. You can get a full breakdown of an account's holdings, check the status of a specific block, or see the latest network-wide transactions in seconds. Because it's hosted on Vinkius, you get a reliable way to plug this data into your existing workflow. You can debug complex smart contracts or check whale movements without leaving your chat. It turns the blockchain into a searchable database for your AI. You don't have to worry about the technical hurdles of request limits or formatting anymore. Your agent handles the heavy lifting and gives you the answers you need in plain English.

## Tools

### get_account_inventory
See all the NFTs owned by a specific account. This saves you from manual inventory checks.

### get_account_tokens
Check which tokens are held in a Near account. Use this to see a full list of a user's assets.

### get_account_transactions
Pull a list of all transactions for a specific account. It's great for auditing historical activity.

### get_block_details
Look up the specific data for a single block. Use this to verify block inclusion or height.

### get_latest_blocks
See the most recent blocks on the blockchain. This keeps you updated on the latest network activity.

### get_network_stats
Check global stats like TPS and gas prices. This provides a quick pulse on network health.

### get_recent_transactions
View a list of the most recent transactions on the network. It's perfect for spotting live moves.

### get_token_list
Pull a list of all tokens on the Near network. This helps you see the full scope of available assets.

### get_transaction_details
Get the specific details for a single transaction hash. This is the best way to debug specific failures.

### get_token_details
Get deep details on a specific token contract. Use this to research tokenomics or supply.

### get_account_details
Get the basic information for a specific Near account. This helps you quickly identify account properties.

## Prompt Examples

**Prompt:** 
```
What's the latest block height on Near?
```

**Response:** 
```
The latest block on the Near blockchain is currently at height **115,234,001**. 

**Recent Activity:**
- Block Hash: `9aB...` 
- Status: Confirmed

Would you like to see the details of this specific block?
```

**Prompt:** 
```
Show me the transactions for account 'vinkius.near'.
```

**Response:** 
```
I found the recent transaction history for **vinkius.near**: 

| Type | Status | Time | 
| :--- | :--- | :--- | 
| FunctionCall | Success | 5m ago | 
| Transfer | Success | 12m ago | 

Should I fetch the full details for the most recent transaction?
```

**Prompt:** 
```
What tokens does this account hold?
```

**Response:** 
```
The account **vinkius.near** currently holds the following tokens:

- **NEAR**: 50.00
- **USDC**: 1,200.00
- **Other Tokens**: 3 more assets detected.

Would you like a full list of all tokens on the network instead?
```

## Capabilities

### Fetch account balances
Get the current balance and history for any Near account.

### List NFT holdings
View every NFT owned by a specific account in one go.

### Track recent transactions
See the most recent activity happening on the network.

### Get token contract details
Pull deep information about specific tokens on the network.

### Monitor network health
Check live stats like TPS and gas prices instantly.

## Use Cases

### Debugging failed transactions
A developer asks about a specific hash to see why it failed. The agent uses `get_transaction_details` to pull the error message and gas usage.

### Tracking whale movements
An analyst asks to see large transfers in the last hour. The agent uses `get_recent_transactions` to scan the network for significant activity.

### Checking a personal portfolio
A user asks what tokens they own. The agent uses `get_account_tokens` to list their holdings and balances in a clean summary.

### Monitoring network health
A dev wants to know current gas prices and network congestion. The agent uses `get_network_stats` to provide live data points.

## Benefits

- Stop manually digging through explorers; use `get_account_transactions` to see history instantly.
- Track NFT holdings easily with `get_account_inventory` instead of switching tabs.
- Monitor network health with `get_network_stats` to see real-time TPS and gas.
- Debug smart contracts faster by pulling data with `get_token_details`.
- Spot whale movements by using `get_recent_transactions` to scan for large transfers.
- Get a full list of available assets with `get_token_list` to see what's live on the network.

## How It Works

The bottom line is you get real-time blockchain data without leaving your chat.

1. Subscribe to the Nearblocks MCP on the Vinkius marketplace.
2. Provide your Nearblocks credentials in the setup menu.
3. Ask your AI client to pull account balances or network stats.

## Frequently Asked Questions

**Can I use Nearblocks to check my own Near account balance?**
Yes, you can ask your agent to pull your account details or token balances instantly. It gives you a real-time view of your holdings without needing to open a browser.

**Does Nearblocks support NFT inventory lookups?**
It does. You can ask your agent to list all NFTs owned by a specific account, and it will return the full inventory for you.

**Can I use Nearblocks to monitor gas prices?**
Yes, you can get live network statistics including current gas prices and TPS. This is helpful for timing transactions or checking network health.

**Is Nearblocks good for debugging failed transactions?**
It's perfect for that. You can provide a transaction hash to your agent and it will pull the specific details to show you exactly what happened.

**How do I get the latest transactions on the Near network using Nearblocks?**
Just ask your agent to show you the most recent transactions. It will pull the latest activity from the blockchain and summarize it for you.

**Can I see which NFTs an account owns?**
Yes! Use the `get_account_inventory` tool with the target account ID. It will return a list of Non-Fungible Tokens (NFTs) currently held by that account.

**How do I check the current network status like TPS?**
You can use the `get_network_stats` tool. It provides real-time metrics including Transactions Per Second (TPS), current block height, and gas prices.

**Is it possible to list all tokens available on the Near network?**
Yes, the `get_token_list` tool allows you to fetch a list of fungible and non-fungible tokens registered on the Near network.