io.github.azeth-protocol/mcp-server MCP Server

Name: io.github.azeth-protocol/mcp-server MCP Server
Author: io.github.azeth-protocol

io.github.azeth-protocol/mcp-server

Repository Registry

What is the io.github.azeth-protocol/mcp-server MCP server?

Smart accounts, x402 payments, on-chain reputation, and service discovery for AI agents

How to install io.github.azeth-protocol/mcp-server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

AZETH_PRIVATE_KEY
secret
Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
AZETH_CHAIN
Target chain: base, baseSepolia, ethereum, ethereumSepolia (default: baseSepolia)
AZETH_GUARDIAN_KEY
secret
Guardian co-signing private key for operations exceeding spending limits (optional)
AZETH_GUARDIAN_AUTO_SIGN
Set to 'true' to enable automatic guardian co-signing (requires AZETH_GUARDIAN_KEY)
AZETH_RPC_URL_BASE_SEPOLIA
Custom RPC for Base Sepolia (optional, defaults to public RPC). Per-chain: AZETH_RPC_URL_BASE, AZETH_RPC_URL_ETH_SEPOLIA, AZETH_RPC_URL_ETHEREUM
AZETH_SERVER_URL
Azeth server URL for off-chain operations like reputation queries (optional)
AZETH_EMERGENCY_ADDRESS
Emergency withdrawal destination address (defaults to owner EOA if not set)
XMTP_ENCRYPTION_KEY
secret
XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
        "AZETH_CHAIN": "<YOUR_AZETH_CHAIN>",
        "AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
        "AZETH_GUARDIAN_AUTO_SIGN": "<YOUR_AZETH_GUARDIAN_AUTO_SIGN>",
        "AZETH_RPC_URL_BASE_SEPOLIA": "<YOUR_AZETH_RPC_URL_BASE_SEPOLIA>",
        "AZETH_SERVER_URL": "<YOUR_AZETH_SERVER_URL>",
        "AZETH_EMERGENCY_ADDRESS": "<YOUR_AZETH_EMERGENCY_ADDRESS>",
        "XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
        "AZETH_CHAIN": "<YOUR_AZETH_CHAIN>",
        "AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
        "AZETH_GUARDIAN_AUTO_SIGN": "<YOUR_AZETH_GUARDIAN_AUTO_SIGN>",
        "AZETH_RPC_URL_BASE_SEPOLIA": "<YOUR_AZETH_RPC_URL_BASE_SEPOLIA>",
        "AZETH_SERVER_URL": "<YOUR_AZETH_SERVER_URL>",
        "AZETH_EMERGENCY_ADDRESS": "<YOUR_AZETH_EMERGENCY_ADDRESS>",
        "XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
        "AZETH_CHAIN": "<YOUR_AZETH_CHAIN>",
        "AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
        "AZETH_GUARDIAN_AUTO_SIGN": "<YOUR_AZETH_GUARDIAN_AUTO_SIGN>",
        "AZETH_RPC_URL_BASE_SEPOLIA": "<YOUR_AZETH_RPC_URL_BASE_SEPOLIA>",
        "AZETH_SERVER_URL": "<YOUR_AZETH_SERVER_URL>",
        "AZETH_EMERGENCY_ADDRESS": "<YOUR_AZETH_EMERGENCY_ADDRESS>",
        "XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
        "AZETH_CHAIN": "<YOUR_AZETH_CHAIN>",
        "AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
        "AZETH_GUARDIAN_AUTO_SIGN": "<YOUR_AZETH_GUARDIAN_AUTO_SIGN>",
        "AZETH_RPC_URL_BASE_SEPOLIA": "<YOUR_AZETH_RPC_URL_BASE_SEPOLIA>",
        "AZETH_SERVER_URL": "<YOUR_AZETH_SERVER_URL>",
        "AZETH_EMERGENCY_ADDRESS": "<YOUR_AZETH_EMERGENCY_ADDRESS>",
        "XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

Claude Code

claude mcp add mcp-server --env AZETH_PRIVATE_KEY=<YOUR_AZETH_PRIVATE_KEY> --env AZETH_CHAIN=<YOUR_AZETH_CHAIN> --env AZETH_GUARDIAN_KEY=<YOUR_AZETH_GUARDIAN_KEY> --env AZETH_GUARDIAN_AUTO_SIGN=<YOUR_AZETH_GUARDIAN_AUTO_SIGN> --env AZETH_RPC_URL_BASE_SEPOLIA=<YOUR_AZETH_RPC_URL_BASE_SEPOLIA> --env AZETH_SERVER_URL=<YOUR_AZETH_SERVER_URL> --env AZETH_EMERGENCY_ADDRESS=<YOUR_AZETH_EMERGENCY_ADDRESS> --env XMTP_ENCRYPTION_KEY=<YOUR_XMTP_ENCRYPTION_KEY> -- npx -y @azeth/mcp-server