# Arweave MCP for AI Agents AI Agent Connect > Arweave MCP. Connect your AI agent to the Arweave permaweb to manage permanent storage, check wallet balances, and query the blockweave. It lets you see real-time network data and transaction statuses without switching tabs. You can also calculate storage costs and submit new transactions directly through your chat interface, making it a complete kit for web3 data management. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_1dwY4eKHwmodBlMbTeSI3fwDfYfyLlEk5y0YsQxG/ai-agent-connect - **Tags:** arweave, permaweb, blockchain, web3, permanent-storage ## Description This Connector lets you treat the Arweave permaweb like a searchable database for your AI agent. Instead of hunting through block explorers or manually calculating storage fees, you can just ask your agent to do the heavy lifting. You can check if a transaction actually landed, look up specific wallet balances, or find out exactly how much it'll cost to pin a large file permanently. It's about moving from manual data fetching to just asking questions. Because Vinkius hosts this among thousands of other connectors, you can plug it right into your existing workflow and start querying the network immediately. It takes the friction out of web3 data retrieval by making the permaweb accessible through natural language. You won't have to copy and paste transaction IDs back and forth or keep multiple tabs open just to see if your data is live. You can verify network health, check peer connections, and pull raw transaction data without ever opening a terminal or a browser tab. It turns complex blockchain interactions into simple conversations, making it much easier to manage permanent data without the usual headache of manual lookups. Whether you are building a decentralized app or just tracking your own storage costs, this tool puts the entire Arweave network at your fingertips through a simple chat interface. You can get a clear picture of the network state or deep-dive into specific transaction history with just a few words. ## Tools ### get_block_by_height The get_block_by_height tool retrieves a specific block from the chain using its height. This helps you see exactly what happened at a specific point in time. ### get_storage_price The get_storage_price tool finds out the current cost in Winstons to store data on the permaweb. Use this to budget for permanent file uploads. ### get_transaction_data The get_transaction_data tool pulls the raw data associated with a transaction. This lets you see the actual content of a submission. ### get_transaction_offset The get_transaction_offset tool provides the byte offset and size of transaction data. Use this to understand the physical footprint of a transaction. ### get_transaction_status The get_transaction_status tool checks if a transaction is pending, confirmed, or failed. This gives you immediate feedback on your network actions. ### get_transaction The get_transaction tool retrieves a transaction by its unique ID. Use this to see the full details of a specific network event. ### get_wallet_balance The get_wallet_balance tool looks up the current Winston balance for any wallet address. This helps you monitor your holdings without opening a separate wallet app. ### get_wallet_last_tx The get_wallet_last_tx tool finds the ID of the last transaction sent by a specific wallet. This is useful for tracking the most recent activity of an address. ### get_network_info The get_network_info tool provides the current Arweave network status. Use this to check the network height and node version in one go. ### get_peers The get_peers tool lists the peer addresses known to the node. This helps you see the health and connectivity of your node. ### query_graphql The query_graphql tool executes a GraphQL query against the Arweave network. Use this to search for specific data and tags across the whole permaweb. ### submit_transaction The submit_transaction tool sends a new transaction directly to the Arweave network. This lets your agent actually perform actions on the blockchain. ### get_block_by_hash The get_block_by_hash tool retrieves a block by its unique hash. Use this to find specific blocks when you only have the hash. ## 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 wallet balances The Arweave MCP retrieves the current Winston balance for any specific wallet address. ### Monitor network health This tool provides real-time data on network height, peer status, and node versions. ### Calculate storage costs You can get exact cost estimates in Winstons for storing specific amounts of data. ### Inspect transaction data The Connector pulls raw data and metadata for specific transactions using their unique IDs. ### Query the permaweb This tool allows you to search for specific data and tags across the entire network. ### Submit new transactions Your agent can send new transactions directly to the Arweave network through this Connector. ## Use Cases ### Verifying a transaction submission A developer needs to know if a transaction failed. They ask the agent to check the status of a specific ID using get_transaction_status. ### Budgeting for large file storage An analyst wants to know the cost of 1GB. They ask the agent to calculate the storage price using get_storage_price. ### Quick balance checks A user wants to know their current balance. They ask the agent to check a specific wallet address using get_wallet_balance. ### Deep-diving into block history A researcher needs to see a specific block. They ask the agent to fetch it by hash using get_block_by_hash. ## Benefits - Stop manual checking of transaction statuses by using get_transaction_status to see if your data landed. - Get instant storage quotes with get_storage_price so you don't have to guess costs before pinning files. - Query the entire permaweb with query_graphql to find specific tags and data points in seconds. - Monitor your assets easily by using get_wallet_balance to see your Winston holdings in real time. - Verify network health with get_network_info to ensure your node or connection is active. - Track the most recent activity of a wallet using get_wallet_last_tx to keep your records updated. ## How It Works The bottom line is you get direct, natural language access to Arweave's permanent data layer. 1. Subscribe to the Arweave MCP via the Vinkius catalog. 2. Connect the Connector to your AI client like Claude, Cursor, or Windsurf. 3. Ask your agent to check balances, query the permaweb, or calculate storage costs. ## Frequently Asked Questions **Can I use the Arweave MCP to check my wallet balance?** Yes, you can ask your agent to look up the current Winston balance for any specific wallet address instantly. **How does the Arweave MCP help with storage costs?** It allows your agent to calculate the exact cost in Winstons to store specific amounts of data on the permaweb in real time. **Can the Arweave MCP track my transaction history?** You can use it to check the status of a specific transaction or find the ID of the last transaction sent by a wallet. **Is the Arweave MCP good for web3 developers?** It is perfect for developers who need to monitor network height and peer status without leaving their coding environment. **Can I query the permaweb using the Arweave MCP?** Yes, you can use your agent to search for specific data and tags across the entire network using natural language queries. **Does the Arweave MCP support submitting transactions?** Yes, your agent can use this Connector to submit new transactions directly to the Arweave network. **How do I check the cost to store a specific amount of data?** You can use the `get_storage_price` tool. Just provide the number of bytes you intend to store, and the agent will return the price in Winstons (where 1 AR = 10^12 Winstons). **Can I retrieve the actual content of a transaction?** Yes. Use the `get_transaction_data` tool with the specific Transaction ID (txid). The agent will fetch the data associated with that transaction from the blockweave. **How do I know if a transaction has been confirmed by the network?** Use the `get_transaction_status` tool. It will return the current status of the transaction, including whether it is pending or confirmed, and the number of confirmations if available.