Skip to content

fix(helius-mcp): Require email for agent signup - #191

Merged
0xIchigo merged 5 commits into
mainfrom
nathan(helius-mcp)/require-signup-email
Oct 14, 2026
Merged

0xIchigo merged 5 commits into
mainfrom
nathan(helius-mcp)/require-signup-email

Conversation

@nathanliow

@nathanliow nathanliow commented Oct 9, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Part of making real contact info required for new agent signups (the wallet is only the payment method).

  • CLI helius signup / MCP signup: no up-front contact check. The SDK asks for email, firstName and lastName only when the wallet has no account yet, so existing wallets can still re-run signup to recover their key. The SDK's contact-info and invalid-email errors are mapped to INVALID_INPUT (CLI, with --email-style flag names) and VALIDATION / MISSING_CONTACT_INFO (MCP).
  • Hints and descriptions: MCP tool/field descriptions and new-account hints say contact info is required for a new account. Hints for existing-wallet re-auth (not authenticated / expired) intentionally stay as plain "Call signup".
  • Pricing: Agent plan is $10 one-time everywhere: helius plans (key renamed basic → agent), helius keygen, MCP no-key message, skills and prompts, root README (the 1 USDC basic-plan funding step is gone).
  • CLI: removed the unused createProject wrapper in lib/api.ts. Added an Unreleased entry to helius-cli/CHANGELOG.md.
  • Deps: helius-sdk bumped to ^3.3.0 in helius-cli and helius-mcp (lockfiles resolve 3.3.0, which ships the signup contact-info validation from fix(auth): Validate signup contact info and deprecate wallet project creation helius-sdk#359).
  • Skills: onboarding references and build skills updated; regenerated with compile-skills.ts.

Follow-ups

  • Backend: helius-labs/monorepo#20801.
  • Move the $10 price into the SDK plan catalog instead of hard-coding it.

Verification

  • helius-mcp: tsc --noEmit clean; pnpm test: 324 passed, including existing-wallet (no email) and missing-contact cases.
  • helius-cli: pnpm build clean; pnpm test: 65 passed.
  • npx tsx scripts/compile-skills.ts --check: in sync.

🤖 Generated with Claude Code

New signups through MCP and CLI now refuse up front, before loading the
keypair or calling the API, unless email, first name, and last name are
all provided. Previously the check lived only in the SDK's no-project
branch. Resume and pending-intent reuse are unchanged.

Also drops the CLI's unused createProject wrapper (the legacy wallet
free-plan path) and states the contact-info requirement in the
onboarding skill references.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
nathanliow and others added 3 commits October 9, 2026 18:25
The up-front contact-info check in the CLI and MCP blocked wallets that
already have an account from re-running signup to recover their key.
Drop it and rely on the SDK, which asks for email, first and last name
only when it has to create a new account. The CLI maps that SDK error
to INVALID_INPUT with CLI flag names; the MCP maps it to a validation
error.

Also correct stale signup guidance: `helius plans` lists the Agent tier
as `agent` at $10 one-time, `helius keygen` and the MCP no-key message
show the contact flags, and the skills' price and decision tables are
updated and recompiled. The root README drops the 1 USDC basic-plan funding step and shows the contact flags.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
List the Agent plan at $10 in the remaining skills and prompts, mention
email/firstName/lastName in the MCP status hints, and add a CLI
changelog entry for the signup contact flags and the plans key rename.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Add email/firstName/lastName to the remaining MCP signup recovery hints
and bring the build skill CLI path in line with the main skill.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

@0xIchigo 0xIchigo left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM :shipit:

@0xIchigo
0xIchigo merged commit 108ca55 into main Oct 14, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants