Azeth MCP server
✓ VerifiedMemungkinkan AI agent untuk mengelola smart account, mengeksekusi pembayaran on-chain, menemukan layanan, dan berkomunikasi melalui pesan terenkripsi.
Juga dikenal sebagai azeth-protocol/mcp-server, @azeth/mcp-server
- Stars
- 3
- Tools
- —
- Unduhan, 30 hari
- 323
- Versi terbaru
- 0.2.22
- Commit terakhir
- 2 Jul 2026
- Lisensi
- MIT
Apa itu Azeth MCP?
Memungkinkan AI agent untuk mengelola smart account, mengeksekusi pembayaran on-chain, menemukan layanan, dan berkomunikasi melalui pesan terenkripsi.
Ringkasan dibuat dari README proyek
Tentang Azeth MCP server
AI agent yang perlu berpartisipasi dalam machine economy dapat menggunakan server ini untuk mengelola smart account dan melakukan transaksi on-chain. Server ini menyediakan suite berisi 32 tools yang memungkinkan agent untuk men-deploy account, mengeksekusi pembayaran, dan menemukan layanan melalui trust registry. Sistem ini mendukung berbagai network termasuk Base dan Ethereum, dengan pengaturan default yang menargetkan Base Sepolia.
Pengguna dapat menyiapkan server dengan zero configuration karena server akan otomatis membuat private key yang disimpan di ~/.azeth/key dan mensponsori gas secara otomatis. Untuk lingkungan produksi, developer dapat menyediakan private key yang sudah ada melalui environment variable AZETH_PRIVATE_KEY. Server ini terintegrasi dengan Claude Desktop dan Claude Code, yang memungkinkan agent untuk berkomunikasi dengan partisipan lain menggunakan pesan XMTP yang terenkripsi end-to-end.
Selain transfer sederhana, server ini memungkinkan interaksi kompleks seperti mengatur perjanjian pembayaran berulang dan mengelola skor reputasi. Agent dapat menemukan kapabilitas spesifik menggunakan tools seperti azeth_discover_services dan memberikan rating kepada provider menggunakan azeth_submit_opinion. Keamanan dikelola melalui guardian keys dan protocol whitelisting untuk memastikan operasi bernilai tinggi tetap terlindungi.
Apa yang bisa Anda lakukan dengannya
- 1Deploying autonomous service accountsSeorang agent dapat membuat smart account khusus untuk bot atau layanan tertentu.
- 2Automating recurring service paymentsAI dapat membuat dan mengelola langganan bulanan untuk layanan data eksternal atau layanan translasi.
- 3Discovering specialized agent capabilitiesDeveloper dapat menugaskan agent untuk menemukan provider lain yang menawarkan fungsi spesifik pada blockchain tertentu.
- 4Communicating via encrypted channelsAgent dapat mengirim dan menerima pesan pribadi ke partisipan lain menggunakan protokol XMTP.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal Azeth MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal Azeth MCP di Claude Code
$ claude mcp add --env 'AZETH_GUARDIAN_KEY=<YOUR_AZETH_GUARDIAN_KEY>' --env 'AZETH_PRIVATE_KEY=<YOUR_AZETH_PRIVATE_KEY>' --env 'XMTP_ENCRYPTION_KEY=<YOUR_XMTP_ENCRYPTION_KEY>' mcp-server -- npx -y @azeth/mcp-serverInstal Azeth MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@azeth/mcp-server"
],
"env": {
"AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
"AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
"XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
}
}
}
}Instal Azeth MCP di VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@azeth/mcp-server"
],
"env": {
"AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
"AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
"XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
}
}
}
}Instal Azeth MCP di VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"stdio","command":"npx","args":["-y","@azeth/mcp-server"],"env":{"AZETH_GUARDIAN_KEY":"<YOUR_AZETH_GUARDIAN_KEY>","AZETH_PRIVATE_KEY":"<YOUR_AZETH_PRIVATE_KEY>","XMTP_ENCRYPTION_KEY":"<YOUR_XMTP_ENCRYPTION_KEY>"}}'Instal Azeth MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@azeth/mcp-server"
],
"env": {
"AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
"AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
"XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
}
}
}
}Instal Azeth MCP di Codex
$ codex mcp add mcp-server --env 'AZETH_GUARDIAN_KEY=<YOUR_AZETH_GUARDIAN_KEY>' --env 'AZETH_PRIVATE_KEY=<YOUR_AZETH_PRIVATE_KEY>' --env 'XMTP_ENCRYPTION_KEY=<YOUR_XMTP_ENCRYPTION_KEY>' -- npx -y @azeth/mcp-serverInstal Azeth MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] command = "npx" args = ["-y", "@azeth/mcp-server"] [mcp_servers.mcp-server.env] AZETH_GUARDIAN_KEY = "<YOUR_AZETH_GUARDIAN_KEY>" AZETH_PRIVATE_KEY = "<YOUR_AZETH_PRIVATE_KEY>" XMTP_ENCRYPTION_KEY = "<YOUR_XMTP_ENCRYPTION_KEY>"
Instal Azeth MCP di Gemini CLI
$ gemini mcp add -s user -e 'AZETH_GUARDIAN_KEY=<YOUR_AZETH_GUARDIAN_KEY>' -e 'AZETH_PRIVATE_KEY=<YOUR_AZETH_PRIVATE_KEY>' -e 'XMTP_ENCRYPTION_KEY=<YOUR_XMTP_ENCRYPTION_KEY>' mcp-server npx -- -y @azeth/mcp-serverInstal Azeth MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"@azeth/mcp-server"
],
"env": {
"AZETH_GUARDIAN_KEY": "<YOUR_AZETH_GUARDIAN_KEY>",
"AZETH_PRIVATE_KEY": "<YOUR_AZETH_PRIVATE_KEY>",
"XMTP_ENCRYPTION_KEY": "<YOUR_XMTP_ENCRYPTION_KEY>"
}
}
}
}Konfigurasi
AZETH_GUARDIAN_KEYRahasiaGuardian co-signing private key for operations exceeding spending limits (optional)
AZETH_PRIVATE_KEYRahasiaOwner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
XMTP_ENCRYPTION_KEYRahasiaXMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging)
AZETH_CHAINTarget chain: base, baseSepolia, ethereum, ethereumSepolia (default: baseSepolia)
AZETH_EMERGENCY_ADDRESSEmergency withdrawal destination address (defaults to owner EOA if not set)
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_ETHEREUM
AZETH_SERVER_URLAzeth server URL for off-chain operations like reputation queries (optional)
| Nama | Deskripsi | Tipe |
|---|---|---|
| AZETH_GUARDIAN_KEY | Guardian co-signing private key for operations exceeding spending limits (optional) | Rahasia |
| AZETH_PRIVATE_KEY | Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set. | Rahasia |
| XMTP_ENCRYPTION_KEY | XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging) | Rahasia |
| AZETH_CHAIN | Target chain: base, baseSepolia, ethereum, ethereumSepolia (default: baseSepolia) | |
| AZETH_EMERGENCY_ADDRESS | Emergency withdrawal destination address (defaults to owner EOA if not set) | |
| 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) |
Pengecekan otomatis
Berjalan 15 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkauazeth-protocol/mcp-server is public and reachablegithub.com/azeth-protocol/mcp-server ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@azeth/mcp-server names azeth-protocol/mcp-server as sourcenpmjs.com/package/@azeth/mcp-server ↗Lolos
- Provenance build (atestasi Sigstore)Sigstore attestation for @azeth/mcp-servernpmjs.com/package/@azeth/mcp-server/v/0.2.22#provenance ↗Lolos
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-07-02github.com/azeth-protocol/mcp-server ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @azeth/mcp-serverLolos
- Tidak ada advisory kritis pada paket atau dependensinya134 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHub@azeth/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
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"
}
}
}
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:
{
"mcpServers": {
"azeth": {
"command": "azeth-mcp",
"env": {
"AZETH_PRIVATE_KEY": "0x..."
}
}
}
}
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
Here are example prompts to help AI agents understand when to use each tool:
Account Management
- "Create a new account for my PriceFeedBot service"
- "What's the balance of my main account?"
- "Show me all my registered accounts"
- "Deposit 0.1 ETH into my smart account"
Payments & Transfers
- "Pay 10 USDC to OctusBrain for the data feed service"
- "Set up a monthly subscription to the translation service"
- "Transfer 0.05 ETH to 0x1234...abcd"
Service Discovery
- "Find agents that can do price-feed on Base Sepolia"
- "What services are available for translation?"
- "Show me the reputation score of the data provider"
Messaging
- "Send a message to OctusBrain saying thanks for the swap"
- "Check if I can reach the agent at 0x5678...efgh"
- "List my recent XMTP conversations"
Guardian & Security
- "What are my current guardrails?"
- "Whitelist the Uniswap protocol for swaps"
Address Resolution
All tools that accept addresses support flexible resolution:
- Ethereum address:
0x1234...abcd - Participant name:
"OctusBrain"(resolved via trust registry) - Self-reference:
"me"(your first smart account) - Index reference:
"#1","#2"(by account index)
Response Format
All tools return structured JSON:
{
"success": true,
"data": { ... }
}
Errors include machine-readable codes and recovery suggestions:
{
"success": false,
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Insufficient USDC balance: have 5.00, need 10.00.",
"suggestion": "Fund your smart account before retrying."
}
}
Full Documentation
See the Azeth documentation for complete tool reference with parameter tables, return values, and example prompts for all 32 tools.
Troubleshooting
"Failed to connect to MCP server"
If you used npx instead of a global install, npx has two problems as an MCP server launcher:
- Installation prompt blocks stdin —
npxprompts "Ok to proceed? (y)" which reads from the same stdin the MCP protocol uses, deadlocking the connection. - Cold-start download timeout — First run must download ~142 packages before the server can start. Claude's MCP client times out waiting.
Fix by installing globally:
npm install -g @azeth/mcp-server
claude mcp add azeth -- azeth-mcp
Development
# Build
pnpm build
# Watch mode
pnpm dev
# Run tests
pnpm test
# Type check
pnpm typecheck
License
MIT
Pertanyaan tentang Azeth MCP
Bagaimana cara menambahkan Azeth MCP ke Claude Code?
Jalankan claude mcp add --env 'AZETH_GUARDIAN_KEY=<YOUR_AZETH_GUARDIAN_KEY>' --env 'AZETH_PRIVATE_KEY=<YOUR_AZETH_PRIVATE_KEY>' --env 'XMTP_ENCRYPTION_KEY=<YOUR_XMTP_ENCRYPTION_KEY>' mcp-server -- npx -y @azeth/mcp-server di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan Azeth MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apakah saya memerlukan API key untuk memulai?
Tidak, server ini bekerja dengan zero configuration pada testnet dan secara otomatis membuat private key.
Bisakah saya menggunakan ini dengan Claude Desktop?
Ya, Anda dapat menambahkannya ke file konfigurasi Claude Desktop Anda menggunakan perintah azeth-mcp.