Skip to content
MCP server

HelmSwap

MCP server that quotes multi-chain swaps and builds unsigned transactions for a wallet

Runs locally
Install

HelmSwap is an open-source MCP server for crypto and web3. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, macOS
Runs
Locally
Version
0.1.1
Listing updated

Similar MCP servers

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "helm-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "helmswap-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • HELM_REFERREROptional payout address (EVM or Solana). Receives 20 percent of Helm's disclosed fee. Address only, never a key.
  • HELM_BASE_URLHelmSwap API origin. Defaults to https://helmswap.com.

About HelmSwap

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.

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Server is MIT-licensed; swaps carry disclosed fees of 10 to 100 bps.

Prices change. Check helmswap.com before you buy.

HelmSwap 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.

How AIPoweredBot checks servers