# Arweave MCP

> Arweave lets your agent interact directly with the permaweb, a permanent decentralized data storage network. You can check live transaction status, monitor wallet balances in Winstons, calculate exact data storage costs, and query complex network information using GraphQL—all from conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** arweave, permaweb, blockchain, web3, permanent-storage

## Description

Your AI client connects straight to the Arweave permaweb, letting you manage and read permanent blockchain data without leaving your workspace. It lets you ask questions about the network’s health, check if a transaction went through, or figure out exactly what it costs to store a file forever. For instance, you can query the blockweave for specific hashes or use GraphQL to pull complex datasets across the entire network. Because Vinkius hosts this MCP, your agent instantly gains access to all these powerful tools from one connection point. You just ask for the data—whether that’s checking the balance of a wallet address or getting a list of known peer addresses—and it returns the raw information you need.

## Tools

### get_block_by_hash
Retrieves all data for a specific network block using its unique hash identifier.

### get_block_by_height
Fetches the details of a network block based on its numerical height (position).

### get_storage_price
Calculates and reports the exact cost, in Winstons, needed to store data permanently.

### get_transaction_data
Pulls the raw payload or specific content associated with a given transaction ID.

### get_transaction_offset
Determines the starting byte location and size of the data within a transaction record.

### get_transaction_status
Confirms the current state of a transaction, such as pending or confirmed.

### get_transaction
Retrieves all available metadata for a specific transaction using its ID.

### get_wallet_balance
Checks and reports the current balance of any specified wallet address in Winstons.

### get_wallet_last_tx
Gets the unique ID of the most recent transaction associated with a given wallet.

### get_network_info
Provides current, high-level information about the overall Arweave network status.

### get_peers
Lists all peer addresses that are currently known to the connected node.

### query_graphql
Executes a detailed GraphQL query against the entire Arweave network for structured data retrieval.

### submit_transaction
Sends and submits a new transaction record to be processed by the network.

## Prompt Examples

**Prompt:** 
```
What is the current status and height of the Arweave network?
```

**Response:** 
```
I've retrieved the network info. The Arweave network is currently at height 1,542,890 with the current block hash starting with 'zX9...'. The node version is 2.7.2.
```

**Prompt:** 
```
Check the balance for Arweave wallet address 3pD7...x9A.
```

**Response:** 
```
The balance for wallet 3pD7...x9A is 1,250,000,000 Winstons, which is equivalent to 0.00125 AR.
```

**Prompt:** 
```
How much does it cost to store 500MB on Arweave right now?
```

**Response:** 
```
Calculating storage price for 524,288,000 bytes... The current cost is approximately 45,200,000 Winstons (0.0000452 AR).
```

## Capabilities

### Check Network Status
Get real-time details about the Arweave network, including its current height and status.

### Inspect Transactions
Retrieve detailed information on any transaction using its ID or check its final confirmed status.

### Manage Wallet Data
Determine the current balance of a wallet address in Winstons and find its most recent activity.

### Calculate Storage Costs
Find out the precise cost, in Winstons, required to store any amount of data on the permaweb.

### Execute Deep Queries
Run custom GraphQL queries against the entire Arweave network to extract specific, structured data.

## Use Cases

### Validating Data Archiving Costs
A digital museum curator needs to know the total cost of archiving 5TB of historical data. Instead of manually calculating byte sizes and hitting a pricing API, they ask their agent to use `get_storage_price` with the exact volume, getting an immediate quote in Winstons.

### Debugging Transaction Failures
A developer's submitted transaction failed. Instead of trying multiple APIs, they instruct their agent to run `get_transaction` and then use `get_transaction_data` on the specific ID. The agent retrieves the full metadata and raw data payload immediately, pinpointing the error.

### Checking Network Health for a Deployment
A team is preparing a major deployment that requires high network throughput. They ask their agent to use `get_network_info` and then run `get_peers`. This gives them the current block height, overall status, and a list of active peer addresses before writing any code.

### Extracting Specific Web3 Insights
A data analyst needs to find all transactions related to 'NFT-Alpha' that occurred last month. They use `query_graphql` with specific filtering tags, pulling structured insights across the entire network dataset instead of just fetching a limited list by ID.

## Benefits

- Stop guessing on storage costs. The `get_storage_price` tool instantly calculates the exact number of Winstons needed to store any data size, eliminating budget surprises.
- Never manually check multiple endpoints for status again. Use `get_transaction_status` or `get_transaction` to confirm if a transaction is pending or fully confirmed in one simple query.
- Monitor the network without leaving your IDE. You can run `get_network_info` anytime, getting immediate details on the current block height and overall status of Arweave.
- Deep data extraction becomes trivial. The `query_graphql` tool lets you search for specific tags or datasets across the whole permaweb, far beyond simple address lookups.
- Manage multiple assets with ease. You can check a wallet's balance using `get_wallet_balance` and immediately find its last activity ID with `get_wallet_last_tx`, all in one chat flow.

## How It Works

The bottom line is you talk naturally to your AI client and it does the complex blockchain data retrieval for you.

1. You subscribe to this MCP through Vinkius and connect it to your AI client.
2. (Optional) You provide a custom gateway URL if needed for better connectivity.
3. Your agent uses natural conversation to execute commands, whether you need to check network info or calculate storage costs.

## Frequently Asked Questions

**How can I check the current state of the Arweave network using Arweave MCP?**
You use `get_network_info` to get a comprehensive, real-time overview of the entire network. This gives you key metrics like the latest block height and overall status in one response.

**What is the difference between getting transaction data and checking its status using Arweave MCP?**
Use `get_transaction` to retrieve all metadata associated with a given ID. If you only want to know if it's pending or confirmed, use `get_transaction_status`. They give different levels of detail.

**Can I calculate the cost of data storage using Arweave MCP?**
Yes, run `get_storage_price` and provide the byte size. The tool calculates and reports the exact Winston cost for storing that amount of data permanently.

**Which tool should I use to find a specific block by its hash?**
Use `get_block_by_hash`. This is the most direct way to retrieve all information about a network block when you already know its unique identifier (the hash).

**How does Arweave MCP help me monitor my wallet balance?**
You simply ask your agent to use `get_wallet_balance` and provide the address. It returns the current Winston balance instantly, keeping you updated on your funds.