Clawswap

io.github.WarTech9Published by GitHub account WarTech9v0.1.5Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyCloud & InfrastructureFinance

Overview

AI-generated overview

A local MCP server that lets an assistant quote, execute and track cross-chain token bridges between Solana and Base using configured wallet keys.

What you can do
Quote a bridge between Solana and Base without paying or executing, with amount, token, chains and slippage options. Execute a bridge that handles quote, payment, signing, submission and settlement in one call, optionally to a chosen recipient and destination token. Check the status of a previously initiated bridge by its request ID.
When to use it
Use it when an assistant needs to move USDC, USDT, SOL, ETH or WETH between Solana and Base, or to preview and price such a transfer before committing. It suits agent-driven cross-chain payments rather than general wallet management.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. A Base58 Solana private key in SOLANA_PRIVATE_KEY is required for Solana-to-Base bridges, and a 0x-prefixed Base/EVM private key in BASE_PRIVATE_KEY for Base-to-Solana bridges. Optional SOLANA_RPC_URL and BASE_RPC_URL override the default public RPC endpoints. Network access to both chains is required.
Before you install
The server holds raw private keys for both chains in environment variables, giving it full control of those wallets; use dedicated, low-balance wallets. Bridges sign and submit real transactions and move funds. Solana-to-Base bridges cost 0.50 USDC paid automatically via x402, and Base-to-Solana bridges spend Base gas. Slippage and recipient defaults should be checked before executing.

Installation

In SourceWeft

  1. Open Clawswap in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@clawswap/mcp-server

[npm version] [License: MIT] [npm downloads]

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:

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

bash
claude mcp add clawswap -- npx -y @clawswap/mcp-server

Then set environment variables:

bash
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):

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"      }    }  }}

Windsurf

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

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

bash
codex mcp add clawswap -- npx -y @clawswap/mcp-server

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

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:

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

bash
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

Source: README.md at commit 79b9f04

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.5LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts