MCP server de Azeth
✓ VerificadoPermite que los agentes de IA gestionen cuentas inteligentes, ejecuten pagos on-chain, descubran servicios y se comuniquen mediante mensajería cifrada.
También conocido como azeth-protocol/mcp-server, @azeth/mcp-server
- Stars
- 3
- Herramientas
- —
- Descargas, 30 días
- 323
- Última versión
- 0.2.22
- Último commit
- 2 jul 2026
- Licencia
- MIT
¿Qué es Azeth MCP?
Permite que los agentes de IA gestionen cuentas inteligentes, ejecuten pagos on-chain, descubran servicios y se comuniquen mediante mensajería cifrada.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Azeth
Los agentes de IA que necesiten participar en la economía de las máquinas pueden usar este MCP server para gestionar cuentas inteligentes y realizar transacciones on-chain. Proporciona un conjunto de 32 herramientas que permiten a los agentes desplegar cuentas, ejecutar pagos y descubrir servicios a través de un registro de confianza. El sistema es compatible con varias redes, incluyendo Base y Ethereum, con una configuración predeterminada orientada a Base Sepolia.
Los usuarios pueden configurar el servidor sin necesidad de configuración previa, ya que este genera automáticamente una clave privada almacenada en ~/.azeth/key y patrocina el gas de forma automática. Para entornos de producción, los desarrolladores pueden proporcionar una clave privada existente mediante la variable de entorno AZETH_PRIVATE_KEY. El servidor se integra con Claude Desktop y Claude Code, lo que permite a los agentes comunicarse con otros participantes utilizando mensajería XMTP con cifrado de extremo a extremo.
Más allá de las transferencias simples, el servidor permite interacciones complejas como la configuración de acuerdos de pago recurrentes y la gestión de puntuaciones de reputación. Los agentes pueden encontrar capacidades específicas utilizando herramientas como azeth_discover_services y calificar a los proveedores mediante azeth_submit_opinion. La seguridad se gestiona a través de claves de guardianes y listas blancas del protocolo para garantizar que las operaciones de alto valor permanezcan protegidas.
Qué puedes hacer con él
- 1Despliegue de cuentas de servicio autónomasUn agente puede crear una cuenta inteligente dedicada para un bot o servicio específico.
- 2Automatización de pagos de servicios recurrentesUna IA puede establecer y gestionar suscripciones mensuales para servicios de traducción o de datos externos.
- 3Descubrimiento de capacidades especializadas de agentesUn desarrollador puede encargar a un agente la tarea de encontrar otros proveedores que ofrezcan funciones específicas en una blockchain determinada.
- 4Comunicación mediante canales cifradosLos agentes pueden enviar y recibir mensajes privados a otros participantes utilizando el protocolo XMTP.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Azeth MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Azeth MCP en 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-serverInstalar Azeth MCP en 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>"
}
}
}
}Instalar Azeth MCP en 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>"
}
}
}
}Instalar Azeth MCP en 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>"}}'Instalar Azeth MCP en 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>"
}
}
}
}Instalar Azeth MCP en 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-serverInstalar Azeth MCP en 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>"
Instalar Azeth MCP en 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-serverInstalar Azeth MCP en 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>"
}
}
}
}Configuración
AZETH_GUARDIAN_KEYSecretoGuardian co-signing private key for operations exceeding spending limits (optional)
AZETH_PRIVATE_KEYSecretoOwner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set.
XMTP_ENCRYPTION_KEYSecretoXMTP 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)
| Nombre | Descripción | Tipo |
|---|---|---|
| AZETH_GUARDIAN_KEY | Guardian co-signing private key for operations exceeding spending limits (optional) | Secreto |
| AZETH_PRIVATE_KEY | Owner private key (0x-prefixed, 64 hex chars). Auto-generated and saved to ~/.azeth/key if not set. | Secreto |
| XMTP_ENCRYPTION_KEY | XMTP database encryption key for persistent messaging (optional, enables agent-to-agent messaging) | Secreto |
| 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) |
Verificaciones automáticas
Ejecutado 15 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleazeth-protocol/mcp-server is public and reachablegithub.com/azeth-protocol/mcp-server ↗Aprobado
- El paquete indica este repositorio como su origen@azeth/mcp-server names azeth-protocol/mcp-server as sourcenpmjs.com/package/@azeth/mcp-server ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)Sigstore attestation for @azeth/mcp-servernpmjs.com/package/@azeth/mcp-server/v/0.2.22#provenance ↗Aprobado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-07-02github.com/azeth-protocol/mcp-server ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @azeth/mcp-serverAprobado
- No hay avisos críticos en el paquete ni en sus dependencias134 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre Azeth MCP
¿Cómo agrego Azeth MCP a Claude Code?
Ejecuta 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 en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Azeth MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Necesito una clave de API para empezar?
No, el servidor funciona con configuración cero en la testnet y genera automáticamente una clave privada.
¿Puedo usar esto con Claude Desktop?
Sí, puedes añadirlo a tu archivo de configuración de Claude Desktop usando el comando azeth-mcp.