XGR.Network MCP

XGR.Network MCP es un conector para XGRChain y el motor de procesos en cadena XDaLa, que permite a los agentes de IA acceder a datos de la cadena, inspeccionar la actividad de los procesos y preparar acciones de flujo de trabajo seguras para la firma de billeteras controladas por el usuario.

Documentación

Puerta de enlace XGR MCP

Puerta de enlace XGR MCP proporciona acceso nativo de IA a la pila XGR.Network a través del Protocolo de Contexto de Modelo. Conecta agentes compatibles con MCP, como Claude, ChatGPT, asistentes de IDE y hosts personalizados, a XGRChain, sesiones XDaLa, datos de Explorer, estándares XRC y preparación de acciones en cadena revisadas por el propietario.

La puerta de enlace está diseñada para la creación de flujos de trabajo asistidos por agentes: los agentes pueden inspeccionar evidencia de cadena en vivo, razonar sobre el estado del proceso XDaLa, redactar artefactos XRC y preparar traspasos que el usuario revisa y firma localmente.

La puerta de enlace nunca solicita, recibe, almacena ni controla claves privadas de usuarios o terceros, y no puede firmar en nombre de los usuarios. Las intenciones de escritura del usuario se preparan como traspasos y se firman localmente. Un servicio opcional de gas inicial puede usar una clave de financiación dedicada controlada por el servidor únicamente para enviar subvenciones fijas de gas XGR desde la billetera del servicio.

Puntos finales públicos de MCP

Red principal:

https://mcp.xgr.network/mcp

Red de prueba:

https://mcp.testnet.xgr.network/mcp

Use la red principal para inspeccionar actividad real de XGRChain y XDaLa. Use la red de prueba para redactar, validar y experimentar de manera segura con flujos de trabajo impulsados por agentes antes del uso en producción.

Configuración del cliente MCP

{
  "mcpServers": {
    "xgr-mainnet": {
      "type": "streamable-http",
      "url": "https://mcp.xgr.network/mcp"
    },
    "xgr-testnet": {
      "type": "streamable-http",
      "url": "https://mcp.testnet.xgr.network/mcp"
    }
  }
}

Para clientes que aún esperan http en lugar de streamable-http, use la misma URL de punto final y seleccione el transporte MCP HTTP/remoto ofrecido por su cliente.

Qué pueden hacer los agentes

  • Leer estado de la cadena: inspeccionar estado en vivo de XGRChain, bloques, estado de cuentas y evidencia de transacciones.
  • Descubrir recursos oficiales de XGR: usar get_xgr_network_info para metadatos canónicos de XGR.Network, XGRChain, XDaLa, RPC, Explorer, MCP, documentación y ecosistema.
  • Inspeccionar sesiones XDaLa: encontrar, listar y explicar sesiones, pasos de proceso, cargas útiles, recibos y resultados de ejecución.
  • Buscar datos de Explorer: consultar historial de cuentas, transferencias de valor, historial de bloques, estadísticas de transacciones y análisis de sesiones.
  • Trabajar con estándares XRC: explorar reglas XRC-137, orquestaciones XRC-729, gráficos de proceso, patrones de reutilización y análisis de fallos.
  • Redactar artefactos de proceso: preparar artefactos y paquetes XRC-137/XRC-729 contra esquemas integrados y reglas de validación.
  • Preparar acciones firmadas por el propietario: crear traspasos de revisión y firma para implementaciones e inicios de sesión sin exponer claves privadas.
  • Solicitar gas inicial donde esté habilitado: financiar una dirección elegible de saldo bajo con una subvención fija de 1 XGR antes de implementaciones, inicios de sesión, llamadas a contratos u otras acciones en cadena.

Metadatos oficiales de la red

get_xgr_network_info devuelve metadatos versionados y legibles por máquina para XGR.Network y su ecosistema. Los agentes deben usarlo cuando los usuarios soliciten información oficial del proyecto, configuración de red, puntos finales RPC o Explorer, detalles de conexión MCP, documentación, contexto de estándares XRC o repositorios fuente.

get_chain_status sigue siendo la herramienta de estado JSON-RPC en vivo y además devuelve puntos de entrada oficiales compactos para la red principal XGRChain conectada.

Por qué XGR.Network MCP

XGR.Network MCP está construido en torno a infraestructura de proceso determinista en lugar de automatización genérica de chat. Proporciona a los agentes acceso estructurado a la pila XGR mientras mantiene la firma del usuario, la custodia del usuario y la aprobación final fuera de la puerta de enlace.

Esto lo hace adecuado para:

  • Diseño de flujos de trabajo Web3 asistido por IA
  • Preparación e inspección de procesos XDaLa
  • Evidencia de proceso orientada al cumplimiento
  • Flujos de validación y ejecución deterministas
  • Automatización de procesos compatible con EVM
  • Interfaces de agente para datos XGRChain y estándares XRC

Documentación

La referencia completa vive en la documentación central de XGR:

Autoalojamiento

La puerta de enlace puede operarse contra su propia instancia de RPC y Explorer de XGRChain. El autoalojamiento requiere una implementación de Explorer con un espejo Postgres de solo lectura para búsqueda de transacciones y herramientas de análisis de sesiones.

Flujo de configuración típico:

npm install
npm run typecheck
npm run build
npm run start:http

La configuración de tiempo de ejecución requerida está documentada en Configuración y ajustes.

Modelo de seguridad

  • La puerta de enlace nunca solicita, recibe, almacena ni controla claves privadas de usuarios o terceros.
  • Las transacciones del usuario se preparan como traspasos y se firman localmente por el usuario o su configuración de custodia.
  • El servicio opcional de gas inicial es una excepción limitada: firma solo transferencias desde una billetera de financiación dedicada controlada por el servidor y no puede firmar en nombre de los usuarios.
  • Las subvenciones de gas inicial se fijan en 1 XGR, limitadas por saldo del destinatario, una subvención confirmada por dirección, límites horarios y diarios, y una política de reintentos acotada.
  • El estado de las subvenciones de gas inicial se almacena atómicamente en SQLite con estados reserved, broadcast, confirmed y failed.
  • La firma de usuario en producción permanece bajo el control de la billetera o configuración de custodia del usuario.

Enlaces

Licencia

Licenciado bajo la Licencia Apache 2.0.

Herramientas de compra de XGR en red principal

Las herramientas de compra opcionales son solo para red principal, están deshabilitadas por defecto y nunca se registran en la red de prueba. Actívelas solo con XGR_PURCHASE_TOOLS_ENABLED=true, XGR_PURCHASE_NETWORK=mainnet, una URL de API HTTPS válida (o HTTP local) y un máximo igual o inferior a 249.99 EUR.

quote_xgr_purchase es solo planificación opcional. create_xgr_purchase_order crea el pedido real en una llamada a POST /api/orders; el modal de confirmación del sitio web no es una fase separada de la API. El backend es la autoridad para el precio final, la cantidad de cripto, la billetera de custodia, la referencia de pago y la reserva. El MCP no posee claves privadas de usuarios o terceros y no paga; un agente de billetera externo puede ejecutar la instrucción de pago exacta devuelta.

El máximo de 249.99 EUR es una política del MCP para pedidos autónomos. Por separado, el backend XGR_Web requiere una dirección de facturación completa de un net_eur >= 250 recién calculado; no es un máximo de pedido del backend. Un error de reprecio/dirección del backend se devuelve sin reintentar el pedido.

Las herramientas de compra distinguen pedidos fijos de XGR de pedidos conservadores con presupuesto USDC/USDT. El POST en vivo del backend determina el precio de mercado vinculante y el amount_crypto exacto; EUR es solo un valor de política/referencia. Un pedido con presupuesto cuya cantidad exacta devuelta excede su límite no se paga y su reserva existente expira normalmente.

Herramientas de gas inicial

Donde esté habilitado, get_xgr_starter_gas_options expone la subvención fija actual y la política de elegibilidad. request_xgr_starter_gas envía una subvención fija de 1 XGR desde una billetera de servicio dedicada a una dirección EVM elegible de saldo bajo. Los agentes deben usarla antes de implementaciones, inicios de sesión, llamadas a contratos u otras acciones en cadena cuando la dirección objetivo carezca de XGR nativo para gas.

El servicio no solicita prueba de propiedad de la dirección ni usa prueba de trabajo. El abuso se limita mediante una subvención confirmada por dirección, un límite horario, un límite diario, elegibilidad por saldo del destinatario, una billetera de servicio de saldo bajo y un número limitado de reintentos después de fallos previos a la transmisión.