# The Graph (Web3 Indexing) MCP for AI Agents AI Agent Connect

> The Graph (Web3 Indexing) lets your AI agent query real-time blockchain data from Ethereum, Polygon, and Solana. It pulls token transfers, holder lists, and DEX swaps from custom subgraphs or specific network tools without you having to manually dig through block explorers.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_lKCcPQtDzEbLkEyQdpLNknTGhTDgro8TIiVVYvos/ai-agent-connect
- **Tags:** web3, ethereum, solana, graphql, indexing, defi

## Description

This Connector connects your AI agent to The Graph, giving it a direct line to real-time blockchain data across the EVM and Solana ecosystems. Instead of hunting through messy block explorers or manually constructing complex GraphQL queries, you can just ask your agent to pull the info you need. It handles the heavy lifting of fetching token transfers, holder lists, and DEX swap events from platforms like Uniswap, Curve, Jupiter, and Raydium. Whether you're trying to track a specific whale's movements, monitor liquidity pool activity, or pull historical balance changes to analyze a portfolio's performance, the data comes back in a structured, easy-to-read format. It works by querying specific subgraphs or using dedicated tools for common tasks like finding top holders on Solana or swap history on Polygon. This makes it a core part of the Vinkius catalog for anyone who needs to move from raw data to actual insights without the manual friction. You get to spend your time on the analysis while the Connector handles the retrieval. You don't have to worry about the technical hurdles of different chain architectures or the headache of managing multiple API calls for different protocols. The data is ready for you as soon as you ask for it, allowing for much faster research and more accurate monitoring of the decentralized finance space.

## Tools

### get_evm_transfers
Fetches token transfer history for any EVM-compatible blockchain. This is useful for tracking large movements of assets.

### query_subgraph
Runs custom GraphQL queries against any specific subgraph ID for specialized data. Use this for deep dives into niche project metrics.

### get_svm_holders
Retrieves the list of token holders for assets on the Solana network. This lets you identify major players in the Solana ecosystem.

### get_svm_swaps
Pulls DEX swap activity for Solana tokens from platforms like Jupiter and Raydium. This tracks real-time trading on the Solana network.

### get_svm_transfers
Tracks token movements and transfers across the Solana network. Use this to follow the flow of assets on the SVM.

### get_evm_historical_balances
Pulls past balance data for tokens on EVM chains to track portfolio history. Use this to see how a wallet's holdings have changed over time.

### get_evm_holders
Identifies the top wallet addresses holding a specific token on EVM networks. This helps you quickly see the distribution of a token.

### get_evm_swaps
Fetches DEX swap events from platforms like Uniswap and Curve on EVM chains. It's great for monitoring trading volume on specific protocols.

## Prompt Examples

**Prompt:** 
```
Who are the top 10 holders for the token at 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9?
```

**Response:** 
```
I've pulled the top 10 holders for that EVM token. The largest holder owns about 12.4% of the supply. Here is the breakdown of the top 5 addresses:

| Rank | Address | Balance |
|---|---|---|
| 1 | 0x123...abc | 12.4% |
| 2 | 0x456...def | 8.2% |
| 3 | 0x789...ghi | 5.1% |
```

**Prompt:** 
```
Show me recent swaps for the Solana token DezXAZ8z7PnrnMcFWRSTQC8PGL9P8be3EFr9SptT5v7.
```

**Response:** 
```
I found 15 recent swap events for that token on Solana. The biggest one was a 500 SOL trade on Raydium. Most of the activity is happening on Jupiter. Would you like me to look into the price impact?
```

**Prompt:** 
```
Query the Uniswap V3 subgraph for ID 'ELUvFp...' to get the latest pool prices.
```

**Response:** 
```
I've queried the Uniswap V3 subgraph. The ETH/USDC pool is currently trading at $2,450.32 with a 24h volume of $12M. Let me know if you want to check other pools.
```

## Capabilities

### Get EVM historical balances
Pull past balance data for tokens on EVM chains to track portfolio history.

### Get EVM token holders
Identify the top wallet addresses holding a specific token on EVM networks.

### Get EVM DEX swaps
Fetch DEX swap events from platforms like Uniswap and Curve on EVM chains.

### Query custom subgraphs
Run custom GraphQL queries against any specific subgraph ID for specialized data.

### Get SVM token holders
Retrieve the list of token holders for assets on the Solana network.

### Get SVM DEX swaps
Pull DEX swap activity for Solana tokens from platforms like Jupiter and Raydium.

### Get SVM token transfers
Track token movements and transfers across the Solana network.

### Get EVM token transfers
Fetch token transfer history for any EVM-compatible blockchain.

## Use Cases

### Tracking Whale Activity
A researcher wants to know who owns the most of a new token. They ask the agent to find the top 50 holders using get_evm_holders.

### Debugging Contract Events
A developer needs to see if a specific swap happened on Uniswap. They ask the agent to check recent swap data using get_evm_swaps.

### Liquidity Analysis
An analyst wants to see how much volume a pool had. They query a specific subgraph for the last 24 hours using query_subgraph.

### Portfolio Tracking
A user wants to see how their balance changed after a migration. They ask for historical balance changes using get_evm_historical_balances.

## Benefits

- Stop manually searching block explorers. Use get_evm_swaps and get_svm_swaps to see DEX activity across different networks instantly.
- Analyze portfolio history faster. get_evm_historical_balances lets you see how balances changed over time without doing the math yourself.
- Get deep data with precision. Use query_subgraph to pull very specific metrics that standard tools usually miss.
- Monitor whale movements easily. Use get_evm_holders and get_svm_holders to identify major players in any token's distribution.
- Simplify multi-chain research. Track transfers on both EVM and Solana using get_evm_transfers and get_svm_transfers in one place.

## How It Works

The bottom line is you get instant access to structured blockchain data without writing your own GraphQL queries.

1. Subscribe to the Connector and provide your The Graph API keys.
2. Connect your AI client like Claude or Cursor.
3. Ask questions in plain English to fetch on-chain data.

## Frequently Asked Questions

**How does The Graph (Web3 Indexing) work for my AI?**
It connects your AI to a data layer that organizes blockchain information. You can ask questions in plain English and the AI uses the Connector to pull the data for you.

**Can The Graph (Web3 Indexing) fetch data from Solana?**
Yes, it includes specific tools for Solana transfers and swaps, allowing you to query the SVM network just as easily as EVM chains.

**Do I need to write GraphQL to use The Graph (Web3 Indexing)?**
No, you don't have to write any code. The Connector handles the GraphQL queries for you based on the natural language requests you give your AI client.

**Is The Graph (Web3 Indexing) suitable for Ethereum research?**
Yes, it supports EVM-compatible chains including Ethereum and Polygon, making it a great choice for multi-chain research.

**Can The Graph (Web3 Indexing) find top token holders?**
Yes, it has dedicated tools to identify the top holders for tokens on both EVM and Solana networks.

**Does The Graph (Web3 Indexing) provide real-time data?**
It provides the latest available data indexed by The Graph, giving you up-to-date information on swaps, transfers, and holder distributions.

**Can I query any specific subgraph if I have its ID?**
Yes! Use the `query_subgraph` tool by providing the `subgraph_id` and your GraphQL `query` string. This allows for deep, custom data extraction beyond the standard tools.

**Does this server support Solana token data?**
Absolutely. You can use `get_svm_transfers`, `get_svm_holders`, and `get_svm_swaps` to interact with SPL tokens and decentralized exchanges on the Solana network.

**Can I track historical balance changes for a specific wallet?**
Yes, the `get_evm_historical_balances` tool provides historical balance data in OHLCV format for EVM chains, making it easy to analyze portfolio trends.