helius-mcp 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,52 +1,79 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
-
-## helius-mcp@1.0.0 - 2026-03-03
-
-### Merged
-
-- feat: Cross-platform skill portability for non-Claude developers [`#42`](https://github.com/helius-labs/core-ai/pull/42)
-- feat(MCP): Improve Testing Suite [`#41`](https://github.com/helius-labs/core-ai/pull/41)
-- feat(MCP): Add Changelog  [`#43`](https://github.com/helius-labs/core-ai/pull/43)
-- feat(MCP): Prep For 1.0.0 Release [`#40`](https://github.com/helius-labs/core-ai/pull/40)
-- release: helius-cli@1.1.0 [`#39`](https://github.com/helius-labs/core-ai/pull/39)
-- feat(docs): Better `README.md` Files [`#38`](https://github.com/helius-labs/core-ai/pull/38)
-- feat(mcp): add transferSol and transferToken tools [`#35`](https://github.com/helius-labs/core-ai/pull/35)
-- Add Helius x Phantom frontend skill [`#33`](https://github.com/helius-labs/core-ai/pull/33)
-- Standardize MCP Zod parameter descriptions [`#36`](https://github.com/helius-labs/core-ai/pull/36)
-- feat(mcp): reduce token usage across MCP server and SKILL.md [`#34`](https://github.com/helius-labs/core-ai/pull/34)
-- feat(skill): Add SVM Skill [`#37`](https://github.com/helius-labs/core-ai/pull/37)
-- Fix MCP tool selection ambiguity with BEST FOR/PREFER routing [`#32`](https://github.com/helius-labs/core-ai/pull/32)
-- Replace hardcoded billing data with live doc fetches [`#31`](https://github.com/helius-labs/core-ai/pull/31)
-- feat(mcp + cli): Add Solana Knowledge Tools [`#30`](https://github.com/helius-labs/core-ai/pull/30)
-- fix(cli): Improve Signup UX [`#29`](https://github.com/helius-labs/core-ai/pull/29)
-- feat(skill): Add Helius x DFlow Skill [`#27`](https://github.com/helius-labs/core-ai/pull/27)
-- Remove vestigial projectType from recommendStack [`#28`](https://github.com/helius-labs/core-ai/pull/28)
-- Add recommendStack MCP tool for architecture recommendations [`#25`](https://github.com/helius-labs/core-ai/pull/25)
-- feat(docs) Add README [`#11`](https://github.com/helius-labs/core-ai/pull/11)
-- feat(plugin): Add Helius Plugin For Claude Code [`#26`](https://github.com/helius-labs/core-ai/pull/26)
-- chore(GitHub): Add `.claude` to `.gitignore` [`#24`](https://github.com/helius-labs/core-ai/pull/24)
-- feat(mcp): Improve Onboarding [`#23`](https://github.com/helius-labs/core-ai/pull/23)
-- Improve MCP tool routing [`#22`](https://github.com/helius-labs/core-ai/pull/22)
-- feat(skills): Add Helius Skill [`#20`](https://github.com/helius-labs/core-ai/pull/20)
-- feat(cli): Better Errors [`#16`](https://github.com/helius-labs/core-ai/pull/16)
-- feat(mcp): Add Credit Cost Annotations [`#18`](https://github.com/helius-labs/core-ai/pull/18)
-- feat(mcp): Make All Data-bearing Guide Tools Fetch Directly From the Docs [`#19`](https://github.com/helius-labs/core-ai/pull/19)
-- feat(mcp): Add `getAccountStatus` Tool [`#17`](https://github.com/helius-labs/core-ai/pull/17)
-- fix: pass customer info through upgradePlan and CLI upgrade [`#15`](https://github.com/helius-labs/core-ai/pull/15)
-- feat(cli): Format Snake Case Enums Into Title Case [`#14`](https://github.com/helius-labs/core-ai/pull/14)
-- feat(cli): Explicitly Set Project ID on CLI Creation [`#13`](https://github.com/helius-labs/core-ai/pull/13)
-- feat: OpenPay integration for CLI and MCP server [`#10`](https://github.com/helius-labs/core-ai/pull/10)
-- feat/agent-signup [`#9`](https://github.com/helius-labs/core-ai/pull/9)
-- Add docs integration and cleanup [`#6`](https://github.com/helius-labs/core-ai/pull/6)
-- fix: migrate to use sdk [`#8`](https://github.com/helius-labs/core-ai/pull/8)
-- feat/claude.md and helius-sdk for cli [`#7`](https://github.com/helius-labs/core-ai/pull/7)
-- feat: add error handling [`#4`](https://github.com/helius-labs/core-ai/pull/4)
-- fix: repair updateWebhook and deleteWebhook MCP tools [`#2`](https://github.com/helius-labs/core-ai/pull/2)
-- feat: upgrade helius-mcp data tools with rich formatting and new capa… [`#1`](https://github.com/helius-labs/core-ai/pull/1)
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+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
+
+- feat: Cross-platform skill portability for non-Claude developers [`#42`](https://github.com/helius-labs/core-ai/pull/42)
+- feat(MCP): Improve Testing Suite [`#41`](https://github.com/helius-labs/core-ai/pull/41)
+- feat(MCP): Add Changelog  [`#43`](https://github.com/helius-labs/core-ai/pull/43)
+- feat(MCP): Prep For 1.0.0 Release [`#40`](https://github.com/helius-labs/core-ai/pull/40)
+- release: helius-cli@1.1.0 [`#39`](https://github.com/helius-labs/core-ai/pull/39)
+- feat(docs): Better `README.md` Files [`#38`](https://github.com/helius-labs/core-ai/pull/38)
+- feat(mcp): add transferSol and transferToken tools [`#35`](https://github.com/helius-labs/core-ai/pull/35)
+- Add Helius x Phantom frontend skill [`#33`](https://github.com/helius-labs/core-ai/pull/33)
+- Standardize MCP Zod parameter descriptions [`#36`](https://github.com/helius-labs/core-ai/pull/36)
+- feat(mcp): reduce token usage across MCP server and SKILL.md [`#34`](https://github.com/helius-labs/core-ai/pull/34)
+- feat(skill): Add SVM Skill [`#37`](https://github.com/helius-labs/core-ai/pull/37)
+- Fix MCP tool selection ambiguity with BEST FOR/PREFER routing [`#32`](https://github.com/helius-labs/core-ai/pull/32)
+- Replace hardcoded billing data with live doc fetches [`#31`](https://github.com/helius-labs/core-ai/pull/31)
+- feat(mcp + cli): Add Solana Knowledge Tools [`#30`](https://github.com/helius-labs/core-ai/pull/30)
+- fix(cli): Improve Signup UX [`#29`](https://github.com/helius-labs/core-ai/pull/29)
+- feat(skill): Add Helius x DFlow Skill [`#27`](https://github.com/helius-labs/core-ai/pull/27)
+- Remove vestigial projectType from recommendStack [`#28`](https://github.com/helius-labs/core-ai/pull/28)
+- Add recommendStack MCP tool for architecture recommendations [`#25`](https://github.com/helius-labs/core-ai/pull/25)
+- feat(docs) Add README [`#11`](https://github.com/helius-labs/core-ai/pull/11)
+- feat(plugin): Add Helius Plugin For Claude Code [`#26`](https://github.com/helius-labs/core-ai/pull/26)
+- chore(GitHub): Add `.claude` to `.gitignore` [`#24`](https://github.com/helius-labs/core-ai/pull/24)
+- feat(mcp): Improve Onboarding [`#23`](https://github.com/helius-labs/core-ai/pull/23)
+- Improve MCP tool routing [`#22`](https://github.com/helius-labs/core-ai/pull/22)
+- feat(skills): Add Helius Skill [`#20`](https://github.com/helius-labs/core-ai/pull/20)
+- feat(cli): Better Errors [`#16`](https://github.com/helius-labs/core-ai/pull/16)
+- feat(mcp): Add Credit Cost Annotations [`#18`](https://github.com/helius-labs/core-ai/pull/18)
+- feat(mcp): Make All Data-bearing Guide Tools Fetch Directly From the Docs [`#19`](https://github.com/helius-labs/core-ai/pull/19)
+- feat(mcp): Add `getAccountStatus` Tool [`#17`](https://github.com/helius-labs/core-ai/pull/17)
+- fix: pass customer info through upgradePlan and CLI upgrade [`#15`](https://github.com/helius-labs/core-ai/pull/15)
+- feat(cli): Format Snake Case Enums Into Title Case [`#14`](https://github.com/helius-labs/core-ai/pull/14)
+- feat(cli): Explicitly Set Project ID on CLI Creation [`#13`](https://github.com/helius-labs/core-ai/pull/13)
+- feat: OpenPay integration for CLI and MCP server [`#10`](https://github.com/helius-labs/core-ai/pull/10)
+- feat/agent-signup [`#9`](https://github.com/helius-labs/core-ai/pull/9)
+- Add docs integration and cleanup [`#6`](https://github.com/helius-labs/core-ai/pull/6)
+- fix: migrate to use sdk [`#8`](https://github.com/helius-labs/core-ai/pull/8)
+- feat/claude.md and helius-sdk for cli [`#7`](https://github.com/helius-labs/core-ai/pull/7)
+- feat: add error handling [`#4`](https://github.com/helius-labs/core-ai/pull/4)
+- fix: repair updateWebhook and deleteWebhook MCP tools [`#2`](https://github.com/helius-labs/core-ai/pull/2)
+- feat: upgrade helius-mcp data tools with rich formatting and new capa… [`#1`](https://github.com/helius-labs/core-ai/pull/1)

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Helius Labs
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Helius Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,132 +1,132 @@
-# Helius MCP Server
-
-MCP server for Helius — Solana blockchain data access for AI assistants, provided by Solana's fastest, most reliable infrastructure provider
-
-See the [CHANGELOG](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md) for version history and release notes.
-
-Interested in contributing? Read the [contribution guide](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md) before opening a PR.
-
-## Quick Start
-
-### 1. Add the MCP server
-
-Add to your MCP host's config (works with Claude, Cursor, Windsurf, and any MCP-compatible client):
-
-```json
-{
-  "mcpServers": {
-    "helius": {
-      "command": "npx",
-      "args": ["helius-mcp@latest"]
-    }
-  }
-}
-```
-
-Or if you're using Claude Code:
-
-```bash
-claude mcp add helius npx helius-mcp@latest
-```
-
-### 2. Configure your API key
-
-**If you already have a Helius API key:**
-
-```bash
-export HELIUS_API_KEY=your-api-key
-```
-
-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:
-
-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
-
-> **Paid plans (developer/business/professional):** `agenticSignup` and `upgradePlan` require `email`, `firstName`, and `lastName`. Basic plan does not.
-
-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
-```
-
-### 3. Start using tools
-
-Ask questions in plain English — the right tool is selected automatically:
-
-- "What NFTs does this wallet own?"
-- "Parse this transaction: 5abc..."
-- "Get the balance of Gh9ZwEm..."
-- "Create a webhook for \<address\>"
-
-## Tools
-
-**Onboarding (6):** getStarted, setHeliusApiKey, generateKeypair, checkSignupBalance, agenticSignup, getAccountStatus
-
-**DAS API (9):** getAsset (single + batch), getAssetsByOwner, getAssetsByGroup, searchAssets (routes getAssetsByCreator / getAssetsByAuthority), getAssetProof, getAssetProofBatch, getSignaturesForAsset, getNftEditions, getTokenAccounts
-
-**RPC (5):** getBalance, getTokenBalances, getAccountInfo (single + batch), getNetworkStatus, getBlock
-
-**Transactions (2):** parseTransactions, getTransactionHistory
-
-**Transfers (2):** transferSol, transferToken
-
-**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
-
-**Solana Knowledge (5):** getSIMD, listSIMDs, searchSolanaDocs, readSolanaSourceFile, fetchHeliusBlog
-
-## System Prompts
-
-This package ships with pre-built system prompts that teach AI models how to use Helius tools effectively. Find them in `system-prompts/`:
-
-```
-system-prompts/
-├── helius/              # Core Helius skill
-├── helius-dflow/        # DFlow trading skill
-├── helius-phantom/      # Phantom frontend skill
-└── svm/                 # SVM architecture skill
-```
-
-Each contains three variants:
-- `openai.developer.md` — for OpenAI Responses/Chat Completions API (`developer` message)
-- `claude.system.md` — for Claude API (system prompt)
-- `full.md` — self-contained with all references inlined (Cursor Rules, ChatGPT, etc.)
-
-See [`helius-skills/SYSTEM-PROMPTS.md`](https://github.com/helius-labs/core-ai/blob/main/helius-skills/SYSTEM-PROMPTS.md) for integration guides and code examples.
-
-## Networks
-
-Mainnet Beta (default) and Devnet. Set via `HELIUS_NETWORK` env var or `setNetwork` in the session
-
-## Related Resources
-
-- [Full Documentation](https://www.helius.dev/docs)
-- [LLM-Optimized Docs](https://www.helius.dev/docs/llms.txt)
-- [API Reference](https://www.helius.dev/docs/api-reference)
-- [Billing and Credits](https://www.helius.dev/docs/billing/credits.md)
-- [Rate Limits](https://www.helius.dev/docs/billing/rate-limits.md)
-- [Dashboard](https://dashboard.helius.dev)
-- [Status Page](https://helius.statuspage.io)
-- [Full Agent Signup Instructions](https://dashboard.helius.dev/agents.md)
+# Helius MCP Server
+
+MCP server for Helius — Solana blockchain data access for AI assistants, provided by Solana's fastest, most reliable infrastructure provider
+
+See the [CHANGELOG](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md) for version history and release notes.
+
+Interested in contributing? Read the [contribution guide](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md) before opening a PR.
+
+## Quick Start
+
+### 1. Add the MCP server
+
+Add to your MCP host's config (works with Claude, Cursor, Windsurf, and any MCP-compatible client):
+
+```json
+{
+  "mcpServers": {
+    "helius": {
+      "command": "npx",
+      "args": ["helius-mcp@latest"]
+    }
+  }
+}
+```
+
+Or if you're using Claude Code:
+
+```bash
+claude mcp add helius npx helius-mcp@latest
+```
+
+### 2. Configure your API key
+
+**If you already have a Helius API key:**
+
+```bash
+export HELIUS_API_KEY=your-api-key
+```
+
+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:
+
+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
+
+> **Paid plans (developer/business/professional):** `agenticSignup` and `upgradePlan` require `email`, `firstName`, and `lastName`. Basic plan does not.
+
+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
+```
+
+### 3. Start using tools
+
+Ask questions in plain English — the right tool is selected automatically:
+
+- "What NFTs does this wallet own?"
+- "Parse this transaction: 5abc..."
+- "Get the balance of Gh9ZwEm..."
+- "Create a webhook for \<address\>"
+
+## Tools
+
+**Onboarding (6):** getStarted, setHeliusApiKey, generateKeypair, checkSignupBalance, agenticSignup, getAccountStatus
+
+**DAS API (9):** getAsset (single + batch), getAssetsByOwner, getAssetsByGroup, searchAssets (routes getAssetsByCreator / getAssetsByAuthority), getAssetProof, getAssetProofBatch, getSignaturesForAsset, getNftEditions, getTokenAccounts
+
+**RPC (5):** getBalance, getTokenBalances, getAccountInfo (single + batch), getNetworkStatus, getBlock
+
+**Transactions (2):** parseTransactions, getTransactionHistory
+
+**Transfers (2):** transferSol, transferToken
+
+**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
+
+**Solana Knowledge (5):** getSIMD, listSIMDs, searchSolanaDocs, readSolanaSourceFile, fetchHeliusBlog
+
+## System Prompts
+
+This package ships with pre-built system prompts that teach AI models how to use Helius tools effectively. Find them in `system-prompts/`:
+
+```
+system-prompts/
+├── helius/              # Core Helius skill
+├── helius-dflow/        # DFlow trading skill
+├── helius-phantom/      # Phantom frontend skill
+└── svm/                 # SVM architecture skill
+```
+
+Each contains three variants:
+- `openai.developer.md` — for OpenAI Responses/Chat Completions API (`developer` message)
+- `claude.system.md` — for Claude API (system prompt)
+- `full.md` — self-contained with all references inlined (Cursor Rules, ChatGPT, etc.)
+
+See [`helius-skills/SYSTEM-PROMPTS.md`](https://github.com/helius-labs/core-ai/blob/main/helius-skills/SYSTEM-PROMPTS.md) for integration guides and code examples.
+
+## Networks
+
+Mainnet Beta (default) and Devnet. Set via `HELIUS_NETWORK` env var or `setNetwork` in the session
+
+## Related Resources
+
+- [Full Documentation](https://www.helius.dev/docs)
+- [LLM-Optimized Docs](https://www.helius.dev/docs/llms.txt)
+- [API Reference](https://www.helius.dev/docs/api-reference)
+- [Billing and Credits](https://www.helius.dev/docs/billing/credits.md)
+- [Rate Limits](https://www.helius.dev/docs/billing/rate-limits.md)
+- [Dashboard](https://dashboard.helius.dev)
+- [Status Page](https://helius.statuspage.io)
+- [Full Agent Signup Instructions](https://dashboard.helius.dev/agents.md)

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/1.3.0";

package/dist/index.js

@@ -12,61 +12,61 @@ 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
+    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.`
 });
 registerTools(server);

package/dist/scripts/test-htmltotext.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Quick test: fetch a real blog post and check htmlToText output quality.
+ * Run: node dist/scripts/test-htmltotext.js
+ */
+export {};