Azeth MCP server
✓ VerifiziertErmöglicht es AI Agents, Smart Accounts zu verwalten, On-Chain-Zahlungen auszuführen, Services zu entdecken und über verschlüsselte Messaging-Dienste zu kommunizieren.
Auch bekannt als azeth-protocol/mcp-server, @azeth/mcp-server
- Stars
- 3
- Tools
- —
- Downloads, 30 Tage
- 323
- Neueste Version
- 0.2.22
- Letzter Commit
- 2. Juli 2026
- Lizenz
- MIT
Was ist Azeth MCP?
Ermöglicht es AI Agents, Smart Accounts zu verwalten, On-Chain-Zahlungen auszuführen, Services zu entdecken und über verschlüsselte Messaging-Dienste zu kommunizieren.
Zusammenfassung generiert aus dem README des Projekts
Über Azeth MCP server
AI Agents, die an der Machine Economy teilnehmen müssen, können diesen Server nutzen, um Smart Accounts zu verwalten und On-Chain-Transaktionen durchzuführen. Er bietet eine Suite von 32 Tools, mit denen Agents Accounts deployen, Zahlungen ausführen und Services über ein Trust Registry entdecken können. Das System unterstützt verschiedene Netzwerke, einschließlich Base und Ethereum, wobei die Standardeinstellungen auf Base Sepolia ausgerichtet sind.
Nutzer können den Server ohne Konfiguration einrichten, da er automatisch einen Private Key unter ~/.azeth/key generiert und Gas automatisch übernimmt. Für Produktionsumgebungen können Entwickler einen bestehenden Private Key über die Umgebungsvariable AZETH_PRIVATE_KEY bereitstellen. Der Server integriert sich in Claude Desktop und Claude Code und ermöglicht es Agents, mit anderen Teilnehmern über end-to-end verschlüsselte XMTP-Messaging zu kommunizieren.
Über einfache Transfers hinaus ermöglicht der Server komplexe Interaktionen wie das Einrichten wiederkehrender Zahlungsvereinbarungen und das Verwalten von Reputation Scores. Agents können spezifische Fähigkeiten mit Tools wie azeth_discover_services finden und Anbieter mit azeth_submit_opinion bewerten. Die Sicherheit wird durch Guardian Keys und Protocol Whitelisting verwaltet, um sicherzustellen, dass hochvolumige Operationen geschützt bleiben.
Was du damit machen kannst
- 1Deployment autonomer Service-AccountsEin Agent kann einen dedizierten Smart Account für einen spezifischen Bot oder Service erstellen.
- 2Automatisierung wiederkehrender Service-ZahlungenEine KI kann monatliche Abonnements für externe Daten- oder Übersetzungsdienste einrichten und verwalten.
- 3Entdeckung spezialisierter Agent-CapabilitiesEin Entwickler kann einen Agent damit beauftragen, andere Anbieter zu finden, die spezifische Funktionen auf einer bestimmten Blockchain anbieten.
- 4Kommunikation über verschlüsselte KanäleAgents können über das XMTP-Protokoll private Nachrichten an andere Teilnehmer senden und empfangen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Azeth MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAzeth MCP in Claude Code installieren
$ 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-serverAzeth MCP in Cursor installieren
~/.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>"
}
}
}
}Azeth MCP in VS Code installieren
.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>"
}
}
}
}Azeth MCP in VS Code CLI installieren
$ 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>"}}'Azeth MCP in Claude Desktop installieren
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>"
}
}
}
}Azeth MCP in Codex installieren
$ 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-serverAzeth MCP in Codex config.toml installieren
~/.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>"
Azeth MCP in Gemini CLI installieren
$ 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-serverAzeth MCP in Gemini settings.json installieren
~/.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>"
}
}
}
}Konfiguration
AZETH_GUARDIAN_KEYSecretGuardian co-signing private key for operations exceeding spending limits (optional)
AZETH_PRIVATE_KEYSecretOwner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
XMTP_ENCRYPTION_KEYSecretXMTP 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)
| Name | Beschreibung | Typ |
|---|---|---|
| AZETH_GUARDIAN_KEY | Guardian co-signing private key for operations exceeding spending limits (optional) | Secret |
| AZETH_PRIVATE_KEY | Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set. | Secret |
| XMTP_ENCRYPTION_KEY | XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging) | Secret |
| 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) |
Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarazeth-protocol/mcp-server is public and reachablegithub.com/azeth-protocol/mcp-server ↗Bestanden
- Paket nennt dieses Repository als Quelle@azeth/mcp-server names azeth-protocol/mcp-server as sourcenpmjs.com/package/@azeth/mcp-server ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @azeth/mcp-servernpmjs.com/package/@azeth/mcp-server/v/0.2.22#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-07-02github.com/azeth-protocol/mcp-server ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @azeth/mcp-serverBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten134 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen@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 Fragen
Wie füge ich Azeth MCP zu Claude Code hinzu?
Führe 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 in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Azeth MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Benötige ich einen API-Key für den Start?
Nein, der Server funktioniert ohne Konfiguration auf dem Testnet und generiert automatisch einen Private Key.
Kann ich das mit Claude Desktop nutzen?
Ja, du kannst es über den azeth-mcp Befehl zu deiner Claude Desktop Konfiguration hinzufügen.