Houdini Agent

Swap crypto.
Without leaving Claude.

Swap crypto privately from a chat. No signup, no API key. Pay per call in USDC on Base or Solana.

trusted by our global partners

One server. Two ways to get started.

Choose Claude Desktop for MCP tools, or Claude Code for the plugin with tools and swap instructions.

Step 1 — Fund a wallet with USDC on Base

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.

Step 2 — Open your Claude Desktop config

Open Settings → Developer → Edit Config.

macOS

Copy Text
~/Library/Application Support/Claude/claude_desktop_config.json

Windows

Copy Text
%APPDATA%\Claude\claude_desktop_config.json

Step 3 — Add the HoudiniSwap server

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.

Copy Text
{
  "mcpServers": {
    "houdiniswap": {
      "command": "npx",
      "args": ["-y", "@houdiniswap/mcp-server"],
      "env": {
        "HOUDINI_X402_PRIVATE_KEY": "0xYOUR_WALLET_PRIVATE_KEY"
      }
    }
  }
}

Step 4 — Restart and check the connection

Fully quit Claude Desktop and reopen it. Look for HoudiniSwap in the tools menu, then ask:

Copy Text
Find USDC on Base using HoudiniSwap.

This token lookup is a paid API call. It does not create a swap order.

Step 1 — Fund a wallet and copy its key

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.

Step 2 — Add the HoudiniSwap marketplace

Run claude in your terminal. Inside Claude Code, enter:

Copy Text
/plugin marketplace add HoudiniSwap/houdiniswap-agent

Step 3 — Install the plugin

Copy Text
/plugin install houdiniswap@houdiniswap

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.

Step 4 — Restart and check the connection

Type /exit, then run claude again. Run /mcp and check that HoudiniSwap is connected. Then try asking:

Copy Text
Find USDC on Base using HoudiniSwap.

What can you ask Claude?

Claude shows you tokens and quotes, then waits for your pick before it creates anything.

Find Tokens

"which chains have SOL?"

Contract address, price and whether the token is verified.

Compare Quotes

"best quote for 0.1 ETH to BTC"

Every provider at once, sorted by best price or fastest route.

Private Swap

"private swap 50 USDC on Base to BTC"

Routed through a intermediary token so the sending and receiving addresses can't be linked onchain.

Cross-chain Swap

"swap 20 USDC on Base to SOL, send to [address]"

You give the receiving address. Claude gives you the deposit address.

DEX Swap

"swap 10 USDC to ETH on Base with a DEX"

Uniswap, Jupiter, Aerodrome, deBridge and more. You approve in your own wallet.

Track Orders

"my orders from today"

Status, deposit address and transaction hashes for the last 48 hours.

Pay per call. No plan required.

Action
Price per call (USDC)
Search tokens, chains, providers, min/max, order status
$0.0001
Get quotes
$0.001
Create an order / confirm a DEX transaction
$0.01
Typical API flow to create an order
About $0.012

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.

Frequently Asked Questions

Does Claude send my swap funds?

Why do I see 402 Payment Required?

Why are the HoudiniSwap tools missing?

What does 429 Too Many Requests mean?

How do I change the payment wallet?

Explore our other products