# QuickNode MCP for AI Agents AI Agent Connect

> QuickNode MCP lets you manage blockchain infrastructure through your AI agent. You can set up real-time data streams, deploy webhooks for contract events, and query RPC nodes without switching tabs. It's for anyone building on Web3 who needs to automate their data pipelines and node configurations using natural language.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_KXmcvaMCSZFRwuuczqPN4t4YGrO5deI8ZrCy4Zaq/ai-agent-connect
- **Tags:** web3, ethereum, rpc, data-streams, webhooks

## Description

QuickNode connects your blockchain infrastructure directly to your AI agent, letting you manage Web3 data pipelines through natural language. If you're tired of jumping between different dashboards to configure webhooks, set up data streams, or check node status, this Connector handles the heavy lifting for you. You can describe the specific data you need to ingest or the events you want to track, and your agent will handle the configuration. It's one of the most efficient ways to manage high-performance blockchain data in the Vinkius catalog. Instead of wrestling with complex menus and copy-pasting JSON, you can just tell your agent what you want to build. Whether you're setting up real-time filters for a new dApp or monitoring contract events, you can do it all in one place. This turns your AI client into a central hub for your Web3 operations, allowing you to monitor logs, update filtering logic, and verify block numbers in seconds. It takes the friction out of infrastructure management so you can spend more time on your smart contracts and front-end development. You no longer have to worry about the manual steps of deploying listeners or updating stream parameters. You can just describe the goal, and your agent handles the execution. It makes building out a production-ready data environment feel like a conversation rather than a series of tedious configuration tasks.

## Tools

### create_kv_set
Create a key-value pair in your KV store. Use this to store specific flags or configuration bits.

### create_stream
Create a new blockchain data stream. This lets you ingest live or historical data into your pipeline.

### get_kv_list
Retrieve all items from a specific KV store list. This lets you check the current state of your filter data.

### rpc_eth_call
Execute a message call on the blockchain without creating a transaction. This is perfect for testing smart contract logic.

### rpc_eth_getlogs
Get an array of logs that match a specific filter. Use this to find specific historical events on the chain.

### rpc_eth_gettransactionreceipt
Get the receipt for a specific transaction hash. This helps you confirm if a transaction succeeded or failed.

### create_webhook
Create a webhook using a pre-defined template. This sends real-time events like wallet filters to your endpoint.

### delete_kv_set
Remove a specific key-value pair from your KV store. Use this to clean up old configuration data.

### delete_stream
Remove an existing data stream. This helps you manage your infrastructure and avoid unnecessary costs.

### delete_webhook
Delete a specific webhook from your account. Use this when a listener is no longer needed.

### get_kv_set
Retrieve a specific value from a KV store set. Use this to quickly pull a single configuration piece.

### get_stream
Get the details of a specific data stream. This helps you verify that a stream is running with the right settings.

### list_streams
List every active stream in your QuickNode account. Use this to get a bird's-eye view of your data pipelines.

### list_webhooks
List all your active webhooks. This is useful for auditing your event listeners across different chains.

### rpc_eth_blocknumber
Get the most recent block number from the Ethereum network. This provides a quick way to check current chain status.

### update_kv_list
Add or remove items from an existing KV store list. Use this to dynamically update your stream filtering logic.

### update_stream
Update the configuration of an existing data stream. This lets you change parameters without deleting and recreating the stream.

### create_kv_list
Create a new list in your KV store. This helps you manage structured data for stream filtering.

## Prompt Examples

**Prompt:** 
```
List all my active QuickNode streams.
```

**Response:** 
```
| Stream Name | ID | Status |
| :--- | :--- | :--- |
| **Mainnet-Ingest** | `st_123` | Active
| **Polygon-Archive** | `st_456` | Active

I've retrieved your streams. You have 2 active streams. Would you like the details for one of them?
```

**Prompt:** 
```
Create a new webhook for EVM wallet filtering using the template 'evmWalletFilter'.
```

**Response:** 
```
I'm ready to create that webhook for you. Please provide the **configuration JSON** containing the specific wallet addresses you want to monitor.
```

**Prompt:** 
```
What is the current block number on the network?
```

**Response:** 
```
The most recent block number on the connected network is **18,452,910**.
```

## Capabilities

### Create blockchain data streams
Spin up new data pipelines to ingest live or historical blockchain information.

### Deploy event webhooks
Set up real-time listeners for contract events or wallet filters using pre-built templates.

### Manage KV filtering stores
Create and update key-value pairs to power advanced logic for your data streams.

### Query live blockchain data
Retrieve current block numbers and execute message calls to interact with the chain.

### Audit infrastructure
List all active webhooks and streams to keep your Web3 environment organized.

### Retrieve transaction logs
Get specific transaction receipts and filtered log arrays for debugging and tracking.

## Use Cases

### Tracking specific whale movements
A developer needs to track a specific wallet. They ask the agent to create a webhook using the evmWalletFilter template and provide the address.

### Ingesting historical chain data
A data team needs to ingest historical data. They tell the agent to create a stream for a specific range and list the active streams to confirm.

### Verifying transaction success
A dev wants to check if a transaction worked. They give the agent a hash and ask it to get the receipt using rpc_eth_gettransactionreceipt.

### Updating dynamic filtering rules
A team needs to update filtering rules. They ask the agent to update a KV list to include new blocked addresses for their data stream.

## Benefits

- Automate data ingestion by creating streams with create_stream instead of manual configuration.
- Deploy event listeners instantly using create_webhook templates for things like wallet filters.
- Manage complex filtering logic with create_kv_list and update_kv_list to keep your data pipelines organized.
- Audit your entire infrastructure at a glance using list_streams and list_webhooks.
- Test smart contract interactions safely with rpc_eth_call to see results before committing to a transaction.
- Monitor transaction statuses and logs quickly with rpc_eth_getlogs and rpc_eth_gettransactionreceipt.

## How It Works

The bottom line is you get a natural language interface for your entire QuickNode blockchain infrastructure.

1. Connect your QuickNode API key and RPC URL to the Connector.
2. Tell your agent what kind of data stream or webhook you need to build.
3. The agent executes the configuration and confirms the infrastructure is live.

## Frequently Asked Questions

**What can I do with the QuickNode MCP for AI Agents?**
You can manage your blockchain data streams, deploy webhooks for events, and interact with RPC nodes like Ethereum. It turns your AI agent into a command center for your Web3 infrastructure.

**Can the QuickNode MCP for AI Agents set up webhooks for me?**
Yes. You can ask your agent to deploy webhooks using pre-defined templates for things like wallet filters or contract events, and it will handle the configuration for you.

**How does the QuickNode MCP for AI Agents handle blockchain data?**
It manages data ingestion through streams and allows for real-time queries. You can create, list, and update streams to pull live or historical data into your app.

**Can I use the QuickNode MCP for AI Agents to filter my data?**
Yes. By using the KV store tools, you can manage key-value pairs that power advanced filtering logic for your data streams, making your data ingestion more precise.

**Is the QuickNode MCP for AI Agents good for data engineers?**
It's built for them. It allows data engineers to orchestrate complex blockchain data pipelines and infrastructure updates using natural language instead of manual dashboard entries.

**Does the QuickNode MCP for AI Agents support Ethereum?**
Yes, it includes several Ethereum-specific RPC tools for checking block numbers, getting transaction receipts, and executing message calls.

**How do I check the current block height on Ethereum?**
You can use the `rpc_eth_blocknumber` tool. It will return the most recent block number from the blockchain network connected to your RPC URL.

**Can I create a stream to monitor specific blockchain datasets?**
Yes, use the `create_stream` tool. You can specify the dataset (e.g., 'block', 'traces') and the destination (e.g., 'webhook', 's3') to start ingesting data immediately.

**How do I manage lists for my stream filters?**
Use the `create_kv_list` tool to initialize a list and `update_kv_list` to add or remove items. These lists can be referenced in your Streams JavaScript filter functions.