# Web3 Indexing MCP

> The Graph (Web3 Indexing) gives your agent direct access to real-time blockchain data across major chains like Ethereum, Polygon, and Solana. It lets you query everything from token transfers and wallet holders to complex DEX swap events using standardized tools and custom GraphQL subgraphs. Stop guessing what's on the chain; start querying it directly.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** web3, ethereum, solana, graphql, indexing, defi

## Description

This MCP connects your AI agent directly to decentralized ledger data. You can pull historical and real-time information across multiple major ecosystems, including EVM chains like Ethereum and Solana. Instead of opening a dozen different block explorer tabs, you use standardized tools to query specific actions. Need to know who holds the most tokens for a particular asset? Use the tool designed to get those top holders. Want to track how much an address's balance changed over months? You can pull historical records formatted for analysis. Even if your data is highly specialized, running raw GraphQL queries against custom subgraphs gives you deep control over what information you retrieve. It’s a huge amount of on-chain intelligence made available through simple commands, which Vinkius hosts and manages so any MCP-compatible client can use it right away.

## Tools

### get_evm_historical_balances
Retrieves the balance changes for a specific address on an EVM-compatible chain over time.

### get_evm_holders
Gets a list of all token holders and their respective balances on any EVM chain.

### get_evm_swaps
Retrieves records detailing DEX swaps that occurred on an EVM-compatible chain.

### get_evm_transfers
Gets a comprehensive list of all token transfers for a given asset on an EVM chain.

### query_subgraph
Allows you to run custom GraphQL queries against any specific subgraph ID using your API key.

### get_svm_holders
Retrieves a list of token holders and their balances on the Solana (SVM) network.

### get_svm_swaps
Gets records detailing DEX swaps that occurred specifically on the Solana network.

### get_svm_transfers
Retrieves a comprehensive list of all token transfers for a given asset on the Solana (SVM) network.

## Prompt Examples

**Prompt:** 
```
Get the top 10 holders for the EVM token at 0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9.
```

**Response:** 
```
I've retrieved the top holders for the specified token. The largest holder currently controls 12.4% of the supply, followed by a major exchange wallet with 8.2%. Would you like to see the full list of addresses and balances?
```

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

**Response:** 
```
I found 15 recent swap events for that token on Solana. The most significant was a 500 SOL trade on Raydium. Most activity is currently concentrated on Jupiter. Should I analyze the price impact of these trades?
```

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

**Response:** 
```
Executing GraphQL query on the Uniswap V3 subgraph... I've successfully fetched the latest price data. The ETH/USDC pool is currently trading at $2,450.32 with $12M in 24h volume. Do you need details on any other specific pool?
```

## Capabilities

### Track token movements
It fetches detailed records of every token transfer that happened across specified EVM or Solana chains.

### Identify major asset holders
You get comprehensive lists and counts of wallets holding specific tokens on both EVM and Solana networks.

### Analyze decentralized swaps (DEX)
It gathers records detailing token swaps that occurred on popular automated market makers like Uniswap or Raydium.

### Review historical balances
You pull time-series data showing how an address's balance changed over a specific period, perfect for portfolio tracking.

### Execute custom queries
It allows you to run raw, specialized GraphQL requests against any existing subgraph ID for unique data points.

## Use Cases

### Determining market dominance of an asset
A researcher asks their agent: 'Who controls the most tokens for Asset X?' The agent uses get_evm_holders to pull a list, quickly identifying the largest wallet and determining if concentration risk is high.

### Tracking rapid arbitrage activity
A trader needs to know about recent price discrepancies. They ask their agent to run get_svm_swaps and get_evm_swaps, comparing the volume of swaps on two different chains in minutes.

### Auditing a contract's lifecycle
A developer needs to verify if funds moved correctly. They use get_evm_transfers and then query_subgraph with specific parameters to trace the full movement path of the asset.

### Measuring investment growth over quarters
An analyst wants a quarterly report on portfolio performance. The agent executes multiple calls to get_evm_historical_balances, compiling the necessary time-series data points for the final document.

## Benefits

- Instantly track all token movements using get_evm_transfers or get_svm_transfers. You don't have to manually check multiple block explorers; your agent just runs the tool.
- Pinpoint market concentration by listing top holders with get_evm_holders and get_svm_holders, giving you immediate insight into asset distribution.
- Analyze trading activity across major DEXs. Whether it’s getting_evm_swaps or get_svm_swaps, the data is structured so your agent can interpret volume instantly.
- Go beyond standard queries. The query_subgraph tool lets you hit niche subgraphs for specialized metrics—something general tools can't touch.
- Understand portfolio performance over time by using get_evm_historical_balances, which provides change data in a format ready for spreadsheet analysis.

## How It Works

The bottom line is that it turns complex, multi-chain blockchain reads into simple commands for your AI client.

1. Subscribe to this MCP and provide your Graph API Token, URL, and key details.
2. Your AI client calls the specific tool, telling it exactly what chain (EVM or Solana) and what type of data you need (e.g., 'swaps' or 'holders').
3. The MCP executes the request against the live blockchain indexer and returns a structured list of data points to your agent.

## Frequently Asked Questions

**Can The Graph (Web3 Indexing) MCP handle both Ethereum and Solana transactions?**
Yes, it handles both. It provides distinct tools for EVM chains (like get_evm_transfers) and specific tools for the Solana network (like get_svm_transfers), ensuring you get the right data source.

**What is the difference between getting_evm_holders and get_evm_transfers?**
get_evm_holders gives you a static list of who owns assets right now. get_evm_transfers provides an auditable history, showing every single movement that occurred over time.

**Do I need to know GraphQL when using query_subgraph?**
While the tool uses GraphQL internally, you don't need to be a developer. You just provide the specific subgraph ID and your agent executes the complex request for you.

**Does The Graph (Web3 Indexing) MCP track NFTs?**
Yes, it handles token data, which includes tracking unique assets. You can use various transfer tools to monitor the movement of NFT tokens across both EVM and Solana networks.

**How do I check historical performance with get_evm_historical_balances?**
You provide the specific token address and the desired time window. The tool returns a formatted, structured record of balance changes over that period, perfect for charting.