Skip to content
MCP server

web3agent

Web3 MCP proxy for AI agents: DeFi swaps, bridges, market data, wallets, and gated writes.

Runs locally
Install
Pricing
Open source
Runs
Locally
Version
0.6.2
Listing updated
5 months ago

About web3agent

web3agent is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add web3agent --env ETHERSCAN_API_KEY='<ETHERSCAN_API_KEY>' --env ZEROX_API_KEY='<ZEROX_API_KEY>' --env COINGECKO_API_KEY='<COINGECKO_API_KEY>' --env OWS_PASSPHRASE='<OWS_PASSPHRASE>' -- npx -y web3agent

Add to claude_desktop_config.json

{
  "mcpServers": {
    "web3agent": {
      "command": "npx",
      "args": [
        "-y",
        "web3agent"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
        "ZEROX_API_KEY": "<ZEROX_API_KEY>",
        "COINGECKO_API_KEY": "<COINGECKO_API_KEY>",
        "OWS_PASSPHRASE": "<OWS_PASSPHRASE>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "web3agent": {
      "command": "npx",
      "args": [
        "-y",
        "web3agent"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
        "ZEROX_API_KEY": "<ZEROX_API_KEY>",
        "COINGECKO_API_KEY": "<COINGECKO_API_KEY>",
        "OWS_PASSPHRASE": "<OWS_PASSPHRASE>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "web3agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "web3agent"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
        "ZEROX_API_KEY": "<ZEROX_API_KEY>",
        "COINGECKO_API_KEY": "<COINGECKO_API_KEY>",
        "OWS_PASSPHRASE": "<OWS_PASSPHRASE>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "web3agent": {
      "command": "npx",
      "args": [
        "-y",
        "web3agent"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
        "ZEROX_API_KEY": "<ZEROX_API_KEY>",
        "COINGECKO_API_KEY": "<COINGECKO_API_KEY>",
        "OWS_PASSPHRASE": "<OWS_PASSPHRASE>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "web3agent": {
      "command": "npx",
      "args": [
        "-y",
        "web3agent"
      ],
      "env": {
        "ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
        "ZEROX_API_KEY": "<ZEROX_API_KEY>",
        "COINGECKO_API_KEY": "<COINGECKO_API_KEY>",
        "OWS_PASSPHRASE": "<OWS_PASSPHRASE>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CHAIN_IDDefault EVM chain ID. Defaults to Base mainnet (8453).
  • CONFIRM_WRITESRequire explicit confirmation before write operations execute. Defaults to true.
  • ETHERSCAN_API_KEYOptional Etherscan API key for Etherscan-backed explorer tools.
  • ZEROX_API_KEYOptional 0x API key for 0x swap plugin support.
  • COINGECKO_API_KEYOptional CoinGecko API key for higher-rate market data.
  • CCXT_CONFIG_PATHOptional local path to a CCXT account config JSON file.
  • OWS_PASSPHRASEOptional Open Wallet Standard vault passphrase for persisted local wallets.

Pricing

Open source

Prices change. Check web3agent.fi before you buy.

web3agent FAQ

Is web3agent free?

Yes. web3agent is open source, so you can use and self-host it for free.

How do I add web3agent to Claude Code?

Run this command in your terminal: claude mcp add web3agent --env ETHERSCAN_API_KEY='<ETHERSCAN_API_KEY>' --env ZEROX_API_KEY='<ZEROX_API_KEY>' --env COINGECKO_API_KEY='<COINGECKO_API_KEY>' --env OWS_PASSPHRASE='<OWS_PASSPHRASE>' -- npx -y web3agent

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers