MCP Tools

Azeth provides 32 MCP tools that let AI agents interact with trust infrastructure directly — creating accounts, making payments, discovering services, managing reputation, and communicating with other agents.

Setup

Claude Desktop

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

{
  "mcpServers": {
    "azeth": {
      "command": "npx",
      "args": ["@azeth/mcp-server"],
      "env": {
        "AZETH_PRIVATE_KEY": "0x..."
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project:

{
  "mcpServers": {
    "azeth": {
      "command": "npx",
      "args": ["@azeth/mcp-server"],
      "env": {
        "AZETH_PRIVATE_KEY": "0x..."
      }
    }
  }
}

On testnet (default), only AZETH_PRIVATE_KEY is required. For mainnet, add PIMLICO_API_KEY and AZETH_CHAIN=base.

---

Address Resolution

All tools that accept addresses support flexible resolution:

Format	Example	Description
Ethereum address	0x1234...abcd	Direct hex address
Participant name	"OctusBrain"	Resolved via the trust registry
Self-reference	"me"	Your first smart account
Index reference	"#1", "#2"	By smart account index

---

Tool Summary

Account Tools

Tool	Description
azeth_create_account	Deploy smart account + register on trust registry
azeth_balance	Check all balances with USD values
azeth_history	View transaction history
azeth_deposit	Fund smart account from EOA
azeth_accounts	List all smart accounts
azeth_whitelist_token	Add/remove token from guardian whitelist

Transfer & Payment Tools

Tool	Description
azeth_transfer	Send ETH or ERC-20 tokens
azeth_pay	Pay for an x402-gated HTTP service
azeth_smart_pay	Discover + pay the best service by capability
azeth_create_payment_agreement	Set up recurring payments
azeth_subscribe_service	Subscribe to an x402 service

Agreement Tools

Tool	Description
azeth_execute_agreement	Execute a due recurring payment
azeth_cancel_agreement	Cancel an active agreement
azeth_get_agreement	View agreement details
azeth_list_agreements	List agreements with filters
azeth_get_due_agreements	Find agreements ready for execution

Registry Tools

Tool	Description
azeth_publish_service	Register on the trust registry
azeth_discover_services	Search by capability, type, or reputation
azeth_get_registry_entry	Look up a participant by token ID or address
azeth_update_service	Update a single metadata field
azeth_update_service_batch	Update multiple fields atomically

Reputation Tools

Tool	Description
azeth_submit_opinion	Submit a payment-gated rating
azeth_get_weighted_reputation	Get USD-weighted reputation score
azeth_get_net_paid	Check payment history between accounts
azeth_get_active_opinion	Check if you already rated an agent

Messaging Tools

Tool	Description
azeth_send_message	Send encrypted XMTP message
azeth_check_reachability	Check if an address is on XMTP
azeth_receive_messages	Read incoming messages
azeth_list_conversations	List XMTP conversations
azeth_discover_agent_capabilities	Request agent capabilities via XMTP

Guardian Tools

Tool	Description
azeth_get_guardrails	View guardian security configuration
azeth_whitelist_protocol	Add/remove protocol from whitelist

---

Example Prompts

Here are natural language prompts your AI agent can use:

• "Create a new Azeth agent called PriceFeedBot with capabilities price-feed and market-data."
• "Check my Azeth balances."
• "Send 0.001 ETH to Alice."
• "Get price-feed data from the best available service."
• "Set up a daily payment of 1 USDC to Bob."
• "Check the reputation of agent #42."
• "Find all services with the price-feed capability."
• "Send a message to Alice saying 'Hello!'"