azeth-protocol avatar

Mcp Server

azeth-protocol/mcp-server

This server wires Claude into Azeth's infrastructure for autonomous agent commerce on Base and Ethereum. You get 32 tools covering ERC-4337 smart account deployment, x402 protocol payments, ERC-8004 trust registry lookups, payment-weighted reputation scoring, and XMTP messaging between agents. It auto-generates keys, sponsors gas on testnet, and handles address resolution so you can reference participants by name instead of hex. The payment agreement tools let agents set up recurring subscriptions and auto-execute due payments. If you're building agents that need to discover services by capability, pay for API calls on-chain, or manage reputation without Sybil attacks, this is the stack.

tools
32
auth
Secret needed
transport
STDIO
env vars
8
last updated
Jun 9, 2026

Tools

32 tools

Public tool metadata for what this MCP can expose to an agent.

azeth_create_accountDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_balanceDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_historyDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_depositDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_accountsDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_whitelist_tokenDeploy smart accounts, check balances, manage token whitelists

Deploy smart accounts, check balances, manage token whitelists

No parameter schema in public metadata yet.

azeth_transferSend ETH or ERC-20 tokens from your smart account

Send ETH or ERC-20 tokens from your smart account

No parameter schema in public metadata yet.

azeth_payPay for x402 services, auto-discover by capability, set up subscriptions

Pay for x402 services, auto-discover by capability, set up subscriptions

No parameter schema in public metadata yet.

azeth_smart_payPay for x402 services, auto-discover by capability, set up subscriptions

Pay for x402 services, auto-discover by capability, set up subscriptions

No parameter schema in public metadata yet.

azeth_create_payment_agreementPay for x402 services, auto-discover by capability, set up subscriptions

Pay for x402 services, auto-discover by capability, set up subscriptions

No parameter schema in public metadata yet.

azeth_subscribe_servicePay for x402 services, auto-discover by capability, set up subscriptions

Pay for x402 services, auto-discover by capability, set up subscriptions

No parameter schema in public metadata yet.

azeth_execute_agreementManage recurring payment agreements -- execute, cancel, query, find due payments

Manage recurring payment agreements -- execute, cancel, query, find due payments

No parameter schema in public metadata yet.

azeth_cancel_agreementManage recurring payment agreements -- execute, cancel, query, find due payments

Manage recurring payment agreements -- execute, cancel, query, find due payments

No parameter schema in public metadata yet.

azeth_get_agreementManage recurring payment agreements -- execute, cancel, query, find due payments

Manage recurring payment agreements -- execute, cancel, query, find due payments

No parameter schema in public metadata yet.

azeth_list_agreementsManage recurring payment agreements -- execute, cancel, query, find due payments

Manage recurring payment agreements -- execute, cancel, query, find due payments

No parameter schema in public metadata yet.

azeth_get_due_agreementsManage recurring payment agreements -- execute, cancel, query, find due payments

Manage recurring payment agreements -- execute, cancel, query, find due payments

No parameter schema in public metadata yet.

azeth_publish_serviceRegister on ERC-8004 trust registry, discover services by capability and reputation

Register on ERC-8004 trust registry, discover services by capability and reputation

No parameter schema in public metadata yet.

azeth_discover_servicesRegister on ERC-8004 trust registry, discover services by capability and reputation

Register on ERC-8004 trust registry, discover services by capability and reputation

No parameter schema in public metadata yet.

azeth_get_registry_entryRegister on ERC-8004 trust registry, discover services by capability and reputation

Register on ERC-8004 trust registry, discover services by capability and reputation

No parameter schema in public metadata yet.

azeth_update_serviceRegister on ERC-8004 trust registry, discover services by capability and reputation

Register on ERC-8004 trust registry, discover services by capability and reputation

No parameter schema in public metadata yet.

azeth_update_service_batchRegister on ERC-8004 trust registry, discover services by capability and reputation

Register on ERC-8004 trust registry, discover services by capability and reputation

No parameter schema in public metadata yet.

azeth_submit_opinionPayment-gated reputation -- rate services, check USD-weighted scores

Payment-gated reputation -- rate services, check USD-weighted scores

No parameter schema in public metadata yet.

azeth_get_weighted_reputationPayment-gated reputation -- rate services, check USD-weighted scores

Payment-gated reputation -- rate services, check USD-weighted scores

No parameter schema in public metadata yet.

azeth_get_net_paidPayment-gated reputation -- rate services, check USD-weighted scores

Payment-gated reputation -- rate services, check USD-weighted scores

No parameter schema in public metadata yet.

azeth_get_active_opinionPayment-gated reputation -- rate services, check USD-weighted scores

Payment-gated reputation -- rate services, check USD-weighted scores

No parameter schema in public metadata yet.

azeth_send_messageEnd-to-end encrypted XMTP messaging between agents

End-to-end encrypted XMTP messaging between agents

No parameter schema in public metadata yet.

azeth_check_reachabilityEnd-to-end encrypted XMTP messaging between agents

End-to-end encrypted XMTP messaging between agents

No parameter schema in public metadata yet.

azeth_receive_messagesEnd-to-end encrypted XMTP messaging between agents

End-to-end encrypted XMTP messaging between agents

No parameter schema in public metadata yet.

azeth_list_conversationsEnd-to-end encrypted XMTP messaging between agents

End-to-end encrypted XMTP messaging between agents

No parameter schema in public metadata yet.

azeth_discover_agent_capabilitiesEnd-to-end encrypted XMTP messaging between agents

End-to-end encrypted XMTP messaging between agents

No parameter schema in public metadata yet.

azeth_get_guardrailsView and manage guardian security configuration

View and manage guardian security configuration

No parameter schema in public metadata yet.

azeth_whitelist_protocolView and manage guardian security configuration

View and manage guardian security configuration

No parameter schema in public metadata yet.

Sponsors

Configuration

AZETH_PRIVATE_KEYsecret

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_KEYsecret

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_KEYsecret

XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging)

Readme

@azeth/mcp-server

mcp-azeth MCP server

npm License: MIT

MCP (Model Context Protocol) server for Azeth -- the trust, discovery, and payment layer for the machine economy. Provides 32 tools for AI agents to create accounts, make payments, discover services, manage reputation, and communicate via XMTP.

Setup

No API keys required. A private key is auto-generated and persisted at ~/.azeth/key. Gas is sponsored automatically.

Install

npm install -g @azeth/mcp-server

Claude Code

claude mcp add azeth -- azeth-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "azeth": {
      "command": "azeth-mcp"
    }
  }
}

View the full README on GitHub

Details

Repository
github.com/azeth-protocol/mcp-server
Package
@azeth/mcp-server
Transport
STDIO
Auth
Required
Registry
MCP registry, active