HelmSwap
MCP server that quotes multi-chain swaps and builds unsigned transactions for a wallet
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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"helm-mcp": {
"command": "npx",
"args": [
"-y",
"helmswap-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"helm-mcp": {
"command": "npx",
"args": [
"-y",
"helmswap-mcp"
]
}
}
}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.