Azeth MCP server
✓ 인증됨AI agent이 스마트 계정을 관리하고, 온체인 결제를 실행하며, 서비스를 검색하고, 암호화된 메시징을 통해 통신할 수 있도록 지원합니다.
다른 이름 azeth-protocol/mcp-server, @azeth/mcp-server
- 스타
- 3
- Tools
- —
- 다운로드, 30일
- 323
- 최신 버전
- 0.2.22
- 마지막 커밋
- 2026년 7월 2일
- 라이선스
- MIT
Azeth MCP란?
AI agent이 스마트 계정을 관리하고, 온체인 결제를 실행하며, 서비스를 검색하고, 암호화된 메시징을 통해 통신할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Azeth MCP server 정보
머신 이코노미(machine economy)에 참여해야 하는 AI agent는 이 server를 사용하여 스마트 계정을 관리하고 온체인 트랜잭션을 수행할 수 있습니다. 이 server는 agent가 계정을 배포하고, 결제를 실행하며, 신뢰 레지스트리를 통해 서비스를 검색할 수 있는 32개의 tool 세트를 제공합니다. 시스템은 Base 및 Ethereum을 포함한 다양한 네트워크를 지원하며, 기본 설정은 Base Sepolia를 대상으로 합니다.
사용자는 ~/.azeth/key에 저장되는 private key를 자동으로 생성하고 가스비를 자동으로 지원하므로, 별도의 설정 없이 server를 구축할 수 있습니다. 프로덕션 환경의 경우, 개발자는 AZETH_PRIVATE_KEY 환경 변수를 통해 기존 private key를 제공할 수 있습니다. 이 server는 Claude Desktop 및 Claude Code와 통합되어, agent가 종단간 암호화된 XMTP 메시징을 사용하여 다른 참여자와 통신할 수 있도록 합니다.
단순한 송금을 넘어, 이 server는 정기 결제 계약 설정 및 평판 점수 관리와 같은 복잡한 상호작용을 가능하게 합니다. agent는 azeth_discover_services와 같은 tool을 사용하여 특정 기능을 찾을 수 있으며, azeth_submit_opinion을 사용하여 제공자의 등급을 매길 수 있습니다. 보안은 가디언 키(guardian keys)와 프로토콜 화이트리스트를 통해 관리되어 고가치 작업이 보호되도록 합니다.
활용 사례
- 1자율 서비스 계정 배포agent가 특정 봇 또는 서비스를 위한 전용 스마트 계정을 생성할 수 있습니다.
- 2정기 서비스 결제 자동화AI가 외부 데이터 또는 번역 서비스를 위한 월간 구독을 설정하고 관리할 수 있습니다.
- 3특화된 agent 기능 검색개발자가 agent에게 특정 블록체인에서 특정 기능을 제공하는 다른 제공자를 찾도록 요청할 수 있습니다.
- 4암호화 채널을 통한 통신agent가 XMTP 프로토콜을 사용하여 다른 참여자와 개인 메시지를 주고받을 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
Azeth MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 Azeth MCP 설치
$ 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-serverCursor에 Azeth MCP 설치
~/.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>"
}
}
}
}VS Code에 Azeth MCP 설치
.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>"
}
}
}
}VS Code CLI에 Azeth MCP 설치
$ 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>"}}'Claude Desktop에 Azeth MCP 설치
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>"
}
}
}
}Codex에 Azeth MCP 설치
$ 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-serverCodex config.toml에 Azeth MCP 설치
~/.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>"
Gemini CLI에 Azeth MCP 설치
$ 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-serverGemini settings.json에 Azeth MCP 설치
~/.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>"
}
}
}
}구성
AZETH_GUARDIAN_KEY비밀Guardian co-signing private key for operations exceeding spending limits (optional)
AZETH_PRIVATE_KEY비밀Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
XMTP_ENCRYPTION_KEY비밀XMTP 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)
| 이름 | 설명 | 유형 |
|---|---|---|
| AZETH_GUARDIAN_KEY | Guardian co-signing private key for operations exceeding spending limits (optional) | 비밀 |
| AZETH_PRIVATE_KEY | Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set. | 비밀 |
| XMTP_ENCRYPTION_KEY | XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging) | 비밀 |
| 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) |
자동 검사
2026년 11월 15일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능azeth-protocol/mcp-server is public and reachablegithub.com/azeth-protocol/mcp-server ↗통과
- 패키지가 이 저장소를 소스로 명시@azeth/mcp-server names azeth-protocol/mcp-server as sourcenpmjs.com/package/@azeth/mcp-server ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for @azeth/mcp-servernpmjs.com/package/@azeth/mcp-server/v/0.2.22#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-07-02github.com/azeth-protocol/mcp-server ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @azeth/mcp-server통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음134 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
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
Azeth MCP 질문
Azeth MCP를 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-server를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
Azeth MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
시작하려면 API key가 필요한가요?
아니요, 이 server는 testnet에서 별도의 설정 없이 작동하며 private key를 자동으로 생성합니다.
Claude Desktop에서 사용할 수 있나요?
네, azeth-mcp command를 사용하여 Claude Desktop 설정 파일에 추가할 수 있습니다.