helius-mcp 0.5.0 → 0.5.2

package/README.md

@@ -13,13 +13,15 @@ Set your API key:
 export HELIUS_API_KEY=your-api-key
 ```
 
-## Tools (29)
+## Tools (48)
+
+**Config (2):** setHeliusApiKey, getHeliusApiKeyStatus
 
 **DAS API (12):** getAsset, getAssetBatch, getAssetsByOwner, getAssetsByGroup, getAssetsByCreator, getAssetsByAuthority, searchAssets, getAssetProof, getAssetProofBatch, getSignaturesForAsset, getNftEditions, getTokenAccounts
 
-**RPC (4):** getBalance, getAccountInfo, getMultipleAccounts, getSignaturesForAddress
+**RPC (7):** getBalance, getTokenBalances, getAccountInfo, getProgramAccounts, getNetworkStatus, getBlock, getTokenHolders
 
-**Transactions (1):** parseTransactions
+**Transactions (2):** parseTransactions, getTransactionHistory
 
 **Priority Fees (1):** getPriorityFeeEstimate
 
@@ -29,11 +31,23 @@ export HELIUS_API_KEY=your-api-key
 
 **Laserstream gRPC (2):** laserstreamSubscribe, getLaserstreamInfo
 
-**Config (1):** setHeliusApiKey
+**Wallet API (6):** getWalletIdentity, batchWalletIdentity, getWalletBalances, getWalletHistory, getWalletTransfers, getWalletFundedBy
+
+**Plans & Guides (8):** getHeliusPlanInfo, compareHeliusPlans, getRateLimitInfo, getSenderInfo, getWebhookGuide, troubleshootError, getLatencyComparison, getPumpFunGuide
+
+**Documentation (3):** lookupHeliusDocs, listHeliusDocTopics, getHeliusCreditsInfo
 
 ## Networks
 
-Mainnet Beta and Devnet. Set via `HELIUS_NETWORK` env var.
+Mainnet and Devnet. Set via `HELIUS_NETWORK` env var or use the `network` parameter in `setHeliusApiKey`.
+
+## Development
+
+```bash
+pnpm install
+pnpm build
+pnpm test
+```
 
 ## Docs
 

package/dist/tools/config.js

@@ -10,8 +10,8 @@ export function registerConfigTools(server) {
                 content: [{
                         type: 'text',
                         text: fromEnv
-                            ? '✅ API key is configured via environment variable. Ready to use all Helius tools!'
-                            : '✅ API key is configured for this session. Ready to use all Helius tools!'
+                            ? 'API key is configured via environment variable. Ready to use all Helius tools.'
+                            : 'API key is configured for this session. Ready to use all Helius tools.'
                     }]
             };
         }
@@ -19,7 +19,7 @@ export function registerConfigTools(server) {
             content: [{
                     type: 'text',
                     text: [
-                        '⚠️ No Helius API key configured.',
+                        'No Helius API key configured.',
                         '',
                         'To use Helius data tools, you need to set an API key:',
                         '',
@@ -44,7 +44,7 @@ export function registerConfigTools(server) {
     });
     server.tool('setHeliusApiKey', 'Set the Helius API key for the current session. Required before using data tools (getBalance, getAsset, etc.). Get your free API key at https://dashboard.helius.dev/api-keys', {
         apiKey: z.string().describe('Your Helius API key from https://dashboard.helius.dev/api-keys'),
-        network: z.enum(['mainnet-beta', 'devnet']).optional().default('mainnet-beta').describe('Network to use (default: mainnet-beta)')
+        network: z.enum(['mainnet', 'devnet']).optional().default('mainnet').describe('Network to use (default: mainnet)')
     }, async ({ apiKey, network }) => {
         setApiKey(apiKey);
         if (network) {
@@ -63,7 +63,7 @@ export function registerConfigTools(server) {
                     content: [{
                             type: 'text',
                             text: [
-                                '❌ Invalid API key. The key was rejected by the Helius API.',
+                                'Invalid API key. The key was rejected by the Helius API.',
                                 '',
                                 'Please check your key and try again.',
                                 '',
@@ -78,7 +78,11 @@ export function registerConfigTools(server) {
             content: [{
                     type: 'text',
                     text: [
-                        `✅ Helius API key configured for ${network}!`,
+                        `Helius API key configured. (default network: ${network})`,
+                        '',
+                        'Your API key works for both mainnet and devnet. To switch networks:',
+                        '- mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_KEY',
+                        '- devnet: https://devnet.helius-rpc.com/?api-key=YOUR_KEY',
                         '',
                         'You can now use all Helius tools:',
                         '- getBalance, getTokenBalances - Check wallet balances',

package/dist/tools/guides.js

@@ -296,8 +296,8 @@ export function registerGuideTools(server) {
             '',
             '| Feature | Helius Sender | Direct Jito |',
             '|---------|---------------|-------------|',
-            '| SWQoS | ✅ Included | ❌ No |',
-            '| Jito Bundles | ✅ Auto-bundled | ✅ Manual |',
+            '| SWQoS | Included | No |',
+            '| Jito Bundles | Auto-bundled | Manual |',
             '| Tips | Helius handles | You manage |',
             '| Setup | Use Helius RPC | Separate integration |',
             '',

package/dist/tools/plans.js

@@ -126,18 +126,18 @@ function formatPlanDetails(planKey) {
         `- Enhanced WebSocket Connections: ${plan.connections.enhancedWebsocket}`,
         '',
         '### Features',
-        `- Webhooks: ${plan.features.webhooks ? '✅' : '❌'}`,
-        `- Standard WebSockets: ${plan.features.standardWebSockets ? '✅' : '❌'}`,
-        `- Enhanced WebSockets: ${typeof plan.features.enhancedWebSockets === 'string' ? plan.features.enhancedWebSockets : plan.features.enhancedWebSockets ? '✅' : '❌'}`,
-        `- Laserstream: ${typeof plan.features.laserstream === 'string' ? plan.features.laserstream : plan.features.laserstream ? '✅' : '❌'}`,
-        `- Staked Connections: ${plan.features.stakedConnections ? '✅' : '❌'}`,
-        `- Archival Data: ${plan.features.archivalData ? '✅' : '❌'}`,
+        `- Webhooks: ${plan.features.webhooks ? 'Yes' : 'No'}`,
+        `- Standard WebSockets: ${plan.features.standardWebSockets ? 'Yes' : 'No'}`,
+        `- Enhanced WebSockets: ${typeof plan.features.enhancedWebSockets === 'string' ? plan.features.enhancedWebSockets : plan.features.enhancedWebSockets ? 'Yes' : 'No'}`,
+        `- Laserstream: ${typeof plan.features.laserstream === 'string' ? plan.features.laserstream : plan.features.laserstream ? 'Yes' : 'No'}`,
+        `- Staked Connections: ${plan.features.stakedConnections ? 'Yes' : 'No'}`,
+        `- Archival Data: ${plan.features.archivalData ? 'Yes' : 'No'}`,
     ];
     if ('soc2Compliance' in plan.features) {
-        lines.push(`- SOC 2 Compliance: ✅`);
+        lines.push(`- SOC 2 Compliance: Yes`);
     }
     if ('customInfrastructure' in plan.features) {
-        lines.push(`- Custom Infrastructure: ✅`);
+        lines.push(`- Custom Infrastructure: Yes`);
     }
     lines.push('', '### Support');
     lines.push(`- Channel: ${plan.support}`);
@@ -161,8 +161,8 @@ export function registerPlanTools(server) {
                     '| **sendTransaction** | 1/s | 5/s | 50/s | 100/s |',
                     '| **DAS Requests** | 2/s | 10/s | 50/s | 100/s |',
                     '| **WS Connections** | 5 | 150 | 250 | 250 |',
-                    '| **Enhanced WS** | ❌ | ❌ | ✅ (100) | ✅ (100) |',
-                    '| **Laserstream** | ❌ | Devnet | Devnet | Full |',
+                    '| **Enhanced WS** | No | No | Yes (100) | Yes (100) |',
+                    '| **Laserstream** | No | Devnet | Devnet | Full |',
                     '| **Support SLA** | — | 24hr | 12hr | 8hr |',
                     '',
                     '---',
@@ -231,9 +231,9 @@ export function registerPlanTools(server) {
                 lines.push('|------|-------------|-------------|--------|----------|');
                 for (const p of plansToCompare) {
                     const plan = HELIUS_PLANS[p];
-                    const ews = typeof plan.features.enhancedWebSockets === 'string' ? plan.features.enhancedWebSockets : plan.features.enhancedWebSockets ? '✅' : '❌';
-                    const ls = typeof plan.features.laserstream === 'string' ? plan.features.laserstream : plan.features.laserstream ? '✅' : '❌';
-                    lines.push(`| ${plan.name} | ${ews} | ${ls} | ✅ | ✅ |`);
+                    const ews = typeof plan.features.enhancedWebSockets === 'string' ? plan.features.enhancedWebSockets : plan.features.enhancedWebSockets ? 'Yes' : 'No';
+                    const ls = typeof plan.features.laserstream === 'string' ? plan.features.laserstream : plan.features.laserstream ? 'Yes' : 'No';
+                    lines.push(`| ${plan.name} | ${ews} | ${ls} | Yes | Yes |`);
                 }
                 break;
             case 'connections':

package/dist/tools/transactions.js

@@ -212,7 +212,7 @@ export function registerTransactionTools(server) {
             const feeDisplay = tx.fee
                 ? `${formatSol(tx.fee)} (${tx.fee.toLocaleString()} lamports)`
                 : 'N/A';
-            outputLines.push(`**Transaction: ${tx.signature}**`, '', `**Type:** ${tx.type || 'UNKNOWN'}`, `**Source:** ${tx.source || 'N/A'}`, `**Fee:** ${feeDisplay}`, `**Fee Payer:** ${tx.feePayer || 'N/A'}`, `**Timestamp:** ${tx.timestamp ? formatTimestamp(tx.timestamp) : 'N/A'}`, `**Status:** ${tx.transactionError ? '❌ Failed' : '✅ Success'}`);
+            outputLines.push(`**Transaction: ${tx.signature}**`, '', `**Type:** ${tx.type || 'UNKNOWN'}`, `**Source:** ${tx.source || 'N/A'}`, `**Fee:** ${feeDisplay}`, `**Fee Payer:** ${tx.feePayer || 'N/A'}`, `**Timestamp:** ${tx.timestamp ? formatTimestamp(tx.timestamp) : 'N/A'}`, `**Status:** ${tx.transactionError ? 'Failed' : 'Success'}`);
             // Show error details for failed transactions
             if (tx.transactionError) {
                 let errDetail;
@@ -442,7 +442,7 @@ export function registerTransactionTools(server) {
                     }
                     const lines = [`**Signatures for ${formatAddress(address)}** (${sigs.length} results, newest first${statusNote})`, ''];
                     sigs.forEach((sig) => {
-                        const sigStatus = sig.err ? '❌' : '✅';
+                        const sigStatus = sig.err ? '[FAILED]' : '[OK]';
                         const time = sig.blockTime ? new Date(sig.blockTime * 1000).toISOString() : 'N/A';
                         lines.push(`${sigStatus} ${sig.signature}`);
                         lines.push(`   Slot: ${sig.slot.toLocaleString()} | Time: ${time}`);
@@ -495,7 +495,7 @@ export function registerTransactionTools(server) {
             const orderLabel = sortOrder === 'asc' ? 'oldest first' : 'newest first';
             const lines = [`**Signatures for ${formatAddress(address)}** (${items.length} results, ${orderLabel}${statusNote})`, ''];
             items.forEach((item) => {
-                const txStatus = item.err ? '❌' : '✅';
+                const txStatus = item.err ? '[FAILED]' : '[OK]';
                 const time = item.blockTime ? new Date(item.blockTime * 1000).toISOString() : 'N/A';
                 lines.push(`${txStatus} ${item.signature}`);
                 lines.push(`   Slot: ${item.slot.toLocaleString()} | Time: ${time}`);
@@ -544,7 +544,7 @@ export function registerTransactionTools(server) {
             if (transactionDetails === 'signatures') {
                 const items = result.data;
                 items.forEach((item) => {
-                    const txStatus = item.err ? '❌' : '✅';
+                    const txStatus = item.err ? '[FAILED]' : '[OK]';
                     const time = item.blockTime ? new Date(item.blockTime * 1000).toISOString() : 'N/A';
                     lines.push(`${txStatus} ${item.signature}`);
                     lines.push(`   Slot: ${item.slot.toLocaleString()} | Index: ${item.transactionIndex} | Time: ${time}`);
@@ -557,7 +557,7 @@ export function registerTransactionTools(server) {
                 const items = result.data;
                 items.forEach((item) => {
                     const sig = item.transaction.signatures[0];
-                    const txStatus = item.meta.err ? '❌' : '✅';
+                    const txStatus = item.meta.err ? '[FAILED]' : '[OK]';
                     const time = item.blockTime ? new Date(item.blockTime * 1000).toISOString() : 'N/A';
                     const fee = formatSol(item.meta.fee);
                     lines.push(`${txStatus} ${sig}`);
@@ -643,7 +643,7 @@ export function registerTransactionTools(server) {
         const lines = [`**Transaction History for ${formatAddress(address)}** (${allTransactions.length} transactions, ${orderLabel}${statusNote})`, ''];
         allTransactions.forEach((tx) => {
             const time = tx.timestamp ? formatTimestamp(tx.timestamp) : 'N/A';
-            const txStatus = tx.transactionError ? '❌' : '✅';
+            const txStatus = tx.transactionError ? '[FAILED]' : '[OK]';
             const type = tx.type || 'UNKNOWN';
             const source = tx.source || '';
             lines.push(`${txStatus} **${type}**${source ? ` (${source})` : ''} - ${time}`);

package/dist/tools/webhooks.js

@@ -28,7 +28,7 @@ export function registerWebhookTools(server) {
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
             return {
-                content: [{ type: 'text', text: `❌ Error: ${errorMsg}` }],
+                content: [{ type: 'text', text: `Error: ${errorMsg}` }],
                 isError: true
             };
         }
@@ -61,7 +61,7 @@ export function registerWebhookTools(server) {
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
             return {
-                content: [{ type: 'text', text: `❌ Error: ${errorMsg}` }],
+                content: [{ type: 'text', text: `Error: ${errorMsg}` }],
                 isError: true
             };
         }
@@ -86,14 +86,14 @@ export function registerWebhookTools(server) {
             return {
                 content: [{
                         type: 'text',
-                        text: `✅ **Webhook Created**\n\n**ID:** ${webhook.webhookID}\n**URL:** ${webhook.webhookURL}\n**Monitoring:** ${accountAddresses.length} address(es)`
+                        text: `**Webhook Created**\n\n**ID:** ${webhook.webhookID}\n**URL:** ${webhook.webhookURL}\n**Monitoring:** ${accountAddresses.length} address(es)`
                     }]
             };
         }
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
             return {
-                content: [{ type: 'text', text: `❌ Error: ${errorMsg}` }],
+                content: [{ type: 'text', text: `Error: ${errorMsg}` }],
                 isError: true
             };
         }
@@ -127,14 +127,14 @@ export function registerWebhookTools(server) {
             return {
                 content: [{
                         type: 'text',
-                        text: `✅ **Webhook Updated**\n\n**ID:** ${webhook.webhookID}\n**URL:** ${webhook.webhookURL}`
+                        text: `**Webhook Updated**\n\n**ID:** ${webhook.webhookID}\n**URL:** ${webhook.webhookURL}`
                     }]
             };
         }
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
             return {
-                content: [{ type: 'text', text: `❌ Error: ${errorMsg}` }],
+                content: [{ type: 'text', text: `Error: ${errorMsg}` }],
                 isError: true
             };
         }
@@ -149,14 +149,14 @@ export function registerWebhookTools(server) {
             return {
                 content: [{
                         type: 'text',
-                        text: `✅ Webhook ${webhookID} deleted successfully.`
+                        text: `Webhook ${webhookID} deleted successfully.`
                     }]
             };
         }
         catch (err) {
             const errorMsg = err instanceof Error ? err.message : String(err);
             return {
-                content: [{ type: 'text', text: `❌ Error: ${errorMsg}` }],
+                content: [{ type: 'text', text: `Error: ${errorMsg}` }],
                 isError: true
             };
         }

package/dist/utils/formatters.d.ts

@@ -4,3 +4,4 @@ export declare function formatAddress(address: string): string;
 export declare function formatTimestamp(unixTime: number): string;
 export declare function formatTokenAmount(amount: number, decimals: number): string;
 export declare function formatSolCompact(lamports: number): string;
+export declare function getOrbExplorerUrl(addressOrSignature: string, type?: 'address' | 'tx'): string;

package/dist/utils/formatters.js

@@ -18,3 +18,6 @@ export function formatTokenAmount(amount, decimals) {
 export function formatSolCompact(lamports) {
     return `${(lamports / LAMPORTS_PER_SOL).toLocaleString(undefined, { maximumFractionDigits: 0 })} SOL`;
 }
+export function getOrbExplorerUrl(addressOrSignature, type = 'address') {
+    return `https://orbmarkets.io/${type}/${addressOrSignature}`;
+}

package/dist/utils/helius.d.ts

@@ -3,8 +3,8 @@ export declare function setApiKey(apiKey: string): void;
 export declare function getApiKey(): string;
 export declare function hasApiKey(): boolean;
 export declare function getHeliusClient(): HeliusClient;
-export declare function setNetwork(network: 'mainnet-beta' | 'devnet'): void;
-export declare function getNetwork(): 'mainnet-beta' | 'devnet';
+export declare function setNetwork(network: 'mainnet' | 'devnet'): void;
+export declare function getNetwork(): 'mainnet' | 'devnet';
 export declare function getRpcUrl(): string;
 export declare function getEnhancedWebSocketUrl(): string;
 export declare function getLaserstreamUrl(region?: 'ewr' | 'pitt' | 'slc' | 'lax' | 'lon' | 'ams' | 'fra' | 'tyo' | 'sgp'): string;

package/dist/utils/helius.js

@@ -1,6 +1,6 @@
 import { createHelius } from 'helius-sdk';
 let sessionApiKey = null;
-let sessionNetwork = 'mainnet-beta';
+let sessionNetwork = 'mainnet';
 let heliusClient = null;
 export function setApiKey(apiKey) {
     sessionApiKey = apiKey;
@@ -31,7 +31,7 @@ export function setNetwork(network) {
 }
 export function getNetwork() {
     const envNetwork = process.env.HELIUS_NETWORK;
-    if (envNetwork === 'devnet' || envNetwork === 'mainnet-beta') {
+    if (envNetwork === 'devnet' || envNetwork === 'mainnet') {
         return envNetwork;
     }
     return sessionNetwork;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helius-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Official Helius MCP Server - Complete Solana blockchain data access for Claude",
   "type": "module",
   "main": "dist/index.js",
@@ -12,13 +12,7 @@
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "prepublishOnly": "pnpm build",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:unit": "vitest run tests/unit",
-    "test:integration": "vitest run tests/integration",
-    "test:e2e": "vitest run tests/e2e",
-    "test:live": "vitest run tests/live",
-    "test:coverage": "vitest run --coverage"
+    "test": "vitest run"
   },
   "keywords": [
     "helius",