Para agentes
Encuentra en el catálogo de Web3alert eventos on-chain decodificados de redes EVM y Substrate, como Ethereum, Polkadot y Kusama. Tu agente puede usar las 10 herramientas MCP para buscar un disparador, suscribirse y recibir los eventos coincidentes como JSON en su webhook.
Próximamente
- Inicio de sesión con wallet para que los agentes puedan abrir sus propias cuentas.
- Recargas en USDC mediante x402.
- Una bandeja de entrada para recuperar los eventos perdidos.
1. Obtén un token
Una persona inicia sesión en Web3alert y copia el token de acceso personal de los parámetros de la cuenta. Los agentes aún no pueden crear sus propias cuentas. Selecciona en la aplicación un espacio de trabajo del que seas propietario o administrador. Para añadir un webhook, crear una suscripción y consultar el historial de entregas, necesitas el rol owner o admin.
2. Conecta tu cliente MCP
Usa Streamable HTTP en https://web3alert.io/mcp/agent y envía Authorization: Bearer <token> en cada solicitud.
Claude Code
Asigna tu token a WEB3ALERT_TOKEN en la terminal y ejecuta este comando.
claude mcp add --transport http web3alert-agent https://web3alert.io/mcp/agent \
--header "Authorization: Bearer $WEB3ALERT_TOKEN"Claude Desktop y Cursor
Añade la entrada en mcpServers en el archivo claude_desktop_config.json de Claude Desktop (Settings → Developer → Edit Config) o en tu archivo personal ~/.cursor/mcp.json de Cursor. El ejemplo usa el puente mcp-remote mediante npx. Sustituye el valor de ejemplo del token.
{
"mcpServers": {
"web3alert-agent": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://web3alert.io/mcp/agent",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}VS Code
Para una conexión gestionada por el editor, añade la entrada en servers en .vscode/mcp.json y haz que WEB3ALERT_TOKEN esté disponible en el entorno del proceso de VS Code.
{
"servers": {
"web3alert-agent": {
"type": "http",
"url": "https://web3alert.io/mcp/agent",
"headers": {
"Authorization": "Bearer ${env:WEB3ALERT_TOKEN}"
}
}
}
}3. Crea tu primera suscripción
Tu agente necesita un endpoint HTTPS público para recibir eventos. Los agentes sin uno tendrán que esperar a que se habilite la bandeja de entrada para recibirlos.
En esta sesión de ejemplo, sustituye los valores entre ángulos por los resultados de las llamadas anteriores. Cambia la URL de ejemplo por una URL HTTPS de un webhook que controles y que no incluya nombre de usuario ni contraseña. Elige un disparador de eventos y proporciona los inputs obligatorios que indique get_trigger. El ejemplo supone que el disparador no requiere ninguno.
get_account({})→ Tu cuenta, plan, espacio de trabajo actual, saldo de la wallet en EUR, límites del plan y recuentos de suscripciones si están disponibles.find_triggers({"kind":"event","limit":5})→ Disparadores coincidentes del catálogo publicado y de tu espacio de trabajo, con elfullnamede cada uno.get_trigger({"trigger":"<trigger-fullname>"})→ Entradas de ejecución del disparador, campos del evento y campos disponibles para filtrar.add_webhook({"name":"agent-events","url":"https://example.com/webhooks/web3alert"})→fullname, nombre y URL del webhook registrado. El secreto de firma solo aparece en la respuesta deadd_webhookcomosigningSecret. Si lo rotas más adelante, se sustituye para todos los receptores de ese endpoint. Guarda el secreto para tu receptor.create_subscription({"trigger":"<trigger-fullname>","webhook":"<webhook-fullname>","state":"on"})→ ID, título, estado resultante, disparador y webhook de la suscripción.get_delivery_log({"subscriptionId":"<subscription-id>"})→ Resultados de entrega ynextCursorsi hay más resultados. El historial de alertas usa el plan de la primera cuenta con rol de propietario en la lista de acceso del espacio de trabajo. Si no existe esa cuenta, la API comprueba el plan de la cuenta que hace la solicitud. Si ese plan no incluye el historial, la herramienta devuelvenot_in_plan.Si el cursor no puede avanzar porque 500 o más entregas comparten la misma marca de tiempo, la herramienta devuelve
api_error. Restringe el filtro, por ejemplo por estado, y empieza de nuevo sin el cursor.
Comprueba que el state devuelto para la suscripción sea on. A partir de ese momento pueden llegar eventos coincidentes. Usa un nombre de webhook nuevo o busca uno registrado con list_webhooks.
Cuerpo del webhook
Tu webhook recibe un cuerpo JSON con un ID de evento. Los webhooks nuevos reciben entregas firmadas y Web3alert reintenta automáticamente los fallos que admiten reintentos. Consulta Webhooks para ver el formato del cuerpo, verificar firmas, gestionar reintentos y evitar duplicados.
Límites
El plan Free limita la cuenta a 5 suscripciones activas que haya creado a proyectos que no sean Free, sumadas entre todos los espacios de trabajo. Las suscripciones a proyectos Free quedan fuera del límite.
El endpoint para agentes crea suscripciones que solo entregan alertas a webhooks. En Free, cada una admite por defecto una ráfaga de 12 alertas, una tasa sostenida de 1 alerta por segundo y un límite de cola de 15. Estas suscripciones no consumen la cuota de entrega del espacio de trabajo.
Free permite 60 solicitudes por minuto a la API externa. Las pruebas de suscripción y el historial de alertas están disponibles en Advanced y Pro. Para ambos, la API comprueba el plan del primer propietario del espacio de trabajo y aplica la alternativa descrita en el paso 6. Consulta las tablas completas en Límites.
El servidor MCP permite por defecto 120 llamadas a herramientas por cuenta y por minuto. Ambos endpoints comparten este límite en cada proceso del servidor. get_account devuelve el plan de la cuenta y los mismos límites del plan que GET /api/me. El valor de limits en la herramienta es null si la API no proporciona los límites del plan. MCP puede usar la respuesta de /me en caché durante un máximo de 30 segundos, por lo que un cambio de plan puede tardar ese tiempo en aparecer en get_account.
Referencias legibles por máquinas
- llms.txt con los datos de conexión y enlaces a la documentación.
- OpenAPI JSON para la API HTTP de agentes.