# Helius (Solana) MCP

> Helius (Solana) gives your AI agent real-time access to Solana blockchain data. It lets you pull asset metadata, check wallet balances with live USD pricing, track complete transaction history, and get precise network fee estimates directly through natural language queries.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** solana, rpc, blockchain-data, nft, web3, transaction-history

## Description

Need deep insights into the Solana blockchain without writing complex API calls? This MCP connects your AI client to Helius's robust data infrastructure. You can ask it anything about a wallet or an asset—from listing every owned token to calculating how much gas you'll need for a transaction.

It fetches detailed metadata for everything from fungible tokens to compressed NFTs, giving you full visibility into ownership and history. If your job involves crypto forensics or tracking complex digital assets, this is it. It lets you see a wallet’s complete balance sheet, including the USD value of all held assets, and track every incoming and outgoing transfer. Because Vinkius hosts this MCP in its catalog, you can connect it once from any AI client—be it your IDE or desktop app—and start querying Solana data immediately.

## Tools

### get_asset_batch
Retrieves the detailed information for multiple assets in a single API call.

### get_asset_proof
Generates a cryptographic proof (Merkle proof) specifically for compressed NFTs.

### get_asset
Pulls all specific metadata and details for one particular Solana asset.

### get_assets_by_owner
Lists every digital asset currently held by a specified wallet address.

### get_priority_fee_estimate
Calculates the precise priority fee needed for a transaction, based on current network conditions.

### get_token_accounts
Retrieves all token accounts associated with either a specific mint or owner address.

### get_transaction_history
Pulls an enhanced and detailed log of activity for a given blockchain address.

### get_wallet_balances
Gets the current token and NFT balances while also providing their equivalent USD value.

### get_wallet_funded_by
Identifies the original source or funding origin of a specific wallet address.

### get_wallet_history
Retrieves the complete and comprehensive transaction history log for an entire wallet.

### get_wallet_identity
Resolves a Solana address to known entities, such as associated domain names.

### get_wallet_transfers
Gathers all records of both incoming and outgoing token transfers for an account.

### parse_transactions
Takes raw, technical transaction data and converts it into plain English, human-readable statements.

### search_assets
Allows advanced filtering queries across the entire asset pool using criteria like collection or attributes.

## Prompt Examples

**Prompt:** 
```
What is the current balance and USD value of the wallet 86W9...?
```

**Response:** 
```
I've retrieved the balances for that wallet. It currently holds 15.5 SOL ($1,860), 500 USDC, and 3 NFTs. Total estimated value is $2,360.
```

**Prompt:** 
```
List all NFTs owned by 6p6... including their metadata.
```

**Response:** 
```
I found 12 assets for this owner. Notable items include 'Mad Lad #402' and 'Famous Fox #123'. Would you like the full metadata for any of these?
```

**Prompt:** 
```
What is the recommended priority fee for a transaction right now?
```

**Response:** 
```
Based on current network conditions, the 'Medium' priority fee is approximately 5,000 micro-lamports. For urgent transactions, 'High' is recommended at 25,000 micro-lamports.
```

## Capabilities

### List a wallet's entire asset portfolio
Find every NFT and token owned by a specific address.

### Determine live financial balances
Get the current holdings of an address, including real-time USD pricing for all assets.

### Track full transaction movements
Retrieve a complete log of all incoming and outgoing transfers for any wallet.

### Forecast network gas costs
Calculate the recommended priority fee needed to ensure your transaction processes quickly, even during peak congestion.

### Search assets by traits or collection
Query the blockchain for specific digital items using advanced filters like creator or attribute.

## Use Cases

### Investigating suspicious funding sources
A compliance officer needs to know where a newly funded wallet got its money. Instead of manually checking multiple records, they ask their agent to use get_wallet_funded_by and then check the transaction log using get_transaction_history. The agent immediately reports the original source.

### Auditing an NFT collection for ownership gaps
A PM needs to verify which owners hold a specific metadata trait across 10,000 assets. They instruct their AI client to use search_assets with advanced filtering. The agent returns a filtered list of addresses and the required asset details.

### Debugging contract deployment failure
A developer runs into an unknown transaction error. Instead of spending hours digging through raw data, they run parse_transactions on the failed payload. The agent immediately translates the cryptic codes into plain English, pointing out the specific issue.

### Tracking a complex cross-platform asset movement
A collector wants to know every item an address has ever owned. They ask their agent to use get_assets_by_owner, followed by get_token_accounts to confirm the underlying mints and total balances.

## Benefits

- Stop guessing about gas fees. Use get_priority_fee_estimate to calculate the exact network fee needed, ensuring your critical transactions process fast even when the chain is slammed with activity.
- Get a true picture of value instantly. The get_wallet_balances tool returns all token and NFT holdings alongside their current USD price, giving you an immediate, accurate portfolio valuation.
- Audit ownership effortlessly. Running get_assets_by_owner quickly lists every digital item owned by any address, letting analysts build comprehensive asset reports in seconds.
- Understand the flow of money better. You can use get_wallet_transfers and get_transaction_history together to map out exactly where funds are moving in or out of an account over time.
- Search without limits. When you need to find a specific type of digital collectible, search_assets lets you filter assets using advanced criteria like creator or collection name.

## How It Works

The bottom line is you get clean, actionable data about any Solana asset or wallet without leaving your preferred development environment.

1. Subscribe to this MCP and enter your Helius API Key within Vinkius.
2. Instruct your AI client (your agent) to analyze a specific Solana wallet address or asset ID.
3. The system runs the query against the blockchain data, returning structured results like balances, transaction logs, or metadata.

## Frequently Asked Questions

**Can Helius (Solana) MCP tell me the current dollar value of all NFTs?**
Yes, it can. Use get_wallet_balances to fetch both your token and NFT holdings, which are returned with their real-time USD valuations.

**What is the best way to check an address’s full transaction history using Helius (Solana) MCP?**
You should use get_wallet_history for a complete log of every activity. If you only care about token movement, use get_wallet_transfers.

**How do I find out if an address was funded by a specific source?**
Run the get_wallet_funded_by tool. This specifically identifies and reports on the original funding source of the wallet, giving you crucial compliance data.

**Does Helius (Solana) MCP help me estimate gas fees?**
Absolutely. Use get_priority_fee_estimate to calculate the precise network fee required for your transaction, ensuring it goes through efficiently even during heavy congestion.

**Can I find assets based on their collection or creator using Helius (Solana) MCP?**
Yes. The search_assets tool allows you to filter the entire asset pool using advanced parameters like a specific collection name, creator, or trait.