Skip to main content
Glama
README.md
# HelmSwap developer kit

Public TypeScript SDK and MCP server for [HelmSwap](https://helmswap.com), 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

```bash
npm install helmswap
```

```ts
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:

```ts
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):

```json
{ "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

```bash
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