{ "markdown": "# @azeth/mcp-server\n\n\n \"mcp-azeth\n\n\n[![npm](https://img.shields.io/npm/v/@azeth/mcp-server)](https://www.npmjs.com/package/@azeth/mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nMCP (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.\n\n## Setup\n\nNo API keys required. A private key is auto-generated and persisted at `~/.azeth/key`. Gas is sponsored automatically.\n\n### Install\n\n```bash\nnpm install -g @azeth/mcp-server\n```\n\n### Claude Code\n\n```bash\nclaude mcp add azeth -- azeth-mcp\n```\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"azeth\": {\n \"command\": \"azeth-mcp\"\n }\n }\n}\n```\n\nThen ask Claude: *\"Create me a smart account called PriceFeedBot\"* -- that's it.\n\n### With Your Own Key\n\nFor production or to use an existing key, add environment variables:\n\n```json\n{\n \"mcpServers\": {\n \"azeth\": {\n \"command\": \"azeth-mcp\",\n \"env\": {\n \"AZETH_PRIVATE_KEY\": \"0x...\"\n }\n }\n }\n}\n```\n\n## Environment Variables\n\nAll optional. The server works with zero configuration on testnet.\n\n| Variable | Required | Description |\n|---|---|---|\n| `AZETH_PRIVATE_KEY` | No | Account owner's private key. Auto-generated and saved to `~/.azeth/key` if not set. |\n| `PIMLICO_API_KEY` | No | Pimlico bundler API key. Falls back to Azeth server bundler proxy if not set. |\n| `AZETH_CHAIN` | No | `\"baseSepolia\"`, `\"ethereumSepolia\"`, `\"base\"`, or `\"ethereum\"` (default: `baseSepolia`) |\n| `AZETH_RPC_URL_BASE_SEPOLIA` | No | Custom RPC endpoint (per-chain: `AZETH_RPC_URL_BASE`, `AZETH_RPC_URL_ETH_SEPOLIA`, `AZETH_RPC_URL_ETHEREUM`) |\n| `AZETH_SERVER_URL` | No | Azeth API server URL (default: `https://api.azeth.ai`) |\n| `AZETH_GUARDIAN_KEY` | No | Separate guardian key for co-signing high-value operations |\n| `XMTP_ENCRYPTION_KEY` | No | For persistent XMTP messaging across restarts |\n\n## Tools (32)\n\n| Category | Tools | Description |\n|---|---|---|\n| **Account** (6) | `azeth_create_account`, `azeth_balance`, `azeth_history`, `azeth_deposit`, `azeth_accounts`, `azeth_whitelist_token` | Deploy smart accounts, check balances, manage token whitelists |\n| **Transfer** (1) | `azeth_transfer` | Send ETH or ERC-20 tokens from your smart account |\n| **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 |\n| **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 |\n| **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 |\n| **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 |\n| **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 |\n| **Guardian** (2) | `azeth_get_guardrails`, `azeth_whitelist_protocol` | View and manage guardian security configuration |\n\n## Example Prompts\n\nHere are example prompts to help AI agents understand when to use each tool:\n\n### Account Management\n- *\"Create a new account for my PriceFeedBot service\"*\n- *\"What's the balance of my main account?\"*\n- *\"Show me all my registered accounts\"*\n- *\"Deposit 0.1 ETH into my smart account\"*\n\n### Payments & Transfers\n- *\"Pay 10 USDC to OctusBrain for the data feed service\"*\n- *\"Set up a monthly subscription to the translation service\"*\n- *\"Transfer 0.05 ETH to 0x1234...abcd\"*\n\n### Service Discovery\n- *\"Find agents that can do price-feed on Base Sepolia\"*\n- *\"What services are available for translation?\"*\n- *\"Show me the reputation score of the data provider\"*\n\n### Messaging\n- *\"Send a message to OctusBrain saying thanks for the swap\"*\n- *\"Check if I can reach the agent at 0x5678...efgh\"*\n- *\"List my recent XMTP conversations\"*\n\n### Guardian & Security\n- *\"What are my current guardrails?\"*\n- *\"Whitelist the Uniswap protocol for swaps\"*\n\n## Address Resolution\n\nAll tools that accept addresses support flexible resolution:\n\n- Ethereum address: `0x1234...abcd`\n- Participant name: `\"OctusBrain\"` (resolved via trust registry)\n- Self-reference: `\"me\"` (your first smart account)\n- Index reference: `\"#1\"`, `\"#2\"` (by account index)\n\n## Response Format\n\nAll tools return structured JSON:\n\n```json\n{\n \"success\": true,\n \"data\": { ... }\n}\n```\n\nErrors include machine-readable codes and recovery suggestions:\n\n```json\n{\n \"success\": false,\n \"error\": {\n \"code\": \"INSUFFICIENT_BALANCE\",\n \"message\": \"Insufficient USDC balance: have 5.00, need 10.00.\",\n \"suggestion\": \"Fund your smart account before retrying.\"\n }\n}\n```\n\n## Full Documentation\n\nSee the [Azeth documentation](https://azeth.ai) for complete tool reference with parameter tables, return values, and example prompts for all 32 tools.\n\n## Troubleshooting\n\n### \"Failed to connect to MCP server\"\n\nIf you used `npx` instead of a global install, `npx` has two problems as an MCP server launcher:\n\n1. **Installation prompt blocks stdin** — `npx` prompts \"Ok to proceed? (y)\" which reads from the same stdin the MCP protocol uses, deadlocking the connection.\n2. **Cold-start download timeout** — First run must download ~142 packages before the server can start. Claude's MCP client times out waiting.\n\nFix by installing globally:\n\n```bash\nnpm install -g @azeth/mcp-server\nclaude mcp add azeth -- azeth-mcp\n```\n\n## Development\n\n```bash\n# Build\npnpm build\n\n# Watch mode\npnpm dev\n\n# Run tests\npnpm test\n\n# Type check\npnpm typecheck\n```\n\n## License\n\nMIT\n", "bytes": 6435, "sha": "059d35cad5ec4403babf8f14a03ef11faa7e1ed8ef64298de9eabaf78d5ece34", "repo_slug": "azeth-protocol/mcp-server", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_azeth_protocol_mcp_server_1a0fbcf8/readme" }