Xgr MCP Server

XGR MCP Gateway

XGR MCP Gateway provides AI-native access to the XGR.Network stack through the Model Context Protocol. It connects MCP-compatible agents such as Claude, ChatGPT, IDE assistants and custom hosts to XGRChain, XDaLa sessions, Explorer data, XRC standards and owner-reviewed on-chain action preparation.

The gateway is designed for agent-assisted workflow creation: agents can inspect live chain evidence, reason over XDaLa process state, draft XRC artifacts and prepare handoffs that a user reviews and signs locally.

The gateway never holds private keys and never signs transactions. Any write intent is prepared as a handoff. The user remains in control and signs locally in their own wallet.

Public MCP endpoints

Mainnet:

https://mcp.xgr.network/mcp

Testnet:

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

Use mainnet to inspect real XGRChain and XDaLa activity. Use testnet to safely draft, validate and experiment with agent-driven workflows before production use.

MCP client configuration

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

For clients that still expect http instead of streamable-http, use the same endpoint URL and select the HTTP/remote MCP transport offered by your client.

What agents can do

• Read chain state: inspect live XGRChain status, blocks, account state and transaction evidence.
• Inspect XDaLa sessions: find, list and explain sessions, process steps, payloads, receipts and execution outcomes.
• Search Explorer data: query account history, value transfers, block history, transaction statistics and session analytics.
• Work with XRC standards: explore XRC-137 rules, XRC-729 orchestrations, process graphs, reuse patterns and failure analytics.
• Draft process artifacts: prepare XRC-137/XRC-729 artifacts and bundles against built-in schemas and validation rules.
• Prepare owner-signed actions: create review-and-sign handoffs for deployments and session starts without exposing private keys.

Why XGR.Network MCP

XGR.Network MCP is built around deterministic process infrastructure rather than generic chat automation. It gives agents structured access to the XGR stack while keeping signing, custody and final approval outside the gateway.

This makes it suitable for:

• AI-assisted Web3 workflow design
• XDaLa process preparation and inspection
• compliance-oriented process evidence
• deterministic validation and execution flows
• EVM-compatible process automation
• agent interfaces for XGRChain data and XRC standards

Documentation

Full reference lives in the central XGR documentation:

• Gateway Overview
• Tool Reference
• Operation Handoff
• Authoring & Knowledge
• Setup & Configuration

Self-hosting

The gateway can be operated against your own XGRChain RPC and Explorer instance. Self-hosting requires an Explorer deployment with a read-only Postgres mirror for transaction search and session analytics tools.

Typical setup flow:

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

Required runtime configuration is documented in Setup & Configuration.

Security model

• The gateway does not hold private keys.
• The gateway does not sign transactions.
• Write operations are prepared as handoffs for user-side review and signing.
• Read tools are intended for chain, Explorer, XDaLa and documentation evidence retrieval.
• Production signing remains under the control of the user's wallet or custody setup.

Links

• Website: https://xgr.network
• MCP endpoint: https://mcp.xgr.network/mcp
• Official MCP Registry name: io.github.xgr-network/xdala-workflow-builder
• Smithery listing: https://smithery.ai/servers/xgrnetwork/xdala-workflow-builder

License

Licensed under the Apache License 2.0.