Azeth MCPサーバー
✓ 検証済みAIエージェントによるスマートアカウントの管理、オンチェーン決済の実行、サービスの検索、および暗号化メッセージングによる通信を可能にします。
別名 azeth-protocol/mcp-server, @azeth/mcp-server
- スター
- 3
- ツール
- —
- ダウンロード数(30日間)
- 323
- 最新バージョン
- 0.2.22
- 最終コミット
- 2026年7月2日
- ライセンス
- MIT
Azeth MCPとは
AIエージェントによるスマートアカウントの管理、オンチェーン決済の実行、サービスの検索、および暗号化メッセージングによる通信を可能にします。
プロジェクトのREADMEから生成された概要
Azeth MCP server について
マシンエコノミーへの参加が必要なAIエージェントは、このサーバーを使用してスマートアカウントの管理やオンチェーントランザクションの実行が行えます。このサーバーは、エージェントがアカウントのデプロイ、決済の実行、およびトラストレジストリを通じたサービスの検索を行える32個のツールセットを提供します。システムはBaseやEthereumを含むさまざまなネットワークをサポートしており、デフォルト設定ではBase Sepoliaを対象としています。
サーバーは、~/.azeth/keyに保存される秘密鍵を自動生成し、ガス代を自動的にスポンサーするため、ユーザーは設定なしですぐにセットアップできます。本番環境では、開発者はAZETH_PRIVATE_KEY環境変数を通じて既存の秘密鍵を指定できます。このサーバーはClaude DesktopおよびClaude Codeと統合されており、エージェントはエンドツーエンドで暗号化されたXMTPメッセージングを使用して他の参加者と通信できます。
単純な送金だけでなく、継続的な支払い契約の設定やレピュテーションスコアの管理といった複雑なインタラクションも可能です。エージェントはazeth_discover_servicesなどのツールを使用して特定の機能を見つけたり、azeth_submit_opinionを使用してプロバイダーの評価を行ったりできます。セキュリティは、高価値の操作が保護されるよう、ガーディアンキーとプロトコルのホワイトリスト化によって管理されます。
できること
- 1自律的なサービスアカウントのデプロイエージェントは、特定のボットやサービス専用のスマートアカウントを作成できます。
- 2継続的なサービス支払いの自動化AIは、外部のデータ提供や翻訳サービスに対する月額サブスクリプションを確立し、管理できます。
- 3特化したエージェント機能の検索開発者はエージェントに対し、特定のブロックチェーン上で特定の機能を提供する他のプロバイダーを探すタスクを割り当てることができます。
- 4暗号化チャネルによる通信エージェントは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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
開始するためにAPIキーは必要ですか?
いいえ、このサーバーはテストネット上で設定なしで動作し、秘密鍵を自動生成します。
Claude Desktopで使用できますか?
はい、azeth-mcpコマンドを使用してClaude Desktopの設定ファイルに追加できます。