Getting Started

MCP Setup Guide

Connect Clawmmerce to your AI agent using the Model Context Protocol (MCP).

Prerequisites

  • Node.js 18 or higher installed
  • A Clawmmerce account with a wallet created
  • An MCP-compatible AI client (Claude Desktop, OpenClaw, etc.)
1

Create a Clawmmerce Wallet

First, sign up and create a wallet for your AI agent. Each wallet gets its own address and permission settings.

Create Wallet →

During setup, you'll authenticate with a passkey (fingerprint, Face ID, or security key). This ensures only you can approve high-value transactions.

2

Get Your Credentials

After creating your wallet, you'll receive:

  • •API Key — Authenticates your agent with Clawmmerce
  • •Wallet ID — Identifies which wallet to use
⚠️ Keep these secret!

Never share your API key publicly. It grants access to your wallet within your permission limits.

3

Configure Your MCP Client

Choose your AI client and add the Clawmmerce MCP server configuration:

Open Claude Desktop settings and add this to your MCP configuration:

claude_desktop_config.json
{
  "mcpServers": {
    "clawmmerce": {
      "command": "npx",
      "args": ["-y", "clawmmerce-mcp"],
      "env": {
        "CLAWMMERCE_API_KEY": "your-api-key-here",
        "CLAWMMERCE_WALLET_ID": "your-wallet-id"
      }
    }
  }
}

On macOS, this file is located at: ~/Library/Application Support/Claude/claude_desktop_config.json

4

Test the Connection

Ask your AI agent to check your wallet balance:

"What's my Clawmmerce wallet balance?"

If configured correctly, your agent should report your current balance and available tokens.

Available MCP Tools

Once connected, your agent can use these tools:

get_balanceCheck wallet balances for any token
swap_tokensSwap tokens on Uniswap (subject to permissions)
send_tokenTransfer tokens to another address
get_priceGet current token prices
get_transaction_historyView recent transactions

Troubleshooting

"Server not found" error

Make sure Node.js 18+ is installed and npx is available in your PATH. Try running npx -y clawmmerce-mcp --version in your terminal.

"Invalid API key" error

Double-check your API key in the configuration. Make sure there are no extra spaces or quotes.

Transactions are being blocked

Check your permission settings. The transaction might exceed your auto-approve limit or daily spending cap.

← Back to DocsNext: Strategies →