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.
- package/CHANGELOG.md +151 -79
- package/LICENSE +21 -21
- package/README.md +144 -132
- package/dist/http.d.ts +1 -1
- package/dist/index.js +2 -56
- package/dist/results/store.d.ts +8 -0
- package/dist/results/store.js +72 -0
- package/dist/results/types.d.ts +47 -0
- package/dist/results/types.js +1 -0
- package/dist/router/action-groups.d.ts +6 -0
- package/dist/router/action-groups.js +32 -0
- package/dist/router/action-handlers.d.ts +20 -0
- package/dist/router/action-handlers.js +125 -0
- package/dist/router/actions.d.ts +12 -0
- package/dist/router/actions.js +125 -0
- package/dist/router/catalog.d.ts +6 -0
- package/dist/router/catalog.js +394 -0
- package/dist/router/context.d.ts +5 -0
- package/dist/router/context.js +10 -0
- package/dist/router/dispatch.d.ts +4 -0
- package/dist/router/dispatch.js +276 -0
- package/dist/router/instructions.d.ts +1 -0
- package/dist/router/instructions.js +25 -0
- package/dist/router/register.d.ts +2 -0
- package/dist/router/register.js +15 -0
- package/dist/router/required-params.d.ts +9 -0
- package/dist/router/required-params.js +68 -0
- package/dist/router/responses.d.ts +29 -0
- package/dist/router/responses.js +186 -0
- package/dist/router/schemas.d.ts +224 -0
- package/dist/router/schemas.js +204 -0
- package/dist/router/telemetry.d.ts +27 -0
- package/dist/router/telemetry.js +52 -0
- package/dist/router/types.d.ts +46 -0
- package/dist/router/types.js +1 -0
- package/dist/scripts/validate-catalog.d.ts +2 -2
- package/dist/scripts/validate-catalog.js +10 -10
- package/dist/tools/accounts.js +5 -5
- package/dist/tools/assets.js +5 -5
- package/dist/tools/auth.js +392 -319
- package/dist/tools/config.js +3 -3
- package/dist/tools/das-extras.js +6 -6
- package/dist/tools/docs.js +55 -41
- package/dist/tools/enhanced-websockets.js +13 -13
- package/dist/tools/fees.js +3 -3
- package/dist/tools/index.d.ts +1 -1
- package/dist/tools/index.js +2 -80
- package/dist/tools/laserstream.js +20 -23
- package/dist/tools/network.js +10 -4
- package/dist/tools/plans.d.ts +0 -5
- package/dist/tools/plans.js +167 -12
- package/dist/tools/product-catalog.d.ts +1 -0
- package/dist/tools/product-catalog.js +52 -17
- package/dist/tools/recommend.d.ts +0 -1
- package/dist/tools/recommend.js +9 -28
- package/dist/tools/shared.d.ts +1 -0
- package/dist/tools/shared.js +21 -13
- package/dist/tools/solana-knowledge.js +23 -7
- package/dist/tools/staking.d.ts +2 -0
- package/dist/tools/staking.js +268 -0
- package/dist/tools/transactions.js +256 -3
- package/dist/tools/transfers.js +38 -43
- package/dist/tools/wallet.js +77 -17
- package/dist/tools/webhooks.js +3 -3
- package/dist/tools/zk-compression.d.ts +2 -0
- package/dist/tools/zk-compression.js +781 -0
- package/dist/utils/config.d.ts +2 -2
- package/dist/utils/config.js +68 -6
- package/dist/utils/errors.d.ts +10 -1
- package/dist/utils/errors.js +46 -12
- package/dist/utils/feedback.js +1 -4
- package/dist/utils/helius.js +25 -14
- package/dist/utils/ows.d.ts +74 -0
- package/dist/utils/ows.js +155 -0
- package/dist/utils/resilience.d.ts +39 -0
- package/dist/utils/resilience.js +130 -0
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/package.json +63 -64
- package/system-prompts/helius/claude.system.md +200 -170
- package/system-prompts/helius/full.md +3236 -2869
- package/system-prompts/helius/openai.developer.md +200 -170
- package/system-prompts/helius-dflow/claude.system.md +324 -290
- package/system-prompts/helius-dflow/full.md +4160 -3648
- package/system-prompts/helius-dflow/openai.developer.md +324 -290
- package/system-prompts/helius-jupiter/claude.system.md +333 -0
- package/system-prompts/helius-jupiter/full.md +5133 -0
- package/system-prompts/helius-jupiter/openai.developer.md +333 -0
- package/system-prompts/helius-okx/claude.system.md +182 -0
- package/system-prompts/helius-okx/full.md +584 -0
- package/system-prompts/helius-okx/openai.developer.md +182 -0
- package/system-prompts/helius-phantom/claude.system.md +345 -333
- package/system-prompts/helius-phantom/full.md +5649 -5473
- package/system-prompts/helius-phantom/openai.developer.md +345 -333
- package/system-prompts/svm/claude.system.md +159 -159
- package/system-prompts/svm/full.md +631 -631
- package/system-prompts/svm/openai.developer.md +159 -159
- package/dist/scripts/test-htmltotext.d.ts +0 -5
- package/dist/scripts/test-htmltotext.js +0 -67
- package/dist/scripts/test-solana-knowledge.d.ts +0 -9
- package/dist/scripts/test-solana-knowledge.js +0 -272
- package/dist/scripts/validate-templates.d.ts +0 -12
- 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.
|
|
11
|
-
|
|
12
|
-
### Merged
|
|
13
|
-
|
|
14
|
-
- feat(
|
|
15
|
-
-
|
|
16
|
-
- feat(
|
|
17
|
-
- feat(cli): Add
|
|
18
|
-
- feat(cli): Add
|
|
19
|
-
- feat(
|
|
20
|
-
-
|
|
21
|
-
- fix(cli):
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
- feat
|
|
42
|
-
- feat(
|
|
43
|
-
- feat(
|
|
44
|
-
- feat(
|
|
45
|
-
-
|
|
46
|
-
- feat(
|
|
47
|
-
- feat(
|
|
48
|
-
- Add
|
|
49
|
-
-
|
|
50
|
-
- feat(
|
|
51
|
-
- feat(
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
55
|
-
-
|
|
56
|
-
-
|
|
57
|
-
-
|
|
58
|
-
- Add
|
|
59
|
-
-
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
-
|
|
63
|
-
-
|
|
64
|
-
- feat(
|
|
65
|
-
-
|
|
66
|
-
- feat(mcp): Add
|
|
67
|
-
- feat(
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
- feat(
|
|
72
|
-
- feat:
|
|
73
|
-
- feat
|
|
74
|
-
-
|
|
75
|
-
- fix:
|
|
76
|
-
- feat
|
|
77
|
-
-
|
|
78
|
-
- fix:
|
|
79
|
-
-
|
|
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
|
|
45
|
-
|
|
46
|
-
1. Call the `generateKeypair` tool — it creates a Solana wallet and returns the address
|
|
47
|
-
2.
|
|
48
|
-
3.
|
|
49
|
-
4.
|
|
50
|
-
|
|
51
|
-
> **
|
|
52
|
-
|
|
53
|
-
Or do the same from the terminal:
|
|
54
|
-
|
|
55
|
-
```bash
|
|
56
|
-
npx helius-cli@latest keygen
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
- "
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
-
|
|
126
|
-
-
|
|
127
|
-
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
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.
|
|
1
|
+
export declare const MCP_USER_AGENT = "helius-mcp/2.1.0";
|