helius-mcp 1.3.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/CHANGELOG.md +151 -79
  2. package/LICENSE +21 -21
  3. package/README.md +144 -132
  4. package/dist/http.d.ts +1 -1
  5. package/dist/index.js +2 -56
  6. package/dist/results/store.d.ts +8 -0
  7. package/dist/results/store.js +72 -0
  8. package/dist/results/types.d.ts +47 -0
  9. package/dist/results/types.js +1 -0
  10. package/dist/router/action-groups.d.ts +6 -0
  11. package/dist/router/action-groups.js +32 -0
  12. package/dist/router/action-handlers.d.ts +20 -0
  13. package/dist/router/action-handlers.js +125 -0
  14. package/dist/router/actions.d.ts +12 -0
  15. package/dist/router/actions.js +125 -0
  16. package/dist/router/catalog.d.ts +6 -0
  17. package/dist/router/catalog.js +394 -0
  18. package/dist/router/context.d.ts +5 -0
  19. package/dist/router/context.js +10 -0
  20. package/dist/router/dispatch.d.ts +4 -0
  21. package/dist/router/dispatch.js +276 -0
  22. package/dist/router/instructions.d.ts +1 -0
  23. package/dist/router/instructions.js +25 -0
  24. package/dist/router/register.d.ts +2 -0
  25. package/dist/router/register.js +15 -0
  26. package/dist/router/required-params.d.ts +9 -0
  27. package/dist/router/required-params.js +68 -0
  28. package/dist/router/responses.d.ts +29 -0
  29. package/dist/router/responses.js +186 -0
  30. package/dist/router/schemas.d.ts +224 -0
  31. package/dist/router/schemas.js +204 -0
  32. package/dist/router/telemetry.d.ts +27 -0
  33. package/dist/router/telemetry.js +52 -0
  34. package/dist/router/types.d.ts +46 -0
  35. package/dist/router/types.js +1 -0
  36. package/dist/scripts/validate-catalog.d.ts +2 -2
  37. package/dist/scripts/validate-catalog.js +10 -10
  38. package/dist/tools/accounts.js +5 -5
  39. package/dist/tools/assets.js +5 -5
  40. package/dist/tools/auth.js +392 -319
  41. package/dist/tools/config.js +3 -3
  42. package/dist/tools/das-extras.js +6 -6
  43. package/dist/tools/docs.js +55 -41
  44. package/dist/tools/enhanced-websockets.js +13 -13
  45. package/dist/tools/fees.js +3 -3
  46. package/dist/tools/index.d.ts +1 -1
  47. package/dist/tools/index.js +2 -80
  48. package/dist/tools/laserstream.js +20 -23
  49. package/dist/tools/network.js +10 -4
  50. package/dist/tools/plans.d.ts +0 -5
  51. package/dist/tools/plans.js +167 -12
  52. package/dist/tools/product-catalog.d.ts +1 -0
  53. package/dist/tools/product-catalog.js +52 -17
  54. package/dist/tools/recommend.d.ts +0 -1
  55. package/dist/tools/recommend.js +9 -28
  56. package/dist/tools/shared.d.ts +1 -0
  57. package/dist/tools/shared.js +21 -13
  58. package/dist/tools/solana-knowledge.js +23 -7
  59. package/dist/tools/staking.d.ts +2 -0
  60. package/dist/tools/staking.js +268 -0
  61. package/dist/tools/transactions.js +256 -3
  62. package/dist/tools/transfers.js +38 -43
  63. package/dist/tools/wallet.js +77 -17
  64. package/dist/tools/webhooks.js +3 -3
  65. package/dist/tools/zk-compression.d.ts +2 -0
  66. package/dist/tools/zk-compression.js +781 -0
  67. package/dist/utils/config.d.ts +2 -2
  68. package/dist/utils/config.js +68 -6
  69. package/dist/utils/errors.d.ts +10 -1
  70. package/dist/utils/errors.js +46 -12
  71. package/dist/utils/feedback.js +1 -4
  72. package/dist/utils/helius.js +25 -14
  73. package/dist/utils/ows.d.ts +74 -0
  74. package/dist/utils/ows.js +155 -0
  75. package/dist/utils/resilience.d.ts +39 -0
  76. package/dist/utils/resilience.js +130 -0
  77. package/dist/version.d.ts +1 -1
  78. package/dist/version.js +1 -1
  79. package/package.json +63 -64
  80. package/system-prompts/helius/claude.system.md +200 -170
  81. package/system-prompts/helius/full.md +3236 -2869
  82. package/system-prompts/helius/openai.developer.md +200 -170
  83. package/system-prompts/helius-dflow/claude.system.md +324 -290
  84. package/system-prompts/helius-dflow/full.md +4160 -3648
  85. package/system-prompts/helius-dflow/openai.developer.md +324 -290
  86. package/system-prompts/helius-jupiter/claude.system.md +333 -0
  87. package/system-prompts/helius-jupiter/full.md +5133 -0
  88. package/system-prompts/helius-jupiter/openai.developer.md +333 -0
  89. package/system-prompts/helius-okx/claude.system.md +182 -0
  90. package/system-prompts/helius-okx/full.md +584 -0
  91. package/system-prompts/helius-okx/openai.developer.md +182 -0
  92. package/system-prompts/helius-phantom/claude.system.md +345 -333
  93. package/system-prompts/helius-phantom/full.md +5649 -5473
  94. package/system-prompts/helius-phantom/openai.developer.md +345 -333
  95. package/system-prompts/svm/claude.system.md +159 -159
  96. package/system-prompts/svm/full.md +631 -631
  97. package/system-prompts/svm/openai.developer.md +159 -159
  98. package/dist/scripts/test-htmltotext.d.ts +0 -5
  99. package/dist/scripts/test-htmltotext.js +0 -67
  100. package/dist/scripts/test-solana-knowledge.d.ts +0 -9
  101. package/dist/scripts/test-solana-knowledge.js +0 -272
  102. package/dist/scripts/validate-templates.d.ts +0 -12
  103. package/dist/scripts/validate-templates.js +0 -94
package/CHANGELOG.md CHANGED
@@ -1,79 +1,151 @@
1
- # Changelog
2
-
3
- All notable changes to this project will be documented in this file.
4
-
5
- The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
6
- and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
-
8
- Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
9
-
10
- ## [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
11
-
12
- ### Merged
13
-
14
- - feat(skills): Add Skill Versioning [`#61`](https://github.com/helius-labs/core-ai/pull/61)
15
- - fix(mcp): Add Escalating Retry Guidance For Agents [`#60`](https://github.com/helius-labs/core-ai/pull/60)
16
- - feat(cli): Unify Error Handling Across Commands [`#57`](https://github.com/helius-labs/core-ai/pull/57)
17
- - feat(cli): Add `helius plans` Command [`#58`](https://github.com/helius-labs/core-ai/pull/58)
18
- - feat(cli): Add `status` Command [`#56`](https://github.com/helius-labs/core-ai/pull/56)
19
- - feat(cli): Add Client-Side Input Validation For Signup, Upgrade, and Webhooks [`#55`](https://github.com/helius-labs/core-ai/pull/55)
20
- - feat(MCP): Add TPS to `getNetworkStatus` [`#53`](https://github.com/helius-labs/core-ai/pull/53)
21
- - fix(cli): Silent Exit in non-JSON Mode [`#54`](https://github.com/helius-labs/core-ai/pull/54)
22
- - feat(cli): Improve Messaging For Interrupted Signups [`#52`](https://github.com/helius-labs/core-ai/pull/52)
23
- - feat(cli): Implement Better Error Handling With Custom Catch Block [`#51`](https://github.com/helius-labs/core-ai/pull/51)
24
- - feat(cli): Add `--wait` Flag to `helius signup` [`#50`](https://github.com/helius-labs/core-ai/pull/50)
25
- - chore: update CHANGELOG.md for helius-mcp@1.2.0 [`#49`](https://github.com/helius-labs/core-ai/pull/49)
26
-
27
- ## [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
28
-
29
- ### Merged
30
-
31
- - Bump helius-mcp and helius-cli to 1.2.0 [`#48`](https://github.com/helius-labs/core-ai/pull/48)
32
- - feat: agentic feedback loop [`#47`](https://github.com/helius-labs/core-ai/pull/47)
33
- - feat(plugin): Add Temp Claude Marketplace Workaround [`#46`](https://github.com/helius-labs/core-ai/pull/46)
34
- - feat(plugin): Make Helius Cursor Plugin [`#45`](https://github.com/helius-labs/core-ai/pull/45)
35
- - chore: update CHANGELOG.md for helius-mcp@1.0.0 [`#44`](https://github.com/helius-labs/core-ai/pull/44)
36
-
37
- ## helius-mcp@1.0.0 - 2026-03-03
38
-
39
- ### Merged
40
-
41
- - feat: Cross-platform skill portability for non-Claude developers [`#42`](https://github.com/helius-labs/core-ai/pull/42)
42
- - feat(MCP): Improve Testing Suite [`#41`](https://github.com/helius-labs/core-ai/pull/41)
43
- - feat(MCP): Add Changelog [`#43`](https://github.com/helius-labs/core-ai/pull/43)
44
- - feat(MCP): Prep For 1.0.0 Release [`#40`](https://github.com/helius-labs/core-ai/pull/40)
45
- - release: helius-cli@1.1.0 [`#39`](https://github.com/helius-labs/core-ai/pull/39)
46
- - feat(docs): Better `README.md` Files [`#38`](https://github.com/helius-labs/core-ai/pull/38)
47
- - feat(mcp): add transferSol and transferToken tools [`#35`](https://github.com/helius-labs/core-ai/pull/35)
48
- - Add Helius x Phantom frontend skill [`#33`](https://github.com/helius-labs/core-ai/pull/33)
49
- - Standardize MCP Zod parameter descriptions [`#36`](https://github.com/helius-labs/core-ai/pull/36)
50
- - feat(mcp): reduce token usage across MCP server and SKILL.md [`#34`](https://github.com/helius-labs/core-ai/pull/34)
51
- - feat(skill): Add SVM Skill [`#37`](https://github.com/helius-labs/core-ai/pull/37)
52
- - Fix MCP tool selection ambiguity with BEST FOR/PREFER routing [`#32`](https://github.com/helius-labs/core-ai/pull/32)
53
- - Replace hardcoded billing data with live doc fetches [`#31`](https://github.com/helius-labs/core-ai/pull/31)
54
- - feat(mcp + cli): Add Solana Knowledge Tools [`#30`](https://github.com/helius-labs/core-ai/pull/30)
55
- - fix(cli): Improve Signup UX [`#29`](https://github.com/helius-labs/core-ai/pull/29)
56
- - feat(skill): Add Helius x DFlow Skill [`#27`](https://github.com/helius-labs/core-ai/pull/27)
57
- - Remove vestigial projectType from recommendStack [`#28`](https://github.com/helius-labs/core-ai/pull/28)
58
- - Add recommendStack MCP tool for architecture recommendations [`#25`](https://github.com/helius-labs/core-ai/pull/25)
59
- - feat(docs) Add README [`#11`](https://github.com/helius-labs/core-ai/pull/11)
60
- - feat(plugin): Add Helius Plugin For Claude Code [`#26`](https://github.com/helius-labs/core-ai/pull/26)
61
- - chore(GitHub): Add `.claude` to `.gitignore` [`#24`](https://github.com/helius-labs/core-ai/pull/24)
62
- - feat(mcp): Improve Onboarding [`#23`](https://github.com/helius-labs/core-ai/pull/23)
63
- - Improve MCP tool routing [`#22`](https://github.com/helius-labs/core-ai/pull/22)
64
- - feat(skills): Add Helius Skill [`#20`](https://github.com/helius-labs/core-ai/pull/20)
65
- - feat(cli): Better Errors [`#16`](https://github.com/helius-labs/core-ai/pull/16)
66
- - feat(mcp): Add Credit Cost Annotations [`#18`](https://github.com/helius-labs/core-ai/pull/18)
67
- - feat(mcp): Make All Data-bearing Guide Tools Fetch Directly From the Docs [`#19`](https://github.com/helius-labs/core-ai/pull/19)
68
- - feat(mcp): Add `getAccountStatus` Tool [`#17`](https://github.com/helius-labs/core-ai/pull/17)
69
- - fix: pass customer info through upgradePlan and CLI upgrade [`#15`](https://github.com/helius-labs/core-ai/pull/15)
70
- - feat(cli): Format Snake Case Enums Into Title Case [`#14`](https://github.com/helius-labs/core-ai/pull/14)
71
- - feat(cli): Explicitly Set Project ID on CLI Creation [`#13`](https://github.com/helius-labs/core-ai/pull/13)
72
- - feat: OpenPay integration for CLI and MCP server [`#10`](https://github.com/helius-labs/core-ai/pull/10)
73
- - feat/agent-signup [`#9`](https://github.com/helius-labs/core-ai/pull/9)
74
- - Add docs integration and cleanup [`#6`](https://github.com/helius-labs/core-ai/pull/6)
75
- - fix: migrate to use sdk [`#8`](https://github.com/helius-labs/core-ai/pull/8)
76
- - feat/claude.md and helius-sdk for cli [`#7`](https://github.com/helius-labs/core-ai/pull/7)
77
- - feat: add error handling [`#4`](https://github.com/helius-labs/core-ai/pull/4)
78
- - fix: repair updateWebhook and deleteWebhook MCP tools [`#2`](https://github.com/helius-labs/core-ai/pull/2)
79
- - feat: upgrade helius-mcp data tools with rich formatting and new capa… [`#1`](https://github.com/helius-labs/core-ai/pull/1)
1
+ # Changelog
2
+
3
+ All notable changes to this project will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
9
+
10
+ ## [helius-mcp@2.1.0](https://github.com/helius-labs/core-ai/compare/helius-mcp@2.0.0...helius-mcp@2.1.0) - 2026-06-24
11
+
12
+ ### Merged
13
+
14
+ - feat(wallet): Add balance-at Support to MCP and CLI [`#138`](https://github.com/helius-labs/core-ai/pull/138)
15
+ - feat(mcp): Add Timeout and Retry With Backoff For MCP RPC Reads [`#136`](https://github.com/helius-labs/core-ai/pull/136)
16
+ - feat(mcp): Add `simulateTransaction` Tool For Pre-Send Transaction Dry-Runs [`#135`](https://github.com/helius-labs/core-ai/pull/135)
17
+ - feat(cli): Add Confirmation Prompt Before Submitting Transactions [`#134`](https://github.com/helius-labs/core-ai/pull/134)
18
+ - feat(cli): Add Confirmation Prompts For Destructive Commands [`#133`](https://github.com/helius-labs/core-ai/pull/133)
19
+ - feat(ci): Harden Release Pipeline and Add Dependency/Security Automation [`#128`](https://github.com/helius-labs/core-ai/pull/128)
20
+ - fix(deps): Patch High-Severity Security Advisories in the MCP and CLI [`#127`](https://github.com/helius-labs/core-ai/pull/127)
21
+ - fix(cli): exit non-zero when reclaim batches fail to land [`#126`](https://github.com/helius-labs/core-ai/pull/126)
22
+
23
+ ## [helius-mcp@2.0.0](https://github.com/helius-labs/core-ai/compare/helius-mcp@1.3.0...helius-mcp@2.0.0) - 2026-06-15
24
+
25
+ ### Merged
26
+
27
+ - chore(mcp): 2.0.0 Release [`#124`](https://github.com/helius-labs/core-ai/pull/124)
28
+ - fix(cli): Store Config With Owner-only Permissions [`#121`](https://github.com/helius-labs/core-ai/pull/121)
29
+ - feat(helius-cli): OAuth/PKCE login + logout + whoami (v2.0.0) [`#118`](https://github.com/helius-labs/core-ai/pull/118)
30
+ - feat(ci): Require and Enforce Signed Commits Repo-wide [`#119`](https://github.com/helius-labs/core-ai/pull/119)
31
+ - feat(cli+mcp): unified crypto checkout signup / upgrade / credits / pay [`#109`](https://github.com/helius-labs/core-ai/pull/109)
32
+ - fix(cli): tx history --before now uses beforeSignature [`#116`](https://github.com/helius-labs/core-ai/pull/116)
33
+ - Add package.json Metadata and Bundle LICENSE [`#117`](https://github.com/helius-labs/core-ai/pull/117)
34
+ - fix(jupiter-skill): Sender/Jito tip recipe + Trigger V2 vault onboarding [`#115`](https://github.com/helius-labs/core-ai/pull/115)
35
+ - feat(mcp+cli): expose getTransfersByAddress RPC method [`#112`](https://github.com/helius-labs/core-ai/pull/112)
36
+ - docs(plugin): Advertise Jupiter/OKX/SVM Skills and Bump to 1.1 [`#114`](https://github.com/helius-labs/core-ai/pull/114)
37
+ - feat(security): Enforce 7-day Minimum Release Age For Deps [`#113`](https://github.com/helius-labs/core-ai/pull/113)
38
+ - feat(cli): Add Reclaim Command [`#101`](https://github.com/helius-labs/core-ai/pull/101)
39
+ - fix mcp config recovery, telemetry, and laserstream api handling [`#108`](https://github.com/helius-labs/core-ai/pull/108)
40
+ - feat(cli): Always emit suggestion in JSON error envelopes [`#107`](https://github.com/helius-labs/core-ai/pull/107)
41
+ - feat(cli)!: Uniform JSON envelope for all --json output (v2.0) [`#106`](https://github.com/helius-labs/core-ai/pull/106)
42
+ - feat(cli): Add Error Category to JSON Output [`#103`](https://github.com/helius-labs/core-ai/pull/103)
43
+ - feat(cli,mcp): Add SNS/ANS domain resolution to wallet identity [`#105`](https://github.com/helius-labs/core-ai/pull/105)
44
+ - feat(cli): Add `--amount` and `--raw-amount` Flags for Stake Commands [`#104`](https://github.com/helius-labs/core-ai/pull/104)
45
+ - feat(skill): Add DFlow Agent CLI Coverage to Skill [`#102`](https://github.com/helius-labs/core-ai/pull/102)
46
+ - feat(cli): Add Pre-Input Validation For Addresses, Sigs, and Slots [`#100`](https://github.com/helius-labs/core-ai/pull/100)
47
+ - feat(cli): Add `--dry-run` Flag For Transaction and Webhook Commands [`#99`](https://github.com/helius-labs/core-ai/pull/99)
48
+ - feat(cli): Add Debug Flag For HTTP Req and Res Troubleshooting [`#98`](https://github.com/helius-labs/core-ai/pull/98)
49
+ - feat(skill): Add Jupiter [`#59`](https://github.com/helius-labs/core-ai/pull/59)
50
+ - feat(cli): Add `llms.txt` File [`#96`](https://github.com/helius-labs/core-ai/pull/96)
51
+ - feat(cli): Add Usage Examples to All Command `--help` Output [`#97`](https://github.com/helius-labs/core-ai/pull/97)
52
+ - feat(cli): Add `--retry` Flag For Transient Error Recovery With Exponential Backoff [`#94`](https://github.com/helius-labs/core-ai/pull/94)
53
+ - fix(skill): Make Helius Skill Interface-Agnostic [`#95`](https://github.com/helius-labs/core-ai/pull/95)
54
+ - Update Sender docs: clarify tip accounts and add pre-serialized tx guide [`#80`](https://github.com/helius-labs/core-ai/pull/80)
55
+ - feat(cli): Extract Duplicated Setup Helper to Shared `setupClient` [`#93`](https://github.com/helius-labs/core-ai/pull/93)
56
+ - fix(cli): Recover Corrupted Config Instead of Silently Ignoring [`#91`](https://github.com/helius-labs/core-ai/pull/91)
57
+ - feat(skills): Refactor OKX Skill to Thin Integration-only Layer [`#92`](https://github.com/helius-labs/core-ai/pull/92)
58
+ - feat(cli): Add Shell Completion Support [`#90`](https://github.com/helius-labs/core-ai/pull/90)
59
+ - fix(cli): Extract Duplicate Confirm Prompt to Shared Output Util [`#89`](https://github.com/helius-labs/core-ai/pull/89)
60
+ - fix(cli): `exitWithError` Outputting JSON in Non-JSON Mode [`#88`](https://github.com/helius-labs/core-ai/pull/88)
61
+ - fix(cli): Improve WS Error Handling With Guidance Hints and Telemetry [`#87`](https://github.com/helius-labs/core-ai/pull/87)
62
+ - fix(cli): Standardize Keygen Command [`#86`](https://github.com/helius-labs/core-ai/pull/86)
63
+ - feat(docs): Update Streaming Pricing and Plan Access [`#62`](https://github.com/helius-labs/core-ai/pull/62)
64
+ - feat(cli): Add `helius update` Self-update Command [`#84`](https://github.com/helius-labs/core-ai/pull/84)
65
+ - test(mcp): add unit tests for router/responses.ts [`#82`](https://github.com/helius-labs/core-ai/pull/82)
66
+ - feat(cli+mcp): Add Optional OWS Wallet Signing [`#83`](https://github.com/helius-labs/core-ai/pull/83)
67
+ - feat(skill): Add OKX [`#65`](https://github.com/helius-labs/core-ai/pull/65)
68
+ - Add glama.json to Repo Root [`#81`](https://github.com/helius-labs/core-ai/pull/81)
69
+ - feat(docs): Add MIT License [`#78`](https://github.com/helius-labs/core-ai/pull/78)
70
+ - Reduce Helius MCP context bloat with routed public surface [`#76`](https://github.com/helius-labs/core-ai/pull/76)
71
+ - feat(mcp): Make `getNetworkStatus` TPS Configurable [`#79`](https://github.com/helius-labs/core-ai/pull/79)
72
+ - feat(cli): Add NO_DNA Support [`#74`](https://github.com/helius-labs/core-ai/pull/74)
73
+ - feat(mcp): add ZK Compression support (23 tools) [`#69`](https://github.com/helius-labs/core-ai/pull/69)
74
+ - feat(mcp): add staking tools [`#68`](https://github.com/helius-labs/core-ai/pull/68)
75
+ - fix: add missing MCP parameter descriptions [`#67`](https://github.com/helius-labs/core-ai/pull/67)
76
+ - feat(mcp): add getAccountPlan tool [`#71`](https://github.com/helius-labs/core-ai/pull/71)
77
+ - fix(mcp): unify error responses with structured metadata [`#70`](https://github.com/helius-labs/core-ai/pull/70)
78
+ - fix(cli): Make WebSocket Commands Agent-Friendly [`#66`](https://github.com/helius-labs/core-ai/pull/66)
79
+ - chore: update CHANGELOG.md for helius-mcp@1.3.0 [`#64`](https://github.com/helius-labs/core-ai/pull/64)
80
+
81
+ ## [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
82
+
83
+ ### Merged
84
+
85
+ - feat(mcp): Bump to v1.3.0 [`#63`](https://github.com/helius-labs/core-ai/pull/63)
86
+ - feat(skills): Add Skill Versioning [`#61`](https://github.com/helius-labs/core-ai/pull/61)
87
+ - fix(mcp): Add Escalating Retry Guidance For Agents [`#60`](https://github.com/helius-labs/core-ai/pull/60)
88
+ - feat(cli): Unify Error Handling Across Commands [`#57`](https://github.com/helius-labs/core-ai/pull/57)
89
+ - feat(cli): Add `helius plans` Command [`#58`](https://github.com/helius-labs/core-ai/pull/58)
90
+ - feat(cli): Add `status` Command [`#56`](https://github.com/helius-labs/core-ai/pull/56)
91
+ - feat(cli): Add Client-Side Input Validation For Signup, Upgrade, and Webhooks [`#55`](https://github.com/helius-labs/core-ai/pull/55)
92
+ - feat(MCP): Add TPS to `getNetworkStatus` [`#53`](https://github.com/helius-labs/core-ai/pull/53)
93
+ - fix(cli): Silent Exit in non-JSON Mode [`#54`](https://github.com/helius-labs/core-ai/pull/54)
94
+ - feat(cli): Improve Messaging For Interrupted Signups [`#52`](https://github.com/helius-labs/core-ai/pull/52)
95
+ - feat(cli): Implement Better Error Handling With Custom Catch Block [`#51`](https://github.com/helius-labs/core-ai/pull/51)
96
+ - feat(cli): Add `--wait` Flag to `helius signup` [`#50`](https://github.com/helius-labs/core-ai/pull/50)
97
+ - chore: update CHANGELOG.md for helius-mcp@1.2.0 [`#49`](https://github.com/helius-labs/core-ai/pull/49)
98
+
99
+ ## [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
100
+
101
+ ### Merged
102
+
103
+ - Bump helius-mcp and helius-cli to 1.2.0 [`#48`](https://github.com/helius-labs/core-ai/pull/48)
104
+ - feat: agentic feedback loop [`#47`](https://github.com/helius-labs/core-ai/pull/47)
105
+ - feat(plugin): Add Temp Claude Marketplace Workaround [`#46`](https://github.com/helius-labs/core-ai/pull/46)
106
+ - feat(plugin): Make Helius Cursor Plugin [`#45`](https://github.com/helius-labs/core-ai/pull/45)
107
+ - chore: update CHANGELOG.md for helius-mcp@1.0.0 [`#44`](https://github.com/helius-labs/core-ai/pull/44)
108
+
109
+ ## helius-mcp@1.0.0 - 2026-03-03
110
+
111
+ ### Merged
112
+
113
+ - feat: Cross-platform skill portability for non-Claude developers [`#42`](https://github.com/helius-labs/core-ai/pull/42)
114
+ - feat(MCP): Improve Testing Suite [`#41`](https://github.com/helius-labs/core-ai/pull/41)
115
+ - feat(MCP): Add Changelog [`#43`](https://github.com/helius-labs/core-ai/pull/43)
116
+ - feat(MCP): Prep For 1.0.0 Release [`#40`](https://github.com/helius-labs/core-ai/pull/40)
117
+ - release: helius-cli@1.1.0 [`#39`](https://github.com/helius-labs/core-ai/pull/39)
118
+ - feat(docs): Better `README.md` Files [`#38`](https://github.com/helius-labs/core-ai/pull/38)
119
+ - feat(mcp): add transferSol and transferToken tools [`#35`](https://github.com/helius-labs/core-ai/pull/35)
120
+ - Add Helius x Phantom frontend skill [`#33`](https://github.com/helius-labs/core-ai/pull/33)
121
+ - Standardize MCP Zod parameter descriptions [`#36`](https://github.com/helius-labs/core-ai/pull/36)
122
+ - feat(mcp): reduce token usage across MCP server and SKILL.md [`#34`](https://github.com/helius-labs/core-ai/pull/34)
123
+ - feat(skill): Add SVM Skill [`#37`](https://github.com/helius-labs/core-ai/pull/37)
124
+ - Fix MCP tool selection ambiguity with BEST FOR/PREFER routing [`#32`](https://github.com/helius-labs/core-ai/pull/32)
125
+ - Replace hardcoded billing data with live doc fetches [`#31`](https://github.com/helius-labs/core-ai/pull/31)
126
+ - feat(mcp + cli): Add Solana Knowledge Tools [`#30`](https://github.com/helius-labs/core-ai/pull/30)
127
+ - fix(cli): Improve Signup UX [`#29`](https://github.com/helius-labs/core-ai/pull/29)
128
+ - feat(skill): Add Helius x DFlow Skill [`#27`](https://github.com/helius-labs/core-ai/pull/27)
129
+ - Remove vestigial projectType from recommendStack [`#28`](https://github.com/helius-labs/core-ai/pull/28)
130
+ - Add recommendStack MCP tool for architecture recommendations [`#25`](https://github.com/helius-labs/core-ai/pull/25)
131
+ - feat(docs) Add README [`#11`](https://github.com/helius-labs/core-ai/pull/11)
132
+ - feat(plugin): Add Helius Plugin For Claude Code [`#26`](https://github.com/helius-labs/core-ai/pull/26)
133
+ - chore(GitHub): Add `.claude` to `.gitignore` [`#24`](https://github.com/helius-labs/core-ai/pull/24)
134
+ - feat(mcp): Improve Onboarding [`#23`](https://github.com/helius-labs/core-ai/pull/23)
135
+ - Improve MCP tool routing [`#22`](https://github.com/helius-labs/core-ai/pull/22)
136
+ - feat(skills): Add Helius Skill [`#20`](https://github.com/helius-labs/core-ai/pull/20)
137
+ - feat(cli): Better Errors [`#16`](https://github.com/helius-labs/core-ai/pull/16)
138
+ - feat(mcp): Add Credit Cost Annotations [`#18`](https://github.com/helius-labs/core-ai/pull/18)
139
+ - feat(mcp): Make All Data-bearing Guide Tools Fetch Directly From the Docs [`#19`](https://github.com/helius-labs/core-ai/pull/19)
140
+ - feat(mcp): Add `getAccountStatus` Tool [`#17`](https://github.com/helius-labs/core-ai/pull/17)
141
+ - fix: pass customer info through upgradePlan and CLI upgrade [`#15`](https://github.com/helius-labs/core-ai/pull/15)
142
+ - feat(cli): Format Snake Case Enums Into Title Case [`#14`](https://github.com/helius-labs/core-ai/pull/14)
143
+ - feat(cli): Explicitly Set Project ID on CLI Creation [`#13`](https://github.com/helius-labs/core-ai/pull/13)
144
+ - feat: OpenPay integration for CLI and MCP server [`#10`](https://github.com/helius-labs/core-ai/pull/10)
145
+ - feat/agent-signup [`#9`](https://github.com/helius-labs/core-ai/pull/9)
146
+ - Add docs integration and cleanup [`#6`](https://github.com/helius-labs/core-ai/pull/6)
147
+ - fix: migrate to use sdk [`#8`](https://github.com/helius-labs/core-ai/pull/8)
148
+ - feat/claude.md and helius-sdk for cli [`#7`](https://github.com/helius-labs/core-ai/pull/7)
149
+ - feat: add error handling [`#4`](https://github.com/helius-labs/core-ai/pull/4)
150
+ - fix: repair updateWebhook and deleteWebhook MCP tools [`#2`](https://github.com/helius-labs/core-ai/pull/2)
151
+ - feat: upgrade helius-mcp data tools with rich formatting and new capa… [`#1`](https://github.com/helius-labs/core-ai/pull/1)
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2026 Helius Labs
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Helius Labs
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,132 +1,144 @@
1
- # Helius MCP Server
2
-
3
- MCP server for Helius — Solana blockchain data access for AI assistants, provided by Solana's fastest, most reliable infrastructure provider
4
-
5
- See the [CHANGELOG](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md) for version history and release notes.
6
-
7
- Interested in contributing? Read the [contribution guide](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md) before opening a PR.
8
-
9
- ## Quick Start
10
-
11
- ### 1. Add the MCP server
12
-
13
- Add to your MCP host's config (works with Claude, Cursor, Windsurf, and any MCP-compatible client):
14
-
15
- ```json
16
- {
17
- "mcpServers": {
18
- "helius": {
19
- "command": "npx",
20
- "args": ["helius-mcp@latest"]
21
- }
22
- }
23
- }
24
- ```
25
-
26
- Or if you're using Claude Code:
27
-
28
- ```bash
29
- claude mcp add helius npx helius-mcp@latest
30
- ```
31
-
32
- ### 2. Configure your API key
33
-
34
- **If you already have a Helius API key:**
35
-
36
- ```bash
37
- export HELIUS_API_KEY=your-api-key
38
- ```
39
-
40
- Or set it from your AI assistant by calling the `setHeliusApiKey` tool.
41
-
42
- **If you need a new account:**
43
-
44
- The MCP includes a fully autonomous signup flow no browser needed:
45
-
46
- 1. Call the `generateKeypair` tool — it creates a Solana wallet and returns the address
47
- 2. Fund the wallet with **~0.001 SOL** (transaction fees) + **1 USDC** (basic plan costs $1)
48
- 3. Call `checkSignupBalance` to verify funds arrived
49
- 4. Call `agenticSignup` to create your account API key is configured automatically
50
-
51
- > **Paid plans (developer/business/professional):** `agenticSignup` and `upgradePlan` require `email`, `firstName`, and `lastName`. Basic plan does not.
52
-
53
- Or do the same from the terminal:
54
-
55
- ```bash
56
- npx helius-cli@latest keygen # Generate keypair
57
- # Fund the wallet address shown above with ~0.001 SOL + 1 USDC
58
- npx helius-cli@latest signup # Verify balance + create account
59
- ```
60
-
61
- ### 3. Start using tools
62
-
63
- Ask questions in plain English — the right tool is selected automatically:
64
-
65
- - "What NFTs does this wallet own?"
66
- - "Parse this transaction: 5abc..."
67
- - "Get the balance of Gh9ZwEm..."
68
- - "Create a webhook for \<address\>"
69
-
70
- ## Tools
71
-
72
- **Onboarding (6):** getStarted, setHeliusApiKey, generateKeypair, checkSignupBalance, agenticSignup, getAccountStatus
73
-
74
- **DAS API (9):** getAsset (single + batch), getAssetsByOwner, getAssetsByGroup, searchAssets (routes getAssetsByCreator / getAssetsByAuthority), getAssetProof, getAssetProofBatch, getSignaturesForAsset, getNftEditions, getTokenAccounts
75
-
76
- **RPC (5):** getBalance, getTokenBalances, getAccountInfo (single + batch), getNetworkStatus, getBlock
77
-
78
- **Transactions (2):** parseTransactions, getTransactionHistory
79
-
80
- **Transfers (2):** transferSol, transferToken
81
-
82
- **Priority Fees (1):** getPriorityFeeEstimate
83
-
84
- **Tokens (2):** getTokenHolders, getProgramAccounts
85
-
86
- **Webhooks (5):** getAllWebhooks, getWebhookByID, createWebhook, updateWebhook, deleteWebhook
87
-
88
- **Enhanced WebSockets (3):** transactionSubscribe, accountSubscribe, getEnhancedWebSocketInfo
89
-
90
- **Laserstream gRPC (2):** laserstreamSubscribe, getLaserstreamInfo
91
-
92
- **Wallet (6):** getWalletIdentity, batchWalletIdentity, getWalletBalances, getWalletHistory, getWalletTransfers, getWalletFundedBy
93
-
94
- **Plans & Billing (5):** getHeliusPlanInfo, compareHeliusPlans, previewUpgrade, upgradePlan, payRenewal
95
-
96
- **Docs & Guides (10):** lookupHeliusDocs, listHeliusDocTopics, getHeliusCreditsInfo, getRateLimitInfo, troubleshootError, getSenderInfo, getWebhookGuide, getLatencyComparison, getPumpFunGuide, recommendStack
97
-
98
- **Solana Knowledge (5):** getSIMD, listSIMDs, searchSolanaDocs, readSolanaSourceFile, fetchHeliusBlog
99
-
100
- ## System Prompts
101
-
102
- This package ships with pre-built system prompts that teach AI models how to use Helius tools effectively. Find them in `system-prompts/`:
103
-
104
- ```
105
- system-prompts/
106
- ├── helius/ # Core Helius skill
107
- ├── helius-dflow/ # DFlow trading skill
108
- ├── helius-phantom/ # Phantom frontend skill
109
- └── svm/ # SVM architecture skill
110
- ```
111
-
112
- Each contains three variants:
113
- - `openai.developer.md` — for OpenAI Responses/Chat Completions API (`developer` message)
114
- - `claude.system.md` for Claude API (system prompt)
115
- - `full.md` — self-contained with all references inlined (Cursor Rules, ChatGPT, etc.)
116
-
117
- 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.
118
-
119
- ## Networks
120
-
121
- Mainnet Beta (default) and Devnet. Set via `HELIUS_NETWORK` env var or `setNetwork` in the session
122
-
123
- ## Related Resources
124
-
125
- - [Full Documentation](https://www.helius.dev/docs)
126
- - [LLM-Optimized Docs](https://www.helius.dev/docs/llms.txt)
127
- - [API Reference](https://www.helius.dev/docs/api-reference)
128
- - [Billing and Credits](https://www.helius.dev/docs/billing/credits.md)
129
- - [Rate Limits](https://www.helius.dev/docs/billing/rate-limits.md)
130
- - [Dashboard](https://dashboard.helius.dev)
131
- - [Status Page](https://helius.statuspage.io)
132
- - [Full Agent Signup Instructions](https://dashboard.helius.dev/agents.md)
1
+ # Helius MCP Server
2
+
3
+ MCP server for Helius — Solana blockchain data access for AI assistants, provided by Solana's fastest, most reliable infrastructure provider
4
+
5
+ See the [CHANGELOG](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md) for version history and release notes.
6
+
7
+ Interested in contributing? Read the [contribution guide](https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md) before opening a PR.
8
+
9
+ ## Quick Start
10
+
11
+ ### 1. Add the MCP server
12
+
13
+ Add to your MCP host's config (works with Claude, Cursor, Windsurf, and any MCP-compatible client):
14
+
15
+ ```json
16
+ {
17
+ "mcpServers": {
18
+ "helius": {
19
+ "command": "npx",
20
+ "args": ["helius-mcp@latest"]
21
+ }
22
+ }
23
+ }
24
+ ```
25
+
26
+ Or if you're using Claude Code:
27
+
28
+ ```bash
29
+ claude mcp add helius npx helius-mcp@latest
30
+ ```
31
+
32
+ ### 2. Configure your API key
33
+
34
+ **If you already have a Helius API key:**
35
+
36
+ ```bash
37
+ export HELIUS_API_KEY=your-api-key
38
+ ```
39
+
40
+ Or set it from your AI assistant by calling the `setHeliusApiKey` tool.
41
+
42
+ **If you need a new account:**
43
+
44
+ The MCP includes a `signup` tool with three modes:
45
+
46
+ 1. Call the `generateKeypair` tool — it creates a Solana wallet and returns the address
47
+ 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
48
+ 3. After paying in the browser, call `signup` with `mode: "resume"` — finalizes provisioning and configures the API key automatically
49
+ 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)
50
+
51
+ > **All paid plans:** `signup` and `upgradePlan` require `email`, `firstName`, and `lastName` for new signups (every plan, including Agent).
52
+
53
+ Or do the same from the terminal:
54
+
55
+ ```bash
56
+ npx helius-cli@latest keygen # Generate keypair
57
+ npx helius-cli@latest signup --plan agent # Print hosted payment link
58
+ # (pay in browser, then:)
59
+ npx helius-cli@latest signup --resume # Finalize account
60
+ # Or autopay USDC from the local keypair:
61
+ npx helius-cli@latest signup --plan agent --pay
62
+ ```
63
+
64
+ ### 3. Start using tools
65
+
66
+ Ask questions in plain English — the right tool is selected automatically:
67
+
68
+ - "What NFTs does this wallet own?"
69
+ - "Parse this transaction: 5abc..."
70
+ - "Get the balance of Gh9ZwEm..."
71
+ - "Create a webhook for \<address\>"
72
+
73
+ ## Public Tool Surface
74
+
75
+ Helius MCP exposes 10 public tools total: 9 routed domain tools plus `expandResult`.
76
+
77
+ - `heliusAccount` — account setup, auth, plans, billing
78
+ - `heliusWallet` — wallet balances, holdings, wallet history, identity
79
+ - `heliusAsset` — assets, NFTs, collections, token holders
80
+ - `heliusTransaction` transaction parsing and wallet transaction history
81
+ - `heliusChain` — chain state, token accounts, blocks, network status, stake reads, transaction simulation
82
+ - `heliusStreaming` webhook CRUD and subscription config
83
+ - `heliusKnowledge` — docs, guides, pricing, troubleshooting, source, blog, SIMDs
84
+ - `heliusWrite` transfers and staking mutations
85
+ - `heliusCompression` — compressed account, balance, proof, and history actions
86
+ - `expandResult` expand summary-first outputs by `resultId`
87
+
88
+ The 9 routed domain tools share a common shape:
89
+
90
+ - `action` the Helius action name to run, such as `getBalance` or `createWebhook`
91
+ - domain-specific params — for example `address`, `signatures`, or `webhookURL`
92
+ - optional `detail` `summary`, `standard`, or `full`
93
+ - telemetry fields — `_feedback`, `_feedbackTool`, `_model`
94
+
95
+ Each routed tool takes an `action` field with the Helius action name:
96
+
97
+ ```json
98
+ {
99
+ "name": "heliusWallet",
100
+ "arguments": {
101
+ "action": "getBalance",
102
+ "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
103
+ "_feedback": "initial balance check",
104
+ "_feedbackTool": "heliusWallet.getBalance",
105
+ "_model": "your-model-id"
106
+ }
107
+ }
108
+ ```
109
+
110
+ 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.
111
+
112
+ ## System Prompts
113
+
114
+ This package ships with pre-built system prompts that teach AI models how to use Helius tools effectively. Find them in `system-prompts/`:
115
+
116
+ ```
117
+ system-prompts/
118
+ ├── helius/ # Core Helius skill
119
+ ├── helius-dflow/ # DFlow trading skill
120
+ ├── helius-phantom/ # Phantom frontend skill
121
+ └── svm/ # SVM architecture skill
122
+ ```
123
+
124
+ Each contains three variants:
125
+ - `openai.developer.md` — for OpenAI Responses/Chat Completions API (`developer` message)
126
+ - `claude.system.md` — for Claude API (system prompt)
127
+ - `full.md` — self-contained with all references inlined (Cursor Rules, ChatGPT, etc.)
128
+
129
+ 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.
130
+
131
+ ## Networks
132
+
133
+ Mainnet Beta (default) and Devnet. Set via `HELIUS_NETWORK` env var or `setNetwork` in the session
134
+
135
+ ## Related Resources
136
+
137
+ - [Full Documentation](https://www.helius.dev/docs)
138
+ - [LLM-Optimized Docs](https://www.helius.dev/docs/llms.txt)
139
+ - [API Reference](https://www.helius.dev/docs/api-reference)
140
+ - [Billing and Credits](https://www.helius.dev/docs/billing/credits.md)
141
+ - [Rate Limits](https://www.helius.dev/docs/billing/rate-limits.md)
142
+ - [Dashboard](https://dashboard.helius.dev)
143
+ - [Status Page](https://helius.statuspage.io)
144
+ - [Full Agent Signup Instructions](https://dashboard.helius.dev/agents.md)
package/dist/http.d.ts CHANGED
@@ -1 +1 @@
1
- export declare const MCP_USER_AGENT = "helius-mcp/1.3.0";
1
+ export declare const MCP_USER_AGENT = "helius-mcp/2.1.0";