English Français العربية

io.github.WarTech9/clawswap

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

متغيرات البيئة

  • SOLANA_PRIVATE_KEY إلزامي سري Base58-encoded Solana private key (required for Solana → Base bridges)
  • BASE_PRIVATE_KEY سري 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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.WarTech9/clawswap؟

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

كيف أثبّت io.github.WarTech9/clawswap؟

يعمل على جهازك. في 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 من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.WarTech9/clawswap إلى مفتاح API؟

نعم. يتطلب SOLANA_PRIVATE_KEY, BASE_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.WarTech9/clawswap مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.WarTech9/clawswap؟

ينشره WarTech9. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.