Choose Claude Desktop for MCP tools, or Claude Code for the plugin with tools and swap instructions.
Add a small amount of USDC on Base or Solana to your dedicated payment wallet, then export its private key. USDC on another network will not cover these API payments.
Open Settings → Developer → Edit Config.
macOS
Windows
For a new config, paste the complete example below. If you already have servers configured, add only the houdiniswap entry inside your existing mcpServers object. Replace 0xYOUR_WALLET_PRIVATE_KEY with your actual private key.
If you already have other servers under mcpServers , add houdiniswap as another key inside the existing object — don’t
create a second mcpServers.
Add a small amount of USDC on Base or Solana to your dedicated payment wallet, then export its private key. Menu labels can vary by wallet.
Run claude in your terminal. Inside Claude Code, enter:
When the plugin asks for the x402 wallet private key, enter your payment wallet key in that configuration prompt—not in the conversation. If no configuration prompt appears, check the current plugin instructions before entering a key.
Claude shows you tokens and quotes, then waits for your pick before it creates anything.
"which chains have SOL?"
Contract address, price and whether the token is verified.
"best quote for 0.1 ETH to BTC"
Every provider at once, sorted by best price or fastest route.
"private swap 50 USDC on Base to BTC"
Routed through a intermediary token so the sending and receiving addresses can't be linked onchain.
"swap 20 USDC on Base to SOL, send to [address]"
You give the receiving address. Claude gives you the deposit address.
"swap 10 USDC to ETH on Base with a DEX"
Uniswap, Jupiter, Aerodrome, deBridge and more. You approve in your own wallet.
"my orders from today"
Status, deposit address and transaction hashes for the last 48 hours.
API charges are separate from swap fees and network gas. Total API cost depends on the number of calls, including additional quotes and status checks.
The only compliant, non-custodial swap that completelysevers the on-chain link between sender and receiver. Across any token, on any chain.
Swap across 120+ chains using the best on-chain DEX routes and bridges. Instantly and at the lowest cost.
No connection, no approvals, no signatures. Just send to a deposit address and let Houdini handle the rest.