# Irys MCP for AI Agents AI Agent Connect

> Irys lets you manage permanent data storage on the Irys provenance layer. Use it to check real-time storage prices for tokens like Ethereum and Solana, query historical transactions using GraphQL filters, and manage your node funding and wallet balances across multiple networks. It's built for anyone who needs to interact with permanent web data without jumping between different dashboards.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_pdIDRhP5FYgzNNeQikAzTwNh77FDXC6PYlDvWG90/ai-agent-connect
- **Tags:** permanent-storage, web3, arweave, data-provenance, graphql

## Description

Managing data on a permanent layer shouldn't feel like a chore of switching tabs and manually calculating costs. This Connector changes that by giving your AI agent a direct line to Irys. You can ask your agent to check how much it'll cost to store a specific amount of data on Solana or Ethereum, and it'll give you the numbers in seconds. If you need to dig through old records, you can just describe the tags you're looking for, and the agent handles the GraphQL filtering for you. It also takes the headache out of account maintenance. Instead of hunting for where to fund a node or checking balances across different tokens, you just tell your agent what needs doing. It can handle the funding receipts and withdrawal requests directly. Because Vinkius hosts this in a unified catalog, you get this level of deep Web3 data access added to your existing setup without any extra friction. It's about moving from "how do I find this data" to "what does this data mean for my project."

## Tools

### get_info
Get the current metadata and configuration for your Irys node. This helps you see what features are active.

### get_price
Calculate the exact cost for storing data using specific tokens. It works for both Ethereum and Solana.

### query_transactions
Search through historical records using GraphQL filters. This is perfect for finding specific tags or values.

### submit_transaction
Send a signed data transaction to the network. It handles the submission process for your data.

### withdraw_account
Start a withdrawal request for your account funds. It simplifies the process of moving assets out.

### get_balance
Check the current balance for a specific wallet address. You can monitor multiple tokens at once.

### fund_account
Submit a funding transaction receipt to your node. This keeps your node operational and funded.

### get_transaction
Pull detailed metadata for a specific transaction ID. Use it to see exactly what happened in a past event.

## Prompt Examples

**Prompt:** 
```
What's the cost to store 2GB of data on the Solana network?
```

**Response:** 
```
I've calculated the cost for 2,000,000,000 bytes on Solana. Based on current rates, it will cost approximately 25,000,000 atomic units. Would you like me to check the price for a different token or size?
```

**Prompt:** 
```
Find any transactions that have the tag 'Project-Alpha' in them.
```

**Response:** 
```
I searched the historical records and found 4 transactions with the 'Project-Alpha' tag. The most recent one was submitted 2 hours ago. Would you like to see the full metadata for these?
```

**Prompt:** 
```
Is my node healthy and what tokens does it support?
```

**Response:** 
```
I've checked your node status. It's currently healthy and active. It supports the following tokens: Ethereum, Solana, Arweave, and Matic. You're all set to start uploading.
```

## Capabilities

### Check storage costs for specific tokens
Get exact pricing for data storage using tokens like Ethereum or Solana.

### Search historical records with GraphQL
Filter through permanent records using specific tags and values.

### Monitor wallet balances
Check current balances for specific addresses across multiple tokens.

### Submit funding receipts
Provide funding receipts to keep your Irys node operational.

### Initiate withdrawal requests
Request a withdrawal from your account directly through your agent.

### Retrieve transaction metadata
Get detailed status and tags for any specific transaction ID.

### Get real-time node status
Check node configuration and supported features instantly.

## Use Cases

### Calculating storage costs for a new upload
A developer needs to know if they have enough funds to store 1GB of data on Solana. They ask the agent to check the price and current balance.

### Finding specific historical records
A researcher wants to find all transactions tagged with a specific app name. The agent queries the history and lists the latest three.

### Monitoring node health and tokens
A DevOps lead needs to ensure a node is healthy. They ask the agent to check the node info and supported tokens.

### Initiating account withdrawals
A user wants to move funds out of an account. They tell the agent to initiate a withdrawal request for a specific amount.

## Benefits

- Stop guessing costs by using get_price to see exact storage requirements for Ethereum, Solana, or other tokens instantly.
- Find specific data faster by letting your agent use query_transactions to filter through GraphQL records with custom tags.
- Keep your node running without interruptions by using fund_account and get_balance to monitor your funding status.
- Get instant clarity on past actions by pulling specific metadata with get_transaction instead of digging through block explorers.
- Simplify your dev workflow by using get_info to check node health and supported features without leaving your IDE.

## How It Works

The bottom line is you get direct, agent-led control over permanent data storage and node economics.

1. Subscribe to the Irys MCP in your preferred AI client.
2. Provide your Irys Node URL for either Mainnet or Devnet.
3. Ask your agent to check prices, query records, or manage your node funding.

## Frequently Asked Questions

**What can I do with the Irys MCP?**
You can use your AI agent to manage permanent data storage, check real-time pricing for different tokens, and handle node funding or withdrawals.

**How does Irys help with permanent data?**
It provides a provenance layer for permanent data storage, ensuring your records stay on the web and are easily queryable.

**Can I check storage prices for different tokens?**
Yes, you can get exact pricing for tokens like Ethereum, Solana, and others to plan your storage costs accurately.

**Can my agent help manage my node funding?**
Yes, your agent can submit funding receipts and initiate withdrawal requests to keep your node running smoothly.

**How do I find old transactions on Irys?**
You can ask your agent to search historical records using specific tags or values, and it will query the data for you.

**Is this Connector good for Web3 developers?**
It's ideal for developers who need to monitor node health, check upload costs, and interact with permanent web data.

**Can I see my wallet balance using this?**
Yes, your agent can check the current balance for any specific address to help you monitor your funds.

**How can I check the cost of storing a specific amount of data?**
Use the `get_price` tool by providing the payment token (e.g., 'ethereum') and the size in bytes. The agent will return the cost in atomic units for that specific network.

**Is it possible to search for historical transactions by their tags?**
Yes! The `query_transactions` tool allows you to filter transactions using GraphQL by specifying a `tag_name` and `tag_value`, along with a result limit.

**How do I verify the balance of a specific wallet on the Irys node?**
You can use the `get_balance` tool. Just provide the token type and the wallet address to retrieve the current balance held on the Irys node.