Based MCP Server

An MCP (Model Context Protocol) server that enables Claude Desktop to execute wallet operations on the Base network.

Features

• swap_tokens: Swap tokens on Base network (e.g., "swap 0.1 ETH for USDC")
• get_balance: Check wallet token balances

Installation

cd based-mcp
npm install
npm run build

Configuration

Claude Desktop Configuration

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "based-mcp": {
      "command": "node",
      "args": ["/path/to/based-mcp/dist/index.js"],
      "env": {
        "BASETOOLS_API_KEY": "your-api-key",
        "WALLET_PRIVATE_KEY": "your-wallet-private-key"
      }
    }
  }
}

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | BASETOOLS_API_URL | BaseTools API URL (default: https://basedmcp.xyz) | No | | BASETOOLS_API_KEY | Your BaseTools API key | Yes | | WALLET_PRIVATE_KEY | Private key for the wallet to use for swaps | Yes |

Usage in Claude Desktop

Once configured, you can use natural language to execute operations:

Swapping Tokens

• "Swap 0.1 ETH for USDC"
• "Exchange 100 USDC to WETH"
• "Convert 50 DAI to ETH with 3% slippage"

Checking Balances

• "What's my ETH balance?"
• "Check my USDC balance"
• "How much WETH do I have?"

Supported Tokens

The following tokens are supported by ticker:

• ETH (native)
• WETH
• USDC
• USDbC
• DAI
• DEGEN
• BRETT
• TOSHI
• AERO
• cbETH
• rETH
• wstETH

You can also use any token by providing its contract address.

Fee Structure

A 0.5% fee is collected from the input amount on each swap. The fee is transferred before the swap is executed.

Security

• Never share your private key
• Store sensitive configuration securely
• The private key is only used locally and transmitted to the BaseTools API over HTTPS

Development

# Run in development mode
npm run dev

# Build for production
npm run build

# Clean build artifacts
npm run clean

License

MIT