Skip to content
MCP server

azeth-protocol

MCP server giving AI agents smart accounts, x402 payments and on-chain reputation

Runs locally
Install

azeth-protocol is an open-source MCP server for agent tooling. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, Self-hosted
Runs
Locally
Version
0.2.22
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add mcp-server --env AZETH_PRIVATE_KEY='<AZETH_PRIVATE_KEY>' --env AZETH_GUARDIAN_KEY='<AZETH_GUARDIAN_KEY>' --env XMTP_ENCRYPTION_KEY='<XMTP_ENCRYPTION_KEY>' -- npx -y @azeth/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<AZETH_PRIVATE_KEY>",
        "AZETH_GUARDIAN_KEY": "<AZETH_GUARDIAN_KEY>",
        "XMTP_ENCRYPTION_KEY": "<XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<AZETH_PRIVATE_KEY>",
        "AZETH_GUARDIAN_KEY": "<AZETH_GUARDIAN_KEY>",
        "XMTP_ENCRYPTION_KEY": "<XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<AZETH_PRIVATE_KEY>",
        "AZETH_GUARDIAN_KEY": "<AZETH_GUARDIAN_KEY>",
        "XMTP_ENCRYPTION_KEY": "<XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<AZETH_PRIVATE_KEY>",
        "AZETH_GUARDIAN_KEY": "<AZETH_GUARDIAN_KEY>",
        "XMTP_ENCRYPTION_KEY": "<XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@azeth/mcp-server"
      ],
      "env": {
        "AZETH_PRIVATE_KEY": "<AZETH_PRIVATE_KEY>",
        "AZETH_GUARDIAN_KEY": "<AZETH_GUARDIAN_KEY>",
        "XMTP_ENCRYPTION_KEY": "<XMTP_ENCRYPTION_KEY>"
      }
    }
  }
}

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

Configuration

  • AZETH_PRIVATE_KEYOwner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
  • AZETH_CHAINTarget chain: base, baseSepolia, ethereum, ethereumSepolia (default: baseSepolia)
  • AZETH_GUARDIAN_KEYGuardian co-signing private key for operations exceeding spending limits (optional)
  • AZETH_GUARDIAN_AUTO_SIGNSet to 'true' to enable automatic guardian co-signing (requires AZETH_GUARDIAN_KEY)
  • AZETH_RPC_URL_BASE_SEPOLIACustom 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_URLAzeth server URL for off-chain operations like reputation queries (optional)
  • AZETH_EMERGENCY_ADDRESSEmergency withdrawal destination address (defaults to owner EOA if not set)
  • XMTP_ENCRYPTION_KEYXMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging)

About azeth-protocol

The README says the server exposes 32 tools that let an AI client create smart accounts, send payments, look up services in a trust registry, rate providers and message other agents over XMTP. Accounts are set up on first use: a private key is generated automatically and stored at ~/.azeth/key, so no API keys are needed to start on testnet.

Tools are grouped into account management, transfers, x402 payments, recurring payment agreements, service registry, payment-gated reputation, encrypted messaging and guardian security settings. Addresses can be given as hex addresses, registered participant names, the word "me" for the first account, or an index such as "#1". Every tool returns a structured JSON object with a success flag and, on failure, a machine-readable error code and a suggested fix.

It suits developers and agent builders who want autonomous software to hold funds, pay for services and build a track record without custom payment plumbing. The default chain is Base Sepolia, and the README lists Base and Ethereum mainnet as options. Gas is described as sponsored automatically.

Tools this server provides (32)

Taken from the project documentation; the running server may differ.

azeth_create_account
Deploy smart accounts, check balances, manage token whitelists.
azeth_balance
Check smart account balances.
azeth_history
View account transaction history.
azeth_deposit
Deposit funds into a smart account.
azeth_accounts
List registered accounts.
azeth_whitelist_token
Manage token whitelists.
azeth_transfer
Send ETH or ERC-20 tokens from a smart account.
azeth_pay
Pay for x402 services.
azeth_smart_pay
Pay for services auto-discovered by capability.
azeth_create_payment_agreement
Create a recurring payment agreement.
azeth_subscribe_service
Set up a service subscription.
azeth_execute_agreement
Execute a recurring payment agreement.
azeth_cancel_agreement
Cancel a payment agreement.
azeth_get_agreement
Query a payment agreement.
azeth_list_agreements
List payment agreements.
azeth_get_due_agreements
Find agreements with due payments.
azeth_publish_service
Register a service on the ERC-8004 trust registry.
azeth_discover_services
Discover services by capability and reputation.
azeth_get_registry_entry
Get a registry entry.
azeth_update_service
Update a registered service.
azeth_update_service_batch
Update multiple registered services.
azeth_submit_opinion
Rate a service with payment-gated reputation.
azeth_get_weighted_reputation
Check USD-weighted reputation scores.
azeth_get_net_paid
Get net amount paid to a service.
azeth_get_active_opinion
Get an active opinion on a service.
azeth_send_message
Send an XMTP message to another agent.
azeth_check_reachability
Check whether an agent can be reached.
azeth_receive_messages
Receive XMTP messages.
azeth_list_conversations
List XMTP conversations.
azeth_discover_agent_capabilities
Discover an agent's capabilities.
azeth_get_guardrails
View guardian security configuration.
azeth_whitelist_protocol
Whitelist a protocol for guardian-approved use.

What it does

Smart account creation
Deploys smart accounts for an agent and reports balances and transaction history.
x402 service payments
Pays for x402-enabled services directly, including auto-discovery by capability and recurring subscriptions.
Service registry lookup
Publishes services to an ERC-8004 trust registry and discovers providers by capability and reputation.
Payment-gated reputation
Lets agents rate services, with scores weighted by the USD value of payments made.
Encrypted agent messaging
Sends and receives end-to-end encrypted XMTP messages between agents.
Guardian spending controls
Supports an optional guardian key for co-signing operations above spending limits.

Good for

  • Give an AI assistant a wallet so it can pay for API or data services on its own
  • Set up monthly recurring payments to a subscription service from an agent
  • Find providers for a capability such as price feeds and compare their reputation before paying
  • Let two agents exchange messages and confirm each other is reachable

Pricing

Open source

MIT licensed and free to run; the README mentions no paid plan.

azeth-protocol FAQ

Do I need an API key to start?

No. The README says no API keys are required and a private key is generated automatically on first run.

Which chains are supported?

The README lists base, baseSepolia, ethereum and ethereumSepolia, with baseSepolia as the default.

How is azeth-protocol installed?

Install globally with npm install -g @azeth/mcp-server, then register the azeth-mcp command with your MCP client. The README advises a global install over npx.

Is azeth-protocol free?

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

How do I add azeth-protocol to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env AZETH_PRIVATE_KEY='<AZETH_PRIVATE_KEY>' --env AZETH_GUARDIAN_KEY='<AZETH_GUARDIAN_KEY>' --env XMTP_ENCRYPTION_KEY='<XMTP_ENCRYPTION_KEY>' -- npx -y @azeth/mcp-server

What are the best alternatives to azeth-protocol?

The closest alternatives to azeth-protocol are Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router, Agentiam MCP, Tychi MCP, aibtcdev and Imperium Live Multi-Specialist A2A Swarm Mesh Coordinator.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers