
helm-mcp
io.github.gambrelcolby63/helm-mcp
HelmSwap quotes and unsigned swaps. Disclosed 10/50/100 bps fees. Never signs.
Documentation
HelmSwap developer kit
Public TypeScript SDK and MCP server for HelmSwap, a non-custodial swap terminal operated by Summit Private Credit LLC.
Live since 18 November 2026, 11:57 PM CT, on Solana, Base, BNB Chain, Ethereum and Robinhood Chain.
| Package | npm (after you publish) | What it does |
|---|---|---|
helmswap | packages/helm-sdk | Quote + unsigned swap client |
helmswap-mcp | packages/helm-mcp | stdio MCP server (get_quote, build_swap) |
Neither package holds keys, signs, or broadcasts. The user signs in their own wallet.
Quickstart
npm install helmswap
import { Helm } from "helmswap";
const helm = new Helm({ payoutAddress: "0xYourPayout" }); // 20% of Helm's fee
const quote = await helm.quote({ chainId: 8453, tokenIn: "ETH", tokenOut: USDC, amountIn: 10n ** 16n });
const built = await helm.buildTx({ quote, recipient: userWallet });
// built.tx goes to the user's wallet. Helm does not submit it.
Solana:
const quote = await helm.quote({ chain: "solana", tokenIn: "SOL", tokenOut: usdcMint, amountIn: 50_000_000n });
const built = await helm.buildTx({ quote, recipient: userSolanaWallet });
// built.solanaTx.transactionBase64
MCP (after publish):
{ "mcpServers": { "helmswap": { "command": "npx", "args": ["-y", "helmswap-mcp"], "env": { "HELM_REFERRER": "0xYourPayout" } } } }
Fees (disclosed)
- 10 bps majors, 50 bps listed, 100 bps long-tail / new tokens (including pump.fun bonding-curve coins).
- pump.fun also charges its own curve fee (~1.25%), paid to the creator and pump.fun, not Helm.
- Keyless integrator / referral share: 20% of Helm's fee, live and verified on 19 Nov 2026. The user pays the same total.
- A 40% API-key share is in the API code but cannot be issued on the live host today (no persistent key store). Do not advertise it yet.
- Helm does not claim the best price.
Not live, not in these packages
Perps, predictions, and limit / DCA signing. Predictions and perps (when they exist) keep a US block; spot swaps on this API are available to US users. Tokenized stocks return HTTP 451.
Arbitrum and Polygon may return quotes; build-tx is refused until a fee router is deployed there.
Develop in this repo
npm install
npm test
npm run build
Directory and BotFather listing copy, plus the exact publish order, is in /workspace/launch-hours-20261118/BOT-TRAFFIC-LISTINGS.md.
License
MIT © Summit Private Credit LLC
helmswap-mcpnpm install helmswap-mcp