# HelmSwap

> HelmSwap is an open-source MCP server for crypto and web3. MCP server that quotes multi-chain swaps and builds unsigned transactions for a wallet. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://helmswap.com
- **Repository:** https://github.com/gambrelcolby63/helmswap-sdk/tree/HEAD/packages/helm-mcp
- **MCP Registry name:** io.github.gambrelcolby63/helm-mcp
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-20

## About

The README describes helmswap-mcp as a stdio server that lets AI agents request swap quotes and build unsigned transactions through the HelmSwap API. Calldata for EVM chains and Solana v0 transactions are returned to the user's own wallet, which is the only party that signs and broadcasts. The server exposes no sign, execute or broadcast tool, and it refuses to start if a private key, mnemonic or signer variable is set in the environment.

Each quote carries a disclosed fee of 10, 50 or 100 basis points depending on the token pair, and the README notes that pump.fun bonding-curve coins also incur that venue's own fee. An optional HELM_REFERRER address receives a 20% share of Helm's fee as a payout address only, with the user paying the same total either way.

The server suits developers and agent builders who want an assistant to price a swap across Solana, Base, BNB Chain, Ethereum and Robinhood Chain while keeping signing under human control. The README says Arbitrum and Polygon can quote but not build transactions, and tokenized stocks return an error.

## Features

- **Disclosed swap quotes:** The get_quote tool returns a fee-inclusive quote with a short-lived quote ticket.
- **Unsigned transaction building:** The build_swap tool produces EVM calldata or a Solana v0 transaction for the user's wallet to sign.
- **No signing or broadcasting:** The server has no execute, sign or broadcast tool and never touches private keys.
- **Optional referrer payout:** A payout address can be set through an environment variable or per tool call to receive 20% of the fee.
- **Key-material guard:** The process refuses to start if a private key, mnemonic or signer variable is present.

## Good for

- Letting an AI assistant compare swap prices before a user approves a trade
- Building an agent that prepares unsigned swap transactions for a human wallet to sign
- Checking the disclosed fee on a token pair before routing a swap on Solana or EVM chains

## Install

### Claude Code (Terminal)

```sh
claude mcp add helm-mcp -- npx -y helmswap-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "helm-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
```

## Tools

- `get_quote`: Returns a disclosed swap quote and a short-lived quote ticket.
- `build_swap`: Builds unsigned EVM calldata or a Solana v0 transaction for the user's wallet.

## FAQ

### Does the server sign or broadcast transactions?

No. The README says there is no execute, sign or broadcast tool, and the user's wallet signs.

### What fees apply?

Helm's fee is 10 bps on majors, 50 bps on listed tokens and 100 bps on long-tail tokens. Pump.fun bonding-curve coins also pay pump.fun's own venue fee of about 1.25%.

### Which chains can build transactions?

The README lists Solana, Base, BNB Chain, Ethereum and Robinhood Chain as live. Arbitrum and Polygon can quote but cannot build.

### How is the server installed?

The README gives npx -y helmswap-mcp as the install command, with a Claude Desktop or Cursor MCP config example.

### Is HelmSwap free?

Yes. HelmSwap is open source, so you can use and self-host it for free.

### How do I add HelmSwap to Claude Code?

Run this command in your terminal: claude mcp add helm-mcp -- npx -y helmswap-mcp

### What are the best alternatives to HelmSwap?

The closest alternatives to HelmSwap are Swap-API, Uniswap Tx Builder MCP, Universal Blockchain MCP, Clawswap and Tollbooth Swap API.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Swap-API](https://ai-powered.com/mcp/swap-api): Swap-API is an open-source MCP server for crypto and web3.
- [Uniswap Tx Builder MCP](https://ai-powered.com/mcp/uniswap-tx-builder-mcp): Uniswap Tx Builder MCP is an open-source MCP server for crypto and web3.
- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [Clawswap](https://ai-powered.com/mcp/clawswap): Clawswap is an open-source MCP server for crypto and web3.
- [Tollbooth Swap API](https://ai-powered.com/mcp/tollbooth-swap-api): Tollbooth Swap API is a freemium MCP server for crypto and web3.
- [Stoa: swaps on Robinhood Chain](https://ai-powered.com/mcp/stoa-swaps-on-robinhood-chain): Stoa: swaps on Robinhood Chain is a free MCP server for crypto and web3.
- [mindjack.xyz](https://ai-powered.com/mcp/mindjack-xyz): mindjack.xyz is a freemium MCP server for crypto and web3.
- [Trade Router MCP](https://ai-powered.com/mcp/trade-router-mcp-2): Trade Router MCP is an open-source MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/helmswap
