
XGR.Network MCP
from xgr-network
XGR.Network MCP is a connector for XGRChain and the XDaLa on-chain process engine, enabling AI agents to access chain data, inspect process activity, and prepare secure workflow actions for user-controlled wallet signing.
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/mcpTestnet:
https://mcp.testnet.xgr.network/mcpUse mainnet to inspect real XGRChain and XDaLa activity. Use testnet to safely draft, validate and experiment with agent-driven workflows before production use.
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:
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:httpRequired 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.
npm install
npm run typecheck
npm run build
npm run start:httpMCP 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.
No common issues documented yet. If you hit a problem, the repository's GitHub Issues page is the best place to look.