azeth-protocol/mcp-server

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
Claude Code
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
Then ask Claude: *"Create me a smart account called PriceFeedBot"* -- that's it.
With Your Own Key
For production or to use an existing key, add environment variables:
Environment Variables
All optional. The server works with zero configuration on testnet.
| Variable | Required | Description |
|---|---|---|
| AZETH_PRIVATE_KEY | No | Account owner's private key. Auto-generated and saved to ~/.azeth/key if not set. |
| PIMLICO_API_KEY | No | Pimlico bundler API key. Falls back to Azeth server bundler proxy if not set. |
| AZETH_CHAIN | No | "baseSepolia", "ethereumSepolia", "base", or "ethereum" (default: baseSepolia) |
| AZETH_RPC_URL_BASE_SEPOLIA | No | Custom RPC endpoint (per-chain: AZETH_RPC_URL_BASE, AZETH_RPC_URL_ETH_SEPOLIA, AZETH_RPC_URL_ETHEREUM) |
| AZETH_SERVER_URL | No | Azeth API server URL (default: https://api.azeth.ai) |
| AZETH_GUARDIAN_KEY | No | Separate guardian key for co-signing high-value operations |
| XMTP_ENCRYPTION_KEY | No | For persistent XMTP messaging across restarts |
Tools (32)
| Category | Tools | Description |
|---|---|---|
| **Account** (6) | azeth_create_account, azeth_balance, azeth_history, azeth_deposit, azeth_accounts, azeth_whitelist_token | Deploy smart accounts, check balances, manage token whitelists |
| **Transfer** (1) | azeth_transfer | Send ETH or ERC-20 tokens from your smart account |
| **Payment** (4) | azeth_pay, azeth_smart_pay, azeth_create_payment_agreement, azeth_subscribe_service | Pay for x402 services, auto-discover by capability, set up subscriptions |
| **Agreement** (5) | azeth_execute_agreement, azeth_cancel_agreement, azeth_get_agreement, azeth_list_agreements, azeth_get_due_agreements | Manage recurring payment agreements -- execute, cancel, query, find due payments |
| **Registry** (5) | azeth_publish_service, azeth_discover_services, azeth_get_registry_entry, azeth_update_service, azeth_update_service_batch | Register on ERC-8004 trust registry, discover services by capability and reputation |
| **Reputation** (4) | azeth_submit_opinion, azeth_get_weighted_reputation, azeth_get_net_paid, azeth_get_active_opinion | Payment-gated reputation -- rate services, check USD-weighted scores |
| **Messaging** (5) | azeth_send_message, azeth_check_reachability, azeth_receive_messages, azeth_list_conversations, azeth_discover_agent_capabilities | End-to-end encrypted XMTP messaging between agents |
| **Guardian** (2) | azeth_get_guardrails, azeth_whitelist_protocol | View and manage guardian security configuration |
Example Prompts