mcp -helius

This MCP server provides Claude with direct access to Solana blockchain data via the Helius API. It exposes a comprehensive set of tools categorized into basic blockchain operations, token operations, NFT and digital assets, blockchain system information, and transaction/fee methods. With these tools, Claude can query wallet balances, retrieve account and program information, fetch token accounts and token details, explore NFT assets and editions, obtain network epoch data and performance metrics, and even simulate or execute certain transactions or fee-related queries through the Helius-backed endpoints. To use it, configure Claude Desktop to point at the MCP server, then prompt Claude with natural language requests such as asking for a wallet’s balance, the current Solana block height, or assets owned by a particular address. Claude will route these requests through the MCP server to Helius and return structured results.

Prerequisites:

• Node.js v16 or higher
• npm (comes with Node.js) or npm ci support
• An active Helios API key from https://dev.helius.xyz/

Installation steps:

1. Clone the repository:

   git clone https://github.com/dcSpark/mcp-server-helius.git
   cd mcp-server-helius
   

2. Install dependencies:

   npm ci
   

3. Build the project:

   npm run build
   

4. Obtain your Helis API key and configure the server as described in the Configuration section to run locally or via npm/npx.

Optional: Run locally once built:

HELIUS_API_KEY=your-helius-api-key node build/index.js

Environment tips:

• Ensure HELIUS_API_KEY is kept secret and not checked into version control.
• If using Claude Desktop, ensure the mcpServers configuration in claude_desktop_config.json points to the correct command and args, and that the environment variable HELIUS_API_KEY is provided.
• The server relies on Helius for data; rate limits or API key permissions may affect response times. Monitor usage to avoid hitting limits.
• If you switch between local builds and npm-based runs, keep the same server name in Claude Desktop for a seamless transition.
• When updating the server, re-build and restart Claude Desktop integration to pick up changes.