# azeth-protocol

> azeth-protocol is an open-source MCP server for agent tooling. MCP server giving AI agents smart accounts, x402 payments and on-chain reputation. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Self-hosted, Web
- **Repository:** https://github.com/azeth-protocol/mcp-server
- **MCP Registry name:** io.github.azeth-protocol/mcp-server
- **Categories:** [agent tooling](https://ai-powered.com/categories/agent-tooling)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router](https://ai-powered.com/mcp/imperium-mcp-gateway-universal-490-tool-discovery-safe-proxy): Imperium MCP Gateway — Universal 490+ Tool Discovery, Safe-Proxy & Router is a paid MCP server for agent tooling.
- [Agentiam MCP](https://ai-powered.com/mcp/agentiam-mcp): Agentiam MCP is an open-source MCP server for agent tooling.
- [Tychi MCP](https://ai-powered.com/mcp/tychi-mcp): Tychi MCP is an open-source MCP server for finance and payments.
- [aibtcdev](https://ai-powered.com/mcp/aibtcdev): aibtcdev is an open-source MCP server for finance and payments.
- [Imperium Live Multi-Specialist A2A Swarm Mesh Coordinator](https://ai-powered.com/mcp/imperium-live-multi-specialist-a2a-swarm-mesh-coordinator): Imperium Live Multi-Specialist A2A Swarm Mesh Coordinator is a freemium MCP server for agent tooling.
- [X402 MCP Server](https://ai-powered.com/mcp/x402-mcp-server-3): X402 MCP Server is a paid MCP server for agent tooling.
- [Trustgate Erc8183 MCP](https://ai-powered.com/mcp/trustgate-erc8183-mcp): Trustgate Erc8183 MCP is a freemium MCP server for security.
- [Anp2 MCP Server](https://ai-powered.com/mcp/anp2-mcp-server): Anp2 MCP Server is an open-source MCP server for agent tooling.

---
Source: https://ai-powered.com/mcp/azeth-protocol
