Remote MCP server for XDaLa workflow preparation on XGR.Network.
Remote MCP server for preparing XDaLa workflows on XGR.Network.
Captured live from the server via tools/list.
get_chain_status
Use this for live XGRChain status. Returns chain id, latest block number and gas price from JSON-RPC.
No parameters.
get_latest_block
Use this when the user asks for the latest EVM block details from XGRChain.
No parameters.
get_account_live_state
Use this for live EVM account state. Returns balance, nonce and contract code for an address.
Parameters (1)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
get_transaction_evidence
Use this when the user asks what happened in a specific transaction. Combines indexed Explorer transaction data, receipt data and live RPC fallback if available.
Parameters (1)
txHashstringrequired
0x-prefixed transaction hash to inspect or resolve.
get_transaction_receipt
Use this for receipt logs, status and gas usage of a transaction. Prefers Explorer decoded receipt data.
Parameters (1)
txHashstringrequired
0x-prefixed transaction hash to inspect or resolve.
search_transactions
Read-only chain-wide Explorer DB transaction search. Use for general transaction, native XGR value, from/to address, hash, input, session id, validity/execution, and block/time-range questions; do not sample XDaLa sessions for chain-wide transaction questions.
Parameters (17)
fromstring
Sender address or lower bound used for the query.
tostring
Recipient address, contract address or upper bound used for the query.
txHashstring
0x-prefixed transaction hash to inspect or resolve.
valueGtWeistring
Value for the value gt wei parameter.
valueEqWeistring
Value for the value eq wei parameter.
valueLtWeistring
Value for the value lt wei parameter.
hasValueboolean
Value for the has value parameter.
hasInputboolean
Value for the has input parameter.
contractCreationboolean
Value for the contract creation parameter.
sessionIdstring
XDaLa session identifier used to query runtime or explorer data.
validboolean
Value for the valid parameter.
executedboolean
Value for the executed parameter.
windowHoursinteger
Value for the window hours parameter.
fromBlockinteger
Value for the from block parameter.
toBlockinteger
Value for the to block parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_recent_value_transfers
Read-only shortcut for recent native XGR value transfers from the Explorer transaction index. Native value transfer means transactions.value > minValueWei and does not include gas fees.
Parameters (6)
windowHoursinteger
Value for the window hours parameter.
minValueWeistring
Value for the min value wei parameter.
fromstring
Sender address or lower bound used for the query.
tostring
Recipient address, contract address or upper bound used for the query.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_account_transactions
Read-only chain-wide Explorer DB transaction lookup for one account as sender, recipient, or both. Use this instead of XDaLa session tools for account-wide transaction history.
Parameters (6)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
directionstring
Value for the direction parameter.
valueOnlyboolean
Value for the value only parameter.
windowHoursinteger
Value for the window hours parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_block_transactions
Read-only list of transactions in a specific indexed block, latest indexed block, or latest indexed block minus latestOffset.
Parameters (4)
blockNumberinteger
Block number or block identifier used for the chain lookup.
latestOffsetinteger
Value for the latest offset parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_transaction_stats
Read-only compact chain transaction statistics from the Explorer transaction index, with optional block or block-timestamp window filters.
Parameters (3)
windowHoursinteger
Value for the window hours parameter.
fromBlockinteger
Value for the from block parameter.
toBlockinteger
Value for the to block parameter.
get_session_transactions
Use this to list the blockchain transactions belonging to an XDaLa session. This returns the timeline of transaction hashes, blocks, fees and iteration steps. It does not return full engine payloads, API saves or contract read results.
Parameters (4)
sessionIdstringrequired
XDaLa session identifier used to query runtime or explorer data.
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_session_status_live
Use this to check live session status from XGR RPC. Returns xgr_sessionAlive for a session owner and session id.
Parameters (2)
sessionIdstringrequired
XDaLa session identifier used to query runtime or explorer data.
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
list_wakeup_targets_by_address
Use this to list WAITING XDaLa runtime steps that the given wallet or Safe address is allowed to wake via RPC. This is read-only and calls xgr_listWakeupTargetsByAddress, then enriches public/plain XRC rule payload metadata via eth_call when available.
Parameters (2)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
lastinteger
Maximum number of most recent records to inspect.
resolve_wakeup_payload_schema
Use this to resolve payload fields for one currently WAITING wake-up target. It reads XRC-729.getOSTC(step -> XRC-137) and XRC-137.getRule() via eth_call for plain JSON rules. Encrypted rules are not decrypted server-side.
Parameters (5)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
sessionIdstringrequired
XDaLa session identifier used to query runtime or explorer data.
pidstring
XDaLa process id within a session tree.
stepstring
Human-readable XDaLa step label or step identifier.
get_sessions_overview
Use this for high-level indexed XDaLa session analytics from the Explorer API.
Parameters (1)
windowstring
Time window for aggregated analytics or overview data.
find_latest_xdala_session
Use this when the user asks for the latest XDaLa session but does not provide owner and sessionId. This read-only tool resolves the newest indexed XDaLa session from the Explorer database and can optionally include final receipt payload data.
Parameters (3)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
includePayloadboolean
Value for the include payload parameter.
get_latest_session_payload
Use this when the user asks for the payload of the latest XDaLa session. This read-only tool resolves the latest indexed session without requiring owner plus sessionId, then returns payload, apiSaves, contractSaves and extras from the final receipt.
Parameters (2)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
get_recent_xdala_sessions
Use this to list recent indexed XDaLa sessions from the read-only Explorer database, especially when the user does not know owner and sessionId. Supports optional owner filtering, time windows, result limits and payload enrichment.
Parameters (4)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
limitinteger
Maximum number of records to return.
includePayloadboolean
Value for the include payload parameter.
list_xdala_session_owners
Use this when the user asks which owners had XDaLa sessions, asks for the owner list, or when aggregate results show uniqueOwners but the concrete owner addresses are needed. For “last 3 weeks”, pass windowHours=504.
Parameters (2)
windowHoursinteger
Value for the window hours parameter.
limitinteger
Maximum number of records to return.
list_xdala_sessions
Use this when the user asks to list XDaLa sessions, enumerate recent sessions, or discover owner/sessionId pairs. This returns concrete owner + sessionId pairs and supports keyset pagination. For “last 3 weeks”, pass windowHours=504.
Parameters (5)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
outcomestring
Value for the outcome parameter.
limitinteger
Maximum number of records to return.
cursorobject
Value for the cursor parameter.
list_xdala_session_ids
Use this when the user asks for session IDs. Always returns session IDs grouped by owner because session IDs are only unique together with owner.
Parameters (5)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
outcomestring
Value for the outcome parameter.
limitOwnersinteger
Value for the limit owners parameter.
maxSessionIdsPerOwnerinteger
Value for the max session ids per owner parameter.
get_xdala_session_detail
Use this when the user asks for details, timeline, steps, payloads, or evidence for a concrete XDaLa session with owner and sessionId.
Parameters (5)
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
sessionIdstringrequired
XDaLa session identifier used to query runtime or explorer data.
includePayloadsboolean
Value for the include payloads parameter.
includeFinalPayloadboolean
Value for the include final payload parameter.
limitStepsinteger
Value for the limit steps parameter.
get_xdala_session_stats
Use this when the user asks for aggregate XDaLa session statistics, for example “statistics for the last 2 weeks”, “success/failure counts”, “average session duration”, “average steps per session”, “top errors”, or “how many sessions ran recently”. For “last 2 weeks”, pass windowHours=336.
Parameters (2)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
get_xdala_session_timeseries
Use this when the user asks for XDaLa sessions over time, for example “sessions per day”, “daily sessions last 2 weeks”, “monthly session trend”, or “success/fail per day”. For “last 2 weeks by day”, pass windowHours=336 and bucket="day".
Parameters (3)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
bucketstring
Value for the bucket parameter.
get_xdala_step_stats
Use this when the user asks for step-level XDaLa statistics, for example “how many steps were valid”, “invalid steps”, “failed steps”, “step gas totals”, or “step stats for a session”.
Parameters (4)
ownerstring
EVM address of the XDaLa session owner or relevant account.
sessionIdstring
XDaLa session identifier used to query runtime or explorer data.
windowHoursinteger
Value for the window hours parameter.
bucketstring
Value for the bucket parameter.
get_xdala_payload_key_stats
Use this when the user asks which payload fields/keys occurred, how often payload fields appeared, or which payload fields were empty/non-empty. For “last 14 days”, pass windowHours=336.
Parameters (5)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
outcomestring
Value for the outcome parameter.
sourcestring
Source type for deriving the prepared XDaLa request.
limitinteger
Maximum number of records to return.
get_xdala_payload_term_stats
Use this when the user asks for payload terms, payload words, payload Begriff statistics, or a statistic over all payload terms in a time range. For “last 14 days”, pass windowHours=336. Do not sample sessions for this task.
Parameters (7)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
outcomestring
Value for the outcome parameter.
sourcestring
Source type for deriving the prepared XDaLa request.
modestring
Value for the mode parameter.
minTermLengthinteger
Value for the min term length parameter.
limitinteger
Maximum number of records to return.
get_xdala_payload_field_value_stats
Use this when the user asks which values occurred for a specific payload field, for example “which DocumentType values occurred?” or “top values for ReasonCategory”.
Parameters (6)
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
outcomestring
Value for the outcome parameter.
sourcestring
Source type for deriving the prepared XDaLa request.
fieldstringrequired
Value for the field parameter.
limitinteger
Maximum number of records to return.
get_xdala_active_sessions_timeseries
Use this when the user asks for active/concurrent XDaLa sessions over time.
Parameters (1)
windowHoursinteger
Value for the window hours parameter.
get_session_receipt_logs
Use this to inspect what an XDaLa session actually did. Returns decoded engine receipt data such as input payload, API saves, contract saves, execution contract, rule contract, valid flag, inner gas usage and optional raw receipt logs. Do not use this for a simple transaction timeline; use get_session_transactions instead.
Parameters (8)
sessionIdstringrequired
XDaLa session identifier used to query runtime or explorer data.
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
stepIdsarray
Value for the step ids parameter.
includeTxboolean
Value for the include tx parameter.
includeBlockboolean
Value for the include block parameter.
includeRawboolean
Value for the include raw parameter.
limitinteger
Maximum number of records to return.
filtersobject
Value for the filters parameter.
get_xgr_core_addresses
Use this to retrieve XGR core protocol addresses exposed by the xgr_getCoreAddrs RPC method.
No parameters.
get_xgr_circulating_supply
Use this to retrieve circulating supply information exposed by xgr_getCirculatingSupply.
No parameters.
estimate_xdala_rule_gas
Use this to estimate XDaLa/XRC-137 rule gas. Returns validation gas, branch gas, grant fees and worst-case totals from xgr_estimateRuleGas.
Parameters (4)
jsonstringrequired
Value for the json parameter.
encryptedboolean
Value for the encrypted parameter.
validSpawnsinteger
Value for the valid spawns parameter.
invalidSpawnsinteger
Value for the invalid spawns parameter.
get_xrc729_authority
Read-only authority lookup for one XRC-729 orchestration contract. Reads owner()/getOwner() and getExecutorList(), detects zero-address executor wildcard, and never signs, submits, executes, or creates a handoff.
Parameters (1)
orchestrationstringrequired
Address or identifier of the deployed XDaLa orchestration contract.
find_startable_xdala_workflows
Read-only discovery of deployed XRC-729 workflows that a given address can start as owner, executor, or wildcard executor. Use this whenever the user provides an address and asks which sessions/workflows they can start. This tool does not create session-start handoffs.
Parameters (9)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
networkstring
Target network name or environment, for example mainnet or devnet.
ownerstring
EVM address of the XDaLa session owner or relevant account.
includeOwnerboolean
Value for the include owner parameter.
includeExecutorboolean
Value for the include executor parameter.
includeWildcardboolean
Value for the include wildcard parameter.
includePayloadSchemaboolean
Value for the include payload schema parameter.
includeGraphboolean
Value for the include graph parameter.
limitinteger
Maximum number of records to return.
list_xrc_contracts
Read-only list of indexed XRC-137/XRC-729 contracts globally or filtered by owner/type.
Parameters (4)
ownerstring
EVM address of the XDaLa session owner or relevant account.
typestring
Operation or handoff type identifier.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_xrc_contract
Read-only lookup of one indexed XRC contract by address.
Parameters (1)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
list_xrc_events
Read-only list of XRC events globally or by owner, contract, type/action, tx hash, or block range.
Parameters (9)
ownerstring
EVM address of the XDaLa session owner or relevant account.
contractstring
Value for the contract parameter.
typestring
Operation or handoff type identifier.
actionstring
Value for the action parameter.
txHashstring
0x-prefixed transaction hash to inspect or resolve.
fromBlockinteger
Value for the from block parameter.
toBlockinteger
Value for the to block parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_xrc_contract_events
Read-only list of all indexed XRC events for one contract.
Parameters (3)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_xrc729_ostc_state
Read-only list of indexed OSTC state entries for an XRC-729 contract.
Parameters (4)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
includeDeletedboolean
Value for the include deleted parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
get_xrc_owner_summary
Compact read-only summary of XRC-137/XRC-729 assets and recent XRC events for an owner.
Parameters (1)
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
read_xrc729_ostc_json
Read-only eth_call to XRC729.getOSTC(ostcId), returning the runtime OSTC JSON string.
Parameters (2)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
ostcIdstringrequired
Orchestration step contract id for the XDaLa workflow.
read_xrc137_rule_json
Read-only eth_call to XRC137.getRule(), returning the runtime rule JSON string.
Parameters (1)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
resolve_xrc729_process_graph
Resolve deployed XRC-729 OSTC runtime JSON and linked indexed XRC-137 rule contracts without mutating chain state.
Parameters (4)
xrc729Addressstringrequired
Value for the xrc729 address parameter.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
includeRulesboolean
Value for the include rules parameter.
includeUsageboolean
Value for the include usage parameter.
get_xrc_usage
Read-only usage statistics from Explorer PGRO tx_receipts for XRC-137 rules or XRC-729 OSTC/process filters.
Parameters (6)
addressstringrequired
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
typestring
Operation or handoff type identifier.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
ostcHashstring
Hash or identifier of the orchestration step contract artifact.
windowHoursinteger
Value for the window hours parameter.
limitinteger
Maximum number of records to return.
list_xrc_process_sessions
Read-only list of sessions associated with an XRC-729 OSTC id/hash.
Parameters (7)
xrc729Addressstring
Value for the xrc729 address parameter.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
ostcHashstring
Hash or identifier of the orchestration step contract artifact.
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
pageinteger
One-based page number for paginated explorer/API results.
limitinteger
Maximum number of records to return.
find_reusable_xrc137_rules
Read-only metadata-assisted search for existing owner XRC-137 contracts that could be reused instead of redeployed.
Parameters (8)
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
draftRuleobject
Value for the draft rule parameter.
ruleHashstring
Value for the rule hash parameter.
requiredInputKeysarray
Value for the required input keys parameter.
requiredOutputKeysarray
Value for the required output keys parameter.
allowEncryptedboolean
Value for the allow encrypted parameter.
includeUsageboolean
Value for the include usage parameter.
limitinteger
Maximum number of records to return.
get_unused_xrc137_rules
Read-only list of owner XRC-137 rules with no observed tx_receipts engine_rule_contract usage.
Parameters (2)
ownerstringrequired
EVM address of the XDaLa session owner or relevant account.
limitinteger
Maximum number of records to return.
get_xrc_failure_stats
Read-only invalid/failure statistics associated with an XRC-137 rule or XRC-729 OSTC/process filters.
Parameters (7)
addressstring
EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.
typestring
Operation or handoff type identifier.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
ostcHashstring
Hash or identifier of the orchestration step contract artifact.
ownerstring
EVM address of the XDaLa session owner or relevant account.
windowHoursinteger
Value for the window hours parameter.
limitinteger
Maximum number of records to return.
create_operation_handoff
Create an offchain human-in-the-loop operation and return a browser URL. The MCP never signs or submits transactions; the user executes locally with a browser wallet on the operation page. Do not use this tool to start, run, launch, execute, or queue XDaLa sessions. Do not use this tool for xgr_validateDataTransfer, SessionPermit, Manage Sessions imports, xgr-session-start@1, XDaLa session start handoffs, or starting a deployed XRC-729 workflow. For these intents, use create_xdala_session_start_handoff. If create_xdala_session_start_handoff is unavailable, report that the session-start tool is unavailable instead of falling back to create_operation_handoff.
Parameters (9)
typestringrequired
Operation or handoff type identifier.
networkstringrequired
Target network name or environment, for example mainnet or devnet.
chainIdintegerrequired
Numeric EVM chain id for the target network.
summaryobject
Structured summary metadata for human review and audit context.
payloadany
Structured payload object for an XDaLa step or workflow request.
validationany
Validation metadata or validation result object for the handoff.
policyobject
Policy metadata controlling human review, approval or execution constraints.
stepsarray
Ordered workflow or operation steps included in the handoff.
ttlSecondsinteger
Time-to-live in seconds for temporary offchain handoff data.
get_operation_status
Return the current status of an operation handoff. Use this after the user opens the operation page and signs or cancels local wallet transactions.
Parameters (2)
operationIdstringrequired
Identifier of a stored offchain operation handoff.
secretstring
Secret token required to read or cancel protected handoff state.
cancel_operation_handoff
Cancel a pending offchain operation handoff. This never cancels already signed or submitted chain transactions.
Parameters (2)
operationIdstringrequired
Identifier of a stored offchain operation handoff.
secretstringrequired
Secret token required to read or cancel protected handoff state.
create_xdala_bundle_deploy_handoff
Store a validated xgr-multi-bundle@1 bundle offchain under an unguessable bearer handle and return an XDaLa Workbench import URL. The MCP does not sign, submit, or execute transactions.
Parameters (6)
networkstringrequired
Target network name or environment, for example mainnet or devnet.
chainIdintegerrequired
Numeric EVM chain id for the target network.
bundleobjectrequired
Canonical XDaLa bundle JSON object to validate, store or hand off.
summaryobject
Structured summary metadata for human review and audit context.
validationobject
Validation metadata or validation result object for the handoff.
ttlSecondsinteger
Time-to-live in seconds for temporary offchain handoff data.
get_xdala_bundle_deploy_handoff
Return stored metadata, bundle JSON, and any recorded deployed result/artifact for an XDaLa bundle deploy handoff handle.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
get_xdala_bundle_deploy_result
Return the stored XDaLa bundle deploy result, canonical deployed artifact, and audit events for a handoff handle. This is read-only and never signs, submits, or executes transactions.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
cancel_xdala_bundle_deploy_handoff
Cancel a pending XDaLa bundle deploy handoff. This is offchain metadata only and never cancels chain transactions.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
create_xdala_session_start_handoff
Prepare and store a read-only xgr-session-start@1 handoff for xDaLa Workbench. Use this tool whenever the user wants to start, run, launch, execute, queue, or prepare an XDaLa session. Use this tool for starting an existing deployed XRC-729/XRC-137 workflow, starting from a runtime XRC-729 orchestration, starting from a bundle deploy result, or importing a canonical xgr-session-start@1 request into xDaLa Manage Sessions. When explaining required input to users, use canonical xgr-session-start@1 terminology: sessions[].orchestration, sessions[].ostcId, sessions[].stepId, sessions[].payload, sessions[].maxTotalGas. Do not ask users for entryStepId; entryStepId is not the Workbench Session Start field. For deployed XRC-729 workflows, first inspect the runtime, identify ostcId and the likely entry step, resolve that step's XRC-137 rule, derive required payload fields from the XRC-137 payload schema, treat fields with defaults as optional, and present required and optional/default fields before creating a handoff. Do not call this tool with guessed payload values. If required start payload fields are missing, first present the required fields to the user and ask for values or explicit permission to use demo values. Only use demo/dummy/example/default values when the user explicitly asks or accepts them. This tool returns a Workbench xdalaUrl such as https://xdala.devnet.xgr.network/session-start/ss_... . The agent must show the returned xdalaUrl to the user. Do not replace the xdalaUrl with a generic /operations/op_... link. The MCP does not sign, submit, or execute. xDaLa Workbench performs local signing and calls xgr_validateDataTransfer. Do not describe the XRC-729 contract owner as the owner of a not-yet-started session; owner()/getOwner() and getExecutorList() identify start-authority roles only. Use sessions[].starterAddress only as an intended starter when explicitly set, and use terminal result data such as result.results[].owner/sessionId/pid for the actual session owner/starter after Workbench start.
Parameters (22)
sourcestringrequired
Source type for deriving the prepared XDaLa request.
networkstringrequired
Target network name or environment, for example mainnet or devnet.
chainIdinteger
Numeric EVM chain id for the target network.
orchestrationstring
Address or identifier of the deployed XDaLa orchestration contract.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
ostcHashstring
Hash or identifier of the orchestration step contract artifact.
bundleDeployHandlestring
Opaque handle returned by the XDaLa bundle deploy handoff flow.
requestobject
Canonical request object used by the target XDaLa workflow operation.
sessionsarray
Array of canonical xgr-session-start@1 session requests.
stepIdstring
Canonical XDaLa step id used by Workbench/session-start requests.
payloadobject
Structured payload object for an XDaLa step or workflow request.
maxTotalGasinteger
Maximum total gas budget allowed for the prepared XDaLa session request.
expiryinteger
Unix timestamp or expiry value for the prepared request.
signingobject
Signing metadata for Workbench or local wallet handoff preparation.
executorGrantsobject
Executor grant metadata for prepared XDaLa session-start requests.
executionobject
Execution metadata for prepared XDaLa workflow requests.
uiobject
Optional user-interface metadata for Workbench import and display.
securityobject
Optional security metadata for handoff preparation.
expectedSignerstring
Expected wallet address that should sign or execute the prepared handoff.
walletAddressstring
Wallet address used as intended signer, starter or actor context.
summaryobject
Structured summary metadata for human review and audit context.
ttlSecondsinteger
Time-to-live in seconds for temporary offchain handoff data.
get_xdala_session_start_handoff
Read stored xDaLa session start handoff metadata, canonical request, authority, derived sessionOwnership role summary, validation, lean result summary, and terminal result. Read-only; does not sign, submit, or execute. Use sessionOwnership to avoid confusing the XRC-729 contract owner with the actual session owner/starter before Workbench completion.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
cancel_xdala_session_start_handoff
Cancel pending xDaLa session start handoff metadata only. This preparation/read-only MCP tool does not sign, submit, execute, or cancel on-chain work.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
get_xdala_session_start_result
Return terminal xDaLa session start result, lean result summary, and audit events. Read-only preparation/result lookup only; the MCP does not sign, submit, or execute, and users sign locally in Workbench/wallet/local signer. For completed handoffs, prefer result.results[].owner/sessionId/pid over XRC-729 contract owner facts when identifying the actual session owner/starter.
Parameters (1)
handlestringrequired
Opaque handoff handle returned by a previous XDaLa MCP tool.
list_recent_operations
List recent offchain operation handoffs. Secrets and browser execution tokens are never returned by this tool.
Parameters (1)
limitinteger
Maximum number of records to return.
get_xdala_process_mermaid
Render an XDaLa XRC-729 process graph from runtime, bundle, or bundle handoff data as Mermaid flowchart text. Read-only; does not sign, submit, or execute transactions.
Parameters (11)
sourcestringrequired
Source type for deriving the prepared XDaLa request.
xrc729Addressstring
Value for the xrc729 address parameter.
ostcIdstring
Orchestration step contract id for the XDaLa workflow.
includeRulesboolean
Value for the include rules parameter.
bundleobject
Canonical XDaLa bundle JSON object to validate, store or hand off.
handlestring
Opaque handoff handle returned by a previous XDaLa MCP tool.
directionstring
Value for the direction parameter.
includeAddressesboolean
Value for the include addresses parameter.
includeRuleSummaryboolean
Value for the include rule summary parameter.
includePayloadFieldsboolean
Value for the include payload fields parameter.
includeWarningsboolean
Value for the include warnings parameter.
list_xgr_standards
List agent-readable XGR and XDaLa standards available in the MCP knowledge base.
No parameters.
list_xgr_docs
List canonical Markdown documentation topics served by the MCP knowledge base.
No parameters.
get_xgr_doc
Retrieve canonical Markdown documentation for an XGR/XDaLa topic.
Parameters (1)
topicstringrequired
Value for the topic parameter.
get_xdala_authoring_rules
Use this before creating, modifying or reviewing XRC/XDaLa artifacts.
No parameters.
get_xgr_standard_reference
Use this before drafting XRC-137 or XRC-729 artifacts.
Parameters (1)
standardstringrequired
Value for the standard parameter.
get_xgr_standard_schema
Retrieve machine-readable JSON schema for XGR standards.
Parameters (1)
standardstringrequired
Value for the standard parameter.
list_xgr_standard_examples
List available example artifacts for a standard.
Parameters (1)
standardstringrequired
Value for the standard parameter.
get_xgr_standard_example
Retrieve a concrete JSON example for XRC-137 or XRC-729.
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:
text
https://mcp.xgr.network/mcp
Testnet:
text
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.
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:
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:
bash
npm install
npm run typecheck
npm run build
npm run start:http
