English Français العربية

io.github.WarTech9/clawswap

Official registry AI and agents

Cross-chain swaps between Solana and Base for AI agents paid for via via x402 micropayments.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @clawswap/mcp-server
Claude Code 
claude mcp add clawswap -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'BASE_PRIVATE_KEY=<your base_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BASE_RPC_URL=<BASE_RPC_URL>' -- npx -y @clawswap/mcp-server@0.1.5
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "clawswap": {
            "command": "npx",
            "args": [
                "-y",
                "@clawswap/mcp-server@0.1.5"
            ],
            "env": {
                "SOLANA_PRIVATE_KEY": "<your solana_private_key>",
                "BASE_PRIVATE_KEY": "<your base_private_key>",
                "SOLANA_RPC_URL": "<SOLANA_RPC_URL>",
                "BASE_RPC_URL": "<BASE_RPC_URL>"
            }
        }
    }
}

Environment variables

  • SOLANA_PRIVATE_KEY required secret Base58-encoded Solana private key (required for Solana → Base bridges)
  • BASE_PRIVATE_KEY secret 0x-prefixed hex Base/EVM private key (required for Base → Solana bridges)
  • SOLANA_RPC_URL Solana RPC endpoint URL
  • BASE_RPC_URL Base RPC endpoint URL

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @clawswap/mcp-server
  2. What can it do?
  3. Installation
  4. Tools
  5. Environment Variables
  6. Fees
  7. Supported Tokens
  8. License

@clawswap/mcp-server

Send, swap, and bridge tokens cross-chain between Solana and Base — gasless, in one tool call. Built for AI agents using the Model Context Protocol (MCP).

What can it do?

Ask your AI agent any of these:

  • "Send 10 USDC from Solana to Base"
  • "How much would it cost to bridge 100 USDC to Base?"
  • "Transfer my SOL to Base as ETH"
  • "Swap 50 USDT from Base to Solana"
  • "Move my stablecoins cross-chain"

The server handles the entire flow: quote → payment → signing → submission → settlement.

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "clawswap": {
      "command": "npx",
      "args": ["-y", "@clawswap/mcp-server"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your-base58-solana-private-key",
        "BASE_PRIVATE_KEY": "0x-your-hex-base-private-key"
      }
    }
  }
}
Claude Code
claude mcp add clawswap -- npx -y @clawswap/mcp-server

Then set environment variables:

export SOLANA_PRIVATE_KEY="your-base58-solana-private-key"
export BASE_PRIVATE_KEY="0x-your-hex-base-private-key"
Cursor

Add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "clawswap": {
      "command": "npx",
      "args": ["-y", "@clawswap/mcp-server"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your-base58-solana-private-key",
        "BASE_PRIVATE_KEY": "0x-your-hex-base-private-key"
      }
    }
  }
}
Windsurf

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

{
  "mcpServers": {
    "clawswap": {
      "command": "npx",
      "args": ["-y", "@clawswap/mcp-server"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your-base58-solana-private-key",
        "BASE_PRIVATE_KEY": "0x-your-hex-base-private-key"
      }
    }
  }
}
OpenAI Codex
codex mcp add clawswap -- npx -y @clawswap/mcp-server

Or add to ~/.codex/config.toml:

[mcp_servers.clawswap]
command = "npx"
args = ["-y", "@clawswap/mcp-server"]
env = { SOLANA_PRIVATE_KEY = "your-base58-solana-private-key", BASE_PRIVATE_KEY = "0x-your-hex-base-private-key" }
Antigravity

Add to ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "clawswap": {
      "command": "npx",
      "args": ["-y", "@clawswap/mcp-server"],
      "env": {
        "SOLANA_PRIVATE_KEY": "your-base58-solana-private-key",
        "BASE_PRIVATE_KEY": "0x-your-hex-base-private-key"
      }
    }
  }
}
Smithery
npx -y @smithery/cli install @clawswap/mcp-server --client claude

Supports multiple clients: claude, cursor, windsurf, cline, vscode, and more.

Tools

clawswap_bridge

Bridge tokens between Solana and Base. Handles the entire flow automatically.

ParameterTypeRequiredDescription
amountstringyesHuman-readable amount, e.g. "100", "0.5"
tokenstringyesToken symbol: USDC, USDT, SOL, ETH, WETH
from"solana" \"base"yesSource chain
to"solana" \"base"yesDestination chain
recipientstringnoDestination address (defaults to agent's own)
destinationTokenstringnoDestination token (defaults to same or USDC)
slippagenumbernoSlippage tolerance 0-1 (default 0.01)
clawswap_quote

Preview a bridge quote without executing. Free, no payment required.

Same parameters as clawswap_bridge minus recipient.

clawswap_status

Check the status of a previously initiated bridge.

ParameterTypeRequiredDescription
requestIdstringyesThe requestId from clawswap_bridge

Environment Variables

VariableRequiredDescription
SOLANA_PRIVATE_KEYFor Solana→BaseBase58-encoded Solana private key
BASE_PRIVATE_KEYFor Base→Solana0x-prefixed hex Base/EVM private key
SOLANA_RPC_URLNoSolana RPC (default: https://api.mainnet-beta.solana.com)
BASE_RPC_URLNoBase RPC (default: https://mainnet.base.org)

You only need keys for the direction(s) you want to bridge. The server starts with whatever is configured.

Fees

  • Solana → Base: $0.50 USDC (paid automatically via x402 protocol, gas sponsored by ClawSwap)
  • Base → Solana: Free (agent pays ~$0.001 Base gas directly)

Supported Tokens

  • Solana: USDC, USDT, SOL
  • Base: USDC, USDT, ETH, WETH

License

MIT

Frequently asked questions

What is io.github.WarTech9/clawswap?

Cross-chain swaps between Solana and Base for AI agents paid for via via x402 micropayments.

How do I install io.github.WarTech9/clawswap?

It runs on your machine. In Claude Code: claude mcp add clawswap -e 'SOLANA_PRIVATE_KEY=<your solana_private_key>' -e 'BASE_PRIVATE_KEY=<your base_private_key>' -e 'SOLANA_RPC_URL=<SOLANA_RPC_URL>' -e 'BASE_RPC_URL=<BASE_RPC_URL>' -- npx -y @clawswap/mcp-server@0.1.5. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.WarTech9/clawswap need an API key?

Yes. It expects SOLANA_PRIVATE_KEY, BASE_PRIVATE_KEY, which you set in its configuration.

Is io.github.WarTech9/clawswap open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.WarTech9/clawswap?

It is published by WarTech9. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.