azeth-protocol
MCP server giving AI agents smart accounts, x402 payments and on-chain reputation
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-serverAdd 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_ETHEREUMAZETH_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.