helius-mcp 1.2.0 → 2.0.0

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+## [helius-mcp@1.3.0](https://github.com/helius-labs/core-ai/compare/helius-mcp@1.2.0...helius-mcp@1.3.0) - 2026-03-12
+
+### Merged
+
+- feat(skills): Add Skill Versioning [`#61`](https://github.com/helius-labs/core-ai/pull/61)
+- fix(mcp): Add Escalating Retry Guidance For Agents [`#60`](https://github.com/helius-labs/core-ai/pull/60)
+- feat(cli): Unify Error Handling Across Commands [`#57`](https://github.com/helius-labs/core-ai/pull/57)
+- feat(cli): Add `helius plans` Command [`#58`](https://github.com/helius-labs/core-ai/pull/58)
+- feat(cli): Add `status` Command [`#56`](https://github.com/helius-labs/core-ai/pull/56)
+- feat(cli): Add Client-Side Input Validation For Signup, Upgrade, and Webhooks [`#55`](https://github.com/helius-labs/core-ai/pull/55)
+- feat(MCP): Add TPS to `getNetworkStatus` [`#53`](https://github.com/helius-labs/core-ai/pull/53)
+- fix(cli): Silent Exit in non-JSON Mode [`#54`](https://github.com/helius-labs/core-ai/pull/54)
+- feat(cli): Improve Messaging For Interrupted Signups [`#52`](https://github.com/helius-labs/core-ai/pull/52)
+- feat(cli): Implement Better Error Handling With Custom Catch Block [`#51`](https://github.com/helius-labs/core-ai/pull/51)
+- feat(cli): Add `--wait` Flag to `helius signup` [`#50`](https://github.com/helius-labs/core-ai/pull/50)
+- chore: update CHANGELOG.md for helius-mcp@1.2.0 [`#49`](https://github.com/helius-labs/core-ai/pull/49)
+
+## [helius-mcp@1.2.0](https://github.com/helius-labs/core-ai/compare/helius-mcp@1.0.0...helius-mcp@1.2.0) - 2026-03-08
+
+### Merged
+
+- Bump helius-mcp and helius-cli to 1.2.0 [`#48`](https://github.com/helius-labs/core-ai/pull/48)
+- feat: agentic feedback loop [`#47`](https://github.com/helius-labs/core-ai/pull/47)
+- feat(plugin): Add Temp Claude Marketplace Workaround [`#46`](https://github.com/helius-labs/core-ai/pull/46)
+- feat(plugin): Make Helius Cursor Plugin [`#45`](https://github.com/helius-labs/core-ai/pull/45)
+- chore: update CHANGELOG.md for helius-mcp@1.0.0 [`#44`](https://github.com/helius-labs/core-ai/pull/44)
+
 ## helius-mcp@1.0.0 - 2026-03-03
 
 ### Merged

package/README.md

@@ -41,21 +41,24 @@ Or set it from your AI assistant by calling the `setHeliusApiKey` tool.
 
 **If you need a new account:**
 
-The MCP includes a fully autonomous signup flow — no browser needed:
+The MCP includes a `signup` tool with three modes:
 
 1. Call the `generateKeypair` tool — it creates a Solana wallet and returns the address
-2. Fund the wallet with **~0.001 SOL** (transaction fees) + **1 USDC** (basic plan costs $1)
-3. Call `checkSignupBalance` to verify funds arrived
-4. Call `agenticSignup` to create your account — API key is configured automatically
+2. Call `signup` with `mode: "link"` — returns a `paymentUrl` (e.g. `https://dashboard.helius.dev/pay/<id>`) you open in any browser to pay with any wallet
+3. After paying in the browser, call `signup` with `mode: "resume"` — finalizes provisioning and configures the API key automatically
+4. Or skip the browser: call `signup` with `mode: "autopay"` to pay USDC from the local keypair (wallet must hold ~0.001 SOL + the plan amount in USDC)
 
-> **Paid plans (developer/business/professional):** `agenticSignup` and `upgradePlan` require `email`, `firstName`, and `lastName`. Basic plan does not.
+> **All paid plans:** `signup` and `upgradePlan` require `email`, `firstName`, and `lastName` for new signups (every plan, including Agent).
 
 Or do the same from the terminal:
 
 ```bash
-npx helius-cli@latest keygen     # Generate keypair
-# Fund the wallet address shown above with ~0.001 SOL + 1 USDC
-npx helius-cli@latest signup      # Verify balance + create account
+npx helius-cli@latest keygen                  # Generate keypair
+npx helius-cli@latest signup --plan agent     # Print hosted payment link
+# (pay in browser, then:)
+npx helius-cli@latest signup --resume         # Finalize account
+# Or autopay USDC from the local keypair:
+npx helius-cli@latest signup --plan agent --pay
 ```
 
 ### 3. Start using tools
@@ -67,35 +70,44 @@ Ask questions in plain English — the right tool is selected automatically:
 - "Get the balance of Gh9ZwEm..."
 - "Create a webhook for \<address\>"
 
-## Tools
+## Public Tool Surface
 
-**Onboarding (6):** getStarted, setHeliusApiKey, generateKeypair, checkSignupBalance, agenticSignup, getAccountStatus
+Helius MCP exposes 10 public tools total: 9 routed domain tools plus `expandResult`.
 
-**DAS API (9):** getAsset (single + batch), getAssetsByOwner, getAssetsByGroup, searchAssets (routes getAssetsByCreator / getAssetsByAuthority), getAssetProof, getAssetProofBatch, getSignaturesForAsset, getNftEditions, getTokenAccounts
+- `heliusAccount` — account setup, auth, plans, billing
+- `heliusWallet` — wallet balances, holdings, wallet history, identity
+- `heliusAsset` — assets, NFTs, collections, token holders
+- `heliusTransaction` — transaction parsing and wallet transaction history
+- `heliusChain` — chain state, token accounts, blocks, network status, stake reads
+- `heliusStreaming` — webhook CRUD and subscription config
+- `heliusKnowledge` — docs, guides, pricing, troubleshooting, source, blog, SIMDs
+- `heliusWrite` — transfers and staking mutations
+- `heliusCompression` — compressed account, balance, proof, and history actions
+- `expandResult` — expand summary-first outputs by `resultId`
 
-**RPC (5):** getBalance, getTokenBalances, getAccountInfo (single + batch), getNetworkStatus, getBlock
+The 9 routed domain tools share a common shape:
 
-**Transactions (2):** parseTransactions, getTransactionHistory
+- `action` — the Helius action name to run, such as `getBalance` or `createWebhook`
+- domain-specific params — for example `address`, `signatures`, or `webhookURL`
+- optional `detail` — `summary`, `standard`, or `full`
+- telemetry fields — `_feedback`, `_feedbackTool`, `_model`
 
-**Transfers (2):** transferSol, transferToken
+Each routed tool takes an `action` field with the Helius action name:
 
-**Priority Fees (1):** getPriorityFeeEstimate
-
-**Tokens (2):** getTokenHolders, getProgramAccounts
-
-**Webhooks (5):** getAllWebhooks, getWebhookByID, createWebhook, updateWebhook, deleteWebhook
-
-**Enhanced WebSockets (3):** transactionSubscribe, accountSubscribe, getEnhancedWebSocketInfo
-
-**Laserstream gRPC (2):** laserstreamSubscribe, getLaserstreamInfo
-
-**Wallet (6):** getWalletIdentity, batchWalletIdentity, getWalletBalances, getWalletHistory, getWalletTransfers, getWalletFundedBy
-
-**Plans & Billing (5):** getHeliusPlanInfo, compareHeliusPlans, previewUpgrade, upgradePlan, payRenewal
-
-**Docs & Guides (10):** lookupHeliusDocs, listHeliusDocTopics, getHeliusCreditsInfo, getRateLimitInfo, troubleshootError, getSenderInfo, getWebhookGuide, getLatencyComparison, getPumpFunGuide, recommendStack
+```json
+{
+  "name": "heliusWallet",
+  "arguments": {
+    "action": "getBalance",
+    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
+    "_feedback": "initial balance check",
+    "_feedbackTool": "heliusWallet.getBalance",
+    "_model": "your-model-id"
+  }
+}
+```
 
-**Solana Knowledge (5):** getSIMD, listSIMDs, searchSolanaDocs, readSolanaSourceFile, fetchHeliusBlog
+Heavy responses are summary-first. Routed tools return a compact summary plus `resultId` when the full response would be large or when `detail: "summary"` is requested. Use `expandResult` with that `resultId` to fetch a specific section, range, page, or continuation slice on demand.
 
 ## System Prompts
 

package/dist/http.d.ts

@@ -1 +1 @@
-export declare const MCP_USER_AGENT = "helius-mcp/1.2.0";
+export declare const MCP_USER_AGENT = "helius-mcp/2.0.0";

package/dist/index.js

@@ -2,6 +2,7 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { registerTools } from './tools/index.js';
+import { ROUTER_INSTRUCTIONS } from './router/instructions.js';
 import { setApiKey, setSessionSecretKey, setSessionWalletAddress } from './utils/helius.js';
 import { getSharedApiKey, loadKeypairFromDisk } from './utils/config.js';
 import { captureClientInfo, captureWalletAddress } from './utils/feedback.js';
@@ -12,62 +13,7 @@ const server = new McpServer({
     name: 'helius-mcp',
     version
 }, {
-    instructions: `These instructions provide fallback tool selection guidance. If you have more specific routing instructions from a Helius skill or system prompt, prefer those.
-
-## Tool Routing
-
-| Intent | Tool | Credits |
-|--------|------|---------|
-| SOL balance | getBalance | 1 |
-| token balances by wallet | getTokenBalances | 10/pg |
-| full portfolio + USD | getWalletBalances | 100 |
-| parse tx by signature | parseTransactions | 100 |
-| wallet transaction history | getTransactionHistory | ~110 |
-| balance deltas/tx | getWalletHistory | 100 |
-| sends/receives | getWalletTransfers | 100 |
-| asset by mint (single or batch) | getAsset | 10 |
-| wallet NFTs | getAssetsByOwner | 10 |
-| filtered asset search / by creator or authority | searchAssets | 10 |
-| collection NFTs | getAssetsByGroup | 10 |
-| asset tx history (by mint) | getSignaturesForAsset | 10 |
-| edition prints of master NFT | getNftEditions | 10 |
-| cNFT Merkle proof (single or batch) | getAssetProof, getAssetProofBatch | 10 |
-| raw account inspection (single or batch) | getAccountInfo | 1 |
-| token holders by mint | getTokenHolders | ~20 |
-| token accounts by mint or owner | getTokenAccounts | 10 |
-| program accounts / protocol state | getProgramAccounts | 10 |
-| network status / epoch / block height | getNetworkStatus | 3 |
-| block data by slot | getBlock | 1 |
-| plans/pricing | getHeliusPlanInfo | 0 |
-| plan comparison | compareHeliusPlans | 0 |
-| plan upgrade / billing | previewUpgrade, upgradePlan, payRenewal | 0 |
-| rate limits/credits | getRateLimitInfo | 0 |
-| API docs by topic | lookupHeliusDocs | 0 |
-| error diagnosis | troubleshootError | 0 |
-| tx sending / Jito / SWQoS | getSenderInfo | 0 |
-| webhook setup guide | getWebhookGuide | 0 |
-| streaming latency | getLatencyComparison | 0 |
-| pump.fun tokens | getPumpFunGuide | 0 |
-| project architecture / stack selection | recommendStack | 0 |
-| Solana SIMDs / protocol proposals | getSIMD, listSIMDs | 0 |
-| Solana source / docs search | searchSolanaDocs, readSolanaSourceFile | 0 |
-| Helius blog posts | fetchHeliusBlog | 0 |
-| wallet identity | getWalletIdentity | 100 |
-| batch wallet identity | batchWalletIdentity | 100 |
-| funding source | getWalletFundedBy | 100 |
-| event notifications (any plan) | createWebhook | 100 |
-| live streaming (WS, Business+) | transactionSubscribe, accountSubscribe | — |
-| production streaming (gRPC, Pro) | laserstreamSubscribe | — |
-| Account setup | getStarted → generateKeypair → agenticSignup | — |
-
-Rules:
-- For pricing, start with getHeliusPlanInfo — NOT lookupHeliusDocs.
-- For errors, use troubleshootError first.
-- When a user describes ANY project they want to build ("I want to build/make/create...", "help me build...", "I need a..."), call recommendStack immediately with their description — do not ask clarifying questions first. After recommendations, use getHeliusPlanInfo for pricing and lookupHeliusDocs for API details.
-- "send SOL" / "transfer SOL" → transferSol (~3 credits). "send tokens" / "transfer USDC/BONK/etc" → transferToken (~13 credits). Both require a configured keypair (generateKeypair) and use Helius Sender.
-
-## Feedback
-Every tool accepts \`_feedback\` and \`_model\` params. Always include \`_model\` with your LLM model identifier (e.g. "claude-sonnet-4-20250514", "gpt-4o"). After each tool call, assess the response and include \`_feedback\` on your next call — what worked, what was confusing, what data was missing or could be improved.`
+    instructions: ROUTER_INSTRUCTIONS
 });
 registerTools(server);
 // Capture MCP client identity (Cursor, Claude Code, etc.) after handshake

package/dist/results/store.d.ts

@@ -0,0 +1,8 @@
+import type { StoredResult } from './types.js';
+export declare function putStoredResult(input: Omit<StoredResult, 'resultId' | 'createdAt' | 'expiresAt' | 'payloadSize'>): StoredResult;
+export declare function getStoredResult(resultId: string, ownerSessionKey: string): StoredResult | null;
+export declare function clearStoredResults(): void;
+export declare function getStoredResultStats(): {
+    count: number;
+    totalPayloadBytes: number;
+};

package/dist/results/store.js

@@ -0,0 +1,72 @@
+import { randomUUID } from 'node:crypto';
+const MAX_RESULTS = 10;
+const MAX_TOTAL_PAYLOAD_BYTES = 250 * 1024;
+const RESULT_TTL_MS = 5 * 60 * 1000;
+const results = new Map();
+function estimateBytes(value) {
+    return Buffer.byteLength(JSON.stringify(value), 'utf8');
+}
+function sweepExpired(now = Date.now()) {
+    for (const [resultId, result] of results) {
+        if (result.expiresAt <= now) {
+            results.delete(resultId);
+        }
+    }
+}
+function currentTotalBytes() {
+    let total = 0;
+    for (const result of results.values()) {
+        total += result.payloadSize;
+    }
+    return total;
+}
+function touch(resultId, result) {
+    results.delete(resultId);
+    results.set(resultId, result);
+}
+function evictToFit() {
+    sweepExpired();
+    while (results.size > MAX_RESULTS || currentTotalBytes() > MAX_TOTAL_PAYLOAD_BYTES) {
+        const oldest = results.keys().next().value;
+        if (!oldest) {
+            break;
+        }
+        results.delete(oldest);
+    }
+}
+export function putStoredResult(input) {
+    const createdAt = Date.now();
+    const payloadSize = estimateBytes(input.payload);
+    const stored = {
+        ...input,
+        resultId: randomUUID(),
+        createdAt,
+        expiresAt: createdAt + RESULT_TTL_MS,
+        payloadSize,
+    };
+    results.set(stored.resultId, stored);
+    evictToFit();
+    return stored;
+}
+export function getStoredResult(resultId, ownerSessionKey) {
+    sweepExpired();
+    const result = results.get(resultId);
+    if (!result) {
+        return null;
+    }
+    if (result.ownerSessionKey !== ownerSessionKey) {
+        return null;
+    }
+    touch(resultId, result);
+    return result;
+}
+export function clearStoredResults() {
+    results.clear();
+}
+export function getStoredResultStats() {
+    sweepExpired();
+    return {
+        count: results.size,
+        totalPayloadBytes: currentTotalBytes(),
+    };
+}

package/dist/results/types.d.ts

@@ -0,0 +1,47 @@
+import type { RoutedPublicToolName } from '../router/action-groups.js';
+import type { ActionName } from '../router/actions.js';
+import type { DetailLevel, ResponseFamily } from '../router/types.js';
+export type TransactionHistoryContinuation = {
+    kind: 'signaturesQuick';
+    nextBefore?: string;
+    lastSeenSignature?: string;
+    until?: string;
+} | {
+    kind: 'historyApi';
+    paginationToken?: string;
+} | {
+    kind: 'rawApi';
+    paginationToken?: string;
+};
+export type ContinuationState = {
+    model: 'none';
+} | {
+    model: 'page';
+    nextPage?: number;
+} | {
+    model: 'transactionHistory';
+    next?: TransactionHistoryContinuation;
+};
+export type ActionRecipe = {
+    publicTool: RoutedPublicToolName;
+    action: ActionName;
+    params: Record<string, unknown>;
+    responseFamily: ResponseFamily;
+    defaultDetail: DetailLevel;
+};
+export type ResultPayload = {
+    recipe: ActionRecipe;
+    continuation: ContinuationState;
+    sectionHints?: string[];
+};
+export type StoredResult = {
+    resultId: string;
+    kind: ResponseFamily;
+    ownerSessionKey: string;
+    summary: string;
+    availableExpansions: string[];
+    createdAt: number;
+    expiresAt: number;
+    payload: ResultPayload;
+    payloadSize: number;
+};

package/dist/results/types.js

@@ -0,0 +1 @@
+export {};

package/dist/router/action-groups.d.ts

@@ -0,0 +1,6 @@
+import { type ActionName } from './actions.js';
+export declare const PUBLIC_TOOL_NAMES: readonly ["heliusAccount", "heliusWallet", "heliusAsset", "heliusTransaction", "heliusChain", "heliusStreaming", "heliusKnowledge", "heliusWrite", "heliusCompression", "expandResult"];
+export type PublicToolName = typeof PUBLIC_TOOL_NAMES[number];
+export type RoutedPublicToolName = Exclude<PublicToolName, 'expandResult'>;
+export declare const ACTION_GROUPS: Record<RoutedPublicToolName, readonly ActionName[]>;
+export declare function findPublicToolForAction(action: ActionName): RoutedPublicToolName;

package/dist/router/action-groups.js

@@ -0,0 +1,32 @@
+import { HELIUS_ACCOUNT_ACTIONS, HELIUS_ASSET_ACTIONS, HELIUS_CHAIN_ACTIONS, HELIUS_COMPRESSION_ACTIONS, HELIUS_KNOWLEDGE_ACTIONS, HELIUS_STREAMING_ACTIONS, HELIUS_TRANSACTION_ACTIONS, HELIUS_WALLET_ACTIONS, HELIUS_WRITE_ACTIONS, } from './actions.js';
+export const PUBLIC_TOOL_NAMES = [
+    'heliusAccount',
+    'heliusWallet',
+    'heliusAsset',
+    'heliusTransaction',
+    'heliusChain',
+    'heliusStreaming',
+    'heliusKnowledge',
+    'heliusWrite',
+    'heliusCompression',
+    'expandResult',
+];
+export const ACTION_GROUPS = {
+    heliusAccount: HELIUS_ACCOUNT_ACTIONS,
+    heliusWallet: HELIUS_WALLET_ACTIONS,
+    heliusAsset: HELIUS_ASSET_ACTIONS,
+    heliusTransaction: HELIUS_TRANSACTION_ACTIONS,
+    heliusChain: HELIUS_CHAIN_ACTIONS,
+    heliusStreaming: HELIUS_STREAMING_ACTIONS,
+    heliusKnowledge: HELIUS_KNOWLEDGE_ACTIONS,
+    heliusWrite: HELIUS_WRITE_ACTIONS,
+    heliusCompression: HELIUS_COMPRESSION_ACTIONS,
+};
+export function findPublicToolForAction(action) {
+    for (const [tool, actions] of Object.entries(ACTION_GROUPS)) {
+        if (actions.includes(action)) {
+            return tool;
+        }
+    }
+    throw new Error(`No public tool mapping found for action "${action}"`);
+}

package/dist/router/action-handlers.d.ts

@@ -0,0 +1,20 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ActionName } from './actions.js';
+export type ActionHandlerResponse = {
+    content?: Array<{
+        type?: string;
+        text?: string;
+    }>;
+    isError?: boolean;
+    structuredContent?: unknown;
+};
+export type ActionHandler = (params: Record<string, unknown>, extra: unknown) => Promise<ActionHandlerResponse> | ActionHandlerResponse;
+export type ActionHandlerDefinition = {
+    name: ActionName;
+    description?: string;
+    inputSchema?: unknown;
+    handler: ActionHandler;
+};
+export declare function registerActionHandlers(server: McpServer): void;
+export declare function getActionHandlers(): Map<ActionName, ActionHandlerDefinition>;
+export declare function callActionHandler(action: ActionName, params: Record<string, unknown>, extra: unknown): Promise<ActionHandlerResponse>;

package/dist/router/action-handlers.js

@@ -0,0 +1,125 @@
+import { z } from 'zod';
+import { registerAuthTools } from '../tools/auth.js';
+import { registerConfigTools } from '../tools/config.js';
+import { registerPlanTools } from '../tools/plans.js';
+import { registerBalanceTools } from '../tools/balance.js';
+import { registerTransactionTools } from '../tools/transactions.js';
+import { registerAssetTools } from '../tools/assets.js';
+import { registerAccountTools } from '../tools/accounts.js';
+import { registerFeeTools } from '../tools/fees.js';
+import { registerNetworkTools } from '../tools/network.js';
+import { registerBlockTools } from '../tools/blocks.js';
+import { registerTokenTools } from '../tools/tokens.js';
+import { registerDasExtraTools } from '../tools/das-extras.js';
+import { registerWebhookTools } from '../tools/webhooks.js';
+import { registerEnhancedWebSocketTools } from '../tools/enhanced-websockets.js';
+import { registerLaserstreamTools } from '../tools/laserstream.js';
+import { registerWalletTools } from '../tools/wallet.js';
+import { registerDocsTools } from '../tools/docs.js';
+import { registerGuideTools } from '../tools/guides.js';
+import { registerRecommendTools } from '../tools/recommend.js';
+import { registerSolanaKnowledgeTools } from '../tools/solana-knowledge.js';
+import { registerTransferTools } from '../tools/transfers.js';
+import { registerZkCompressionTools } from '../tools/zk-compression.js';
+import { registerStakingTools } from '../tools/staking.js';
+function isZodType(value) {
+    return typeof value === 'object' && value !== null && typeof value.safeParse === 'function';
+}
+function buildRuntimeSchema(inputSchema) {
+    if (isZodType(inputSchema) && 'passthrough' in inputSchema && typeof inputSchema.passthrough === 'function') {
+        return inputSchema.passthrough();
+    }
+    if (!inputSchema || typeof inputSchema !== 'object' || Array.isArray(inputSchema)) {
+        return null;
+    }
+    const rawShape = {};
+    for (const [key, value] of Object.entries(inputSchema)) {
+        if (isZodType(value)) {
+            rawShape[key] = value;
+        }
+    }
+    if (Object.keys(rawShape).length === 0) {
+        return null;
+    }
+    return z.object(rawShape).passthrough();
+}
+function materializeActionParams(tool, params) {
+    const schema = buildRuntimeSchema(tool.inputSchema);
+    if (!schema) {
+        return params;
+    }
+    const parsed = schema.safeParse(params);
+    if (parsed.success) {
+        return parsed.data;
+    }
+    const issue = parsed.error.issues[0];
+    const path = issue?.path?.length ? issue.path.join('.') : 'input';
+    const message = `Invalid parameters for ${tool.name}: ${path} ${issue?.message ?? 'is invalid'}`.trim();
+    throw new Error(message);
+}
+class ActionHandlerCollector {
+    tools = new Map();
+    tool(name, ...rest) {
+        let description;
+        let inputSchema;
+        if (typeof rest[0] === 'string') {
+            description = rest.shift();
+        }
+        if (rest.length > 1 && typeof rest[0] === 'object' && rest[0] !== null) {
+            inputSchema = rest.shift();
+        }
+        const handler = rest[0];
+        if (typeof handler !== 'function') {
+            throw new Error(`Action handler "${name}" is missing a callable handler`);
+        }
+        this.tools.set(name, {
+            name: name,
+            description,
+            inputSchema,
+            handler: handler,
+        });
+    }
+}
+let cachedActionHandlers = null;
+export function registerActionHandlers(server) {
+    registerAuthTools(server);
+    registerConfigTools(server);
+    registerPlanTools(server);
+    registerBalanceTools(server);
+    registerTransactionTools(server);
+    registerAssetTools(server);
+    registerAccountTools(server);
+    registerFeeTools(server);
+    registerNetworkTools(server);
+    registerBlockTools(server);
+    registerTokenTools(server);
+    registerDasExtraTools(server);
+    registerWebhookTools(server);
+    registerEnhancedWebSocketTools(server);
+    registerLaserstreamTools(server);
+    registerWalletTools(server);
+    registerDocsTools(server);
+    registerGuideTools(server);
+    registerRecommendTools(server);
+    registerSolanaKnowledgeTools(server);
+    registerTransferTools(server);
+    registerZkCompressionTools(server);
+    registerStakingTools(server);
+}
+export function getActionHandlers() {
+    if (cachedActionHandlers) {
+        return cachedActionHandlers;
+    }
+    const collector = new ActionHandlerCollector();
+    registerActionHandlers(collector);
+    cachedActionHandlers = collector.tools;
+    return cachedActionHandlers;
+}
+export async function callActionHandler(action, params, extra) {
+    const tool = getActionHandlers().get(action);
+    if (!tool) {
+        throw new Error(`No action handler registered for action "${action}"`);
+    }
+    const normalizedParams = materializeActionParams(tool, params);
+    return await Promise.resolve(tool.handler(normalizedParams, extra));
+}

package/dist/router/actions.d.ts

@@ -0,0 +1,12 @@
+export declare const HELIUS_ACCOUNT_ACTIONS: readonly ["getStarted", "setHeliusApiKey", "generateKeypair", "signup", "getAccountStatus", "getAccountPlan", "getHeliusPlanInfo", "compareHeliusPlans", "previewUpgrade", "upgradePlan", "payRenewal", "purchaseCredits"];
+export declare const HELIUS_WALLET_ACTIONS: readonly ["getBalance", "getTokenBalances", "getWalletBalances", "getWalletHistory", "getWalletTransfers", "getWalletIdentity", "batchWalletIdentity", "getWalletFundedBy"];
+export declare const HELIUS_ASSET_ACTIONS: readonly ["getAsset", "getAssetsByOwner", "searchAssets", "getAssetsByGroup", "getAssetProof", "getAssetProofBatch", "getSignaturesForAsset", "getNftEditions", "getTokenHolders"];
+export declare const HELIUS_TRANSACTION_ACTIONS: readonly ["parseTransactions", "getTransactionHistory", "getTransfersByAddress"];
+export declare const HELIUS_CHAIN_ACTIONS: readonly ["getAccountInfo", "getTokenAccounts", "getProgramAccounts", "getBlock", "getNetworkStatus", "getPriorityFeeEstimate", "getStakeAccounts", "getWithdrawableAmount"];
+export declare const HELIUS_STREAMING_ACTIONS: readonly ["createWebhook", "getAllWebhooks", "getWebhookByID", "updateWebhook", "deleteWebhook", "transactionSubscribe", "accountSubscribe", "laserstreamSubscribe"];
+export declare const HELIUS_KNOWLEDGE_ACTIONS: readonly ["lookupHeliusDocs", "listHeliusDocTopics", "getHeliusCreditsInfo", "getRateLimitInfo", "troubleshootError", "recommendStack", "getSIMD", "listSIMDs", "searchSolanaDocs", "readSolanaSourceFile", "fetchHeliusBlog", "getPumpFunGuide", "getSenderInfo", "getWebhookGuide", "getLatencyComparison", "getEnhancedWebSocketInfo", "getLaserstreamInfo"];
+export declare const HELIUS_WRITE_ACTIONS: readonly ["transferSol", "transferToken", "stakeSOL", "unstakeSOL", "withdrawStake"];
+export declare const HELIUS_COMPRESSION_ACTIONS: readonly ["getCompressedAccount", "getCompressedAccountsByOwner", "getMultipleCompressedAccounts", "getCompressedBalance", "getCompressedBalanceByOwner", "getCompressedMintTokenHolders", "getCompressedTokenAccountBalance", "getCompressedTokenAccountsByOwner", "getCompressedTokenAccountsByDelegate", "getCompressedTokenBalancesByOwnerV2", "getCompressedAccountProof", "getMultipleCompressedAccountProofs", "getMultipleNewAddressProofs", "getCompressionSignaturesForAccount", "getCompressionSignaturesForAddress", "getCompressionSignaturesForOwner", "getCompressionSignaturesForTokenOwner", "getLatestCompressionSignatures", "getLatestNonVotingSignatures", "getTransactionWithCompressionInfo", "getValidityProof", "getIndexerHealth", "getIndexerSlot"];
+export declare const ACTION_NAMES: readonly ["getStarted", "setHeliusApiKey", "generateKeypair", "signup", "getAccountStatus", "getAccountPlan", "getHeliusPlanInfo", "compareHeliusPlans", "previewUpgrade", "upgradePlan", "payRenewal", "purchaseCredits", "getBalance", "getTokenBalances", "getWalletBalances", "getWalletHistory", "getWalletTransfers", "getWalletIdentity", "batchWalletIdentity", "getWalletFundedBy", "getAsset", "getAssetsByOwner", "searchAssets", "getAssetsByGroup", "getAssetProof", "getAssetProofBatch", "getSignaturesForAsset", "getNftEditions", "getTokenHolders", "parseTransactions", "getTransactionHistory", "getTransfersByAddress", "getAccountInfo", "getTokenAccounts", "getProgramAccounts", "getBlock", "getNetworkStatus", "getPriorityFeeEstimate", "getStakeAccounts", "getWithdrawableAmount", "createWebhook", "getAllWebhooks", "getWebhookByID", "updateWebhook", "deleteWebhook", "transactionSubscribe", "accountSubscribe", "laserstreamSubscribe", "lookupHeliusDocs", "listHeliusDocTopics", "getHeliusCreditsInfo", "getRateLimitInfo", "troubleshootError", "recommendStack", "getSIMD", "listSIMDs", "searchSolanaDocs", "readSolanaSourceFile", "fetchHeliusBlog", "getPumpFunGuide", "getSenderInfo", "getWebhookGuide", "getLatencyComparison", "getEnhancedWebSocketInfo", "getLaserstreamInfo", "transferSol", "transferToken", "stakeSOL", "unstakeSOL", "withdrawStake", "getCompressedAccount", "getCompressedAccountsByOwner", "getMultipleCompressedAccounts", "getCompressedBalance", "getCompressedBalanceByOwner", "getCompressedMintTokenHolders", "getCompressedTokenAccountBalance", "getCompressedTokenAccountsByOwner", "getCompressedTokenAccountsByDelegate", "getCompressedTokenBalancesByOwnerV2", "getCompressedAccountProof", "getMultipleCompressedAccountProofs", "getMultipleNewAddressProofs", "getCompressionSignaturesForAccount", "getCompressionSignaturesForAddress", "getCompressionSignaturesForOwner", "getCompressionSignaturesForTokenOwner", "getLatestCompressionSignatures", "getLatestNonVotingSignatures", "getTransactionWithCompressionInfo", "getValidityProof", "getIndexerHealth", "getIndexerSlot"];
+export type ActionName = typeof ACTION_NAMES[number];
+export declare const ACTION_NAME_SET: Set<string>;