MCP Server
XGR MCP Gateway
io.github.xgr-network/xdala-workflow-builder
What this MCP does
Provides an MCP gateway for XGRChain and XDaLa workflows, including blockchain explorer queries, session inspection, transaction evidence, workflow discovery, and human wallet handoffs.
Capabilities
Tools
95
tools
cancel_operation_handoff
Cancel operation handoff
Cancel a pending offchain operation handoff. This never cancels already signed or submitted chain transactions.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operationId', 'secret'], 'properties': {'secret': {'type': 'string', 'minLength': 1, 'description': 'Secret token required to read or cancel protected handoff state.'}, 'operationId': {'type': 'string', 'minLength': 1, 'description': 'Identifier of a stored offchain operation handoff.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
cancel_xdala_bundle_deploy_handoff
Cancel XDaLa bundle deploy handoff
Cancel a pending XDaLa bundle deploy handoff. This is offchain metadata only and never cancels chain transactions.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
cancel_xdala_session_start_handoff
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.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
create_operation_handoff
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.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['type', 'network', 'chainId'], 'properties': {'type': {'type': 'string', 'minLength': 1, 'description': 'Operation or handoff type identifier.'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'minLength': 1}, 'kind': {'type': 'string', 'minLength': 1}, 'label': {'type': 'string', 'minLength': 1}, 'txRequest': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}, 'description': 'Ordered workflow or operation steps included in the handoff.'}, 'policy': {'type': 'object', 'description': 'Policy metadata controlling human review, approval or execution constraints.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'chainId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric EVM chain id for the target network.', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'minLength': 1, 'description': 'Target network name or environment, for example mainnet or devnet.'}, 'payload': {'description': 'Structured payload object for an XDaLa step or workflow request.'}, 'summary': {'type': 'object', 'description': 'Structured summary metadata for human review and audit context.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'ttlSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Time-to-live in seconds for temporary offchain handoff data.', 'exclusiveMinimum': 0}, 'validation': {'description': 'Validation metadata or validation result object for the handoff.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
create_xdala_bundle_deploy_handoff
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.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['network', 'chainId', 'bundle'], 'properties': {'bundle': {'type': 'object', 'description': 'Canonical XDaLa bundle JSON object to validate, store or hand off.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'chainId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric EVM chain id for the target network.', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'minLength': 1, 'description': 'Target network name or environment, for example mainnet or devnet.'}, 'summary': {'type': 'object', 'description': 'Structured summary metadata for human review and audit context.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'ttlSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Time-to-live in seconds for temporary offchain handoff data.', 'exclusiveMinimum': 0}, 'validation': {'type': 'object', 'description': 'Validation metadata or validation result object for the handoff.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
create_xdala_session_start_handoff
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.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'network'], 'properties': {'ui': {'type': 'object', 'description': 'Optional user-interface metadata for Workbench import and display.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'expiry': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Unix timestamp or expiry value for the prepared request.', 'exclusiveMinimum': 0}, 'ostcId': {'type': 'string', 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'source': {'enum': ['runtime', 'bundle_deploy_result', 'direct'], 'type': 'string', 'description': 'Source type for deriving the prepared XDaLa request.'}, 'stepId': {'type': 'string', 'description': 'Canonical XDaLa step id used by Workbench/session-start requests.'}, 'chainId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Numeric EVM chain id for the target network.', 'exclusiveMinimum': 0}, 'network': {'type': 'string', 'minLength': 1, 'description': 'Target network name or environment, for example mainnet or devnet.'}, 'payload': {'type': 'object', 'description': 'Structured payload object for an XDaLa step or workflow request.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'request': {'type': 'object', 'description': 'Canonical request object used by the target XDaLa workflow operation.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'signing': {'type': 'object', 'description': 'Signing metadata for Workbench or local wallet handoff preparation.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'summary': {'type': 'object', 'description': 'Structured summary metadata for human review and audit context.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'ostcHash': {'type': 'string', 'description': 'Hash or identifier of the orchestration step contract artifact.'}, 'security': {'type': 'object', 'description': 'Optional security metadata for handoff preparation.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'sessions': {'type': 'array', 'items': {'type': 'object', 'properties': {'__uid': {'type': 'string'}, 'expiry': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'stepId': {'type': 'string'}, 'payload': {'type': 'object', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'maxTotalGas': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'starterAddress': {'type': 'string'}}}, 'description': 'Array of canonical xgr-session-start@1 session requests.'}, 'execution': {'type': 'object', 'description': 'Execution metadata for prepared XDaLa workflow requests.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'ttlSeconds': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Time-to-live in seconds for temporary offchain handoff data.', 'exclusiveMinimum': 0}, 'maxTotalGas': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Maximum total gas budget allowed for the prepared XDaLa session request.'}, 'orchestration': {'type': 'string', 'description': 'Address or identifier of the deployed XDaLa orchestration contract.'}, 'walletAddress': {'type': 'string', 'description': 'Wallet address used as intended signer, starter or actor context.'}, 'executorGrants': {'type': 'object', 'description': 'Executor grant metadata for prepared XDaLa session-start requests.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'expectedSigner': {'type': 'string', 'description': 'Expected wallet address that should sign or execute the prepared handoff.'}, 'bundleDeployHandle': {'type': 'string', 'description': 'Opaque handle returned by a previous XDaLa bundle deploy handoff flow.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
create_xgr_purchase_order
Create XGR purchase order
Use when the user specifies an exact integer amount_xgr. Call get_xgr_purchase_options first, use payment_assets[].key, collect user-supplied identity and wallet fields, require explicit terms acceptance, and create one live reservation. Pay only from the returned payment_instruction.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['payment_asset', 'name', 'email', 'country_code', 'xgr_wallet', 'terms_accepted', 'amount_xgr'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Purchaser name supplied by the user. Do not invent it.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'description': 'Purchaser email supplied by the user. Do not invent it.'}, 'amount_xgr': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Exact integer XGR amount requested by the user.', 'exclusiveMinimum': 0}, 'xgr_wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'User-controlled XGRChain wallet that will receive the purchased XGR.'}, 'country_code': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': 'Two-letter uppercase country code supplied by the user, for example DE.'}, 'payment_asset': {'type': 'string', 'minLength': 1, 'description': 'Exact payment_assets[].key returned by get_xgr_purchase_options, for example usdc_eth. Do not use the display symbol.'}, 'sender_wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'User-controlled wallet that will send the stablecoin payment on the listed payment chain. Required when the selected payment asset has requires_sender_wallet=true.'}, 'terms_accepted': {'type': 'boolean', 'const': True, 'description': 'Set to true only after the user explicitly accepts the purchase terms. Never infer or invent acceptance.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
create_xgr_purchase_order_by_budget
Create XGR purchase order by budget
Use when the user specifies a maximum USDC/USDT payment amount rather than an XGR quantity. Call get_xgr_purchase_options first, use payment_assets[].key, collect user-supplied identity and wallet fields, require explicit terms acceptance, and create one live reservation. Pay only when payment_approved=true and next_action=external_crypto_payment; otherwise do not pay.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['payment_asset', 'name', 'email', 'country_code', 'xgr_wallet', 'terms_accepted', 'max_payment_amount'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Purchaser name supplied by the user. Do not invent it.'}, 'email': {'type': 'string', 'format': 'email', 'pattern': "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", 'description': 'Purchaser email supplied by the user. Do not invent it.'}, 'xgr_wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'User-controlled XGRChain wallet that will receive the purchased XGR.'}, 'country_code': {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': 'Two-letter uppercase country code supplied by the user, for example DE.'}, 'payment_asset': {'type': 'string', 'minLength': 1, 'description': 'Exact payment_assets[].key returned by get_xgr_purchase_options, for example usdc_eth. Do not use the display symbol.'}, 'sender_wallet': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'User-controlled wallet that will send the stablecoin payment on the listed payment chain. Required when the selected payment asset has requires_sender_wallet=true.'}, 'terms_accepted': {'type': 'boolean', 'const': True, 'description': 'Set to true only after the user explicitly accepts the purchase terms. Never infer or invent acceptance.'}, 'safety_margin_bps': {'type': 'integer', 'maximum': 1000, 'minimum': 0, 'description': 'Conservative planning margin in basis points. Omit to use the default 100 bps.'}, 'max_payment_amount': {'type': 'number', 'description': 'Maximum amount of the selected payment asset the user authorizes. This is USDC or USDT, not EUR.', 'exclusiveMinimum': 0}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
estimate_xdala_rule_gas
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['json'], 'properties': {'json': {'type': 'string', 'minLength': 1, 'description': 'Value for the json parameter.'}, 'encrypted': {'type': 'boolean', 'description': 'Value for the encrypted parameter.'}, 'validSpawns': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the valid spawns parameter.'}, 'invalidSpawns': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the invalid spawns parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
expand_address_relation_graph
Expand XGR address graph neighbors
Read-only progressive expansion of one address by exactly one graph level. Use this instead of requesting a larger graph when exploring interactively.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'maxEdges': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Value for the max edges parameter.'}, 'maxNodes': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Value for the max nodes parameter.'}, 'aggregate': {'type': 'boolean', 'description': 'Value for the aggregate parameter.'}, 'direction': {'enum': ['in', 'out', 'both'], 'type': 'string', 'description': 'Value for the direction parameter.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the min value wei parameter.'}, 'toTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to timestamp parameter.'}, 'fromTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from timestamp parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
find_latest_xdala_session
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'includePayload': {'type': 'boolean', 'description': 'Value for the include payload parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
find_reusable_xrc137_rules
Find reusable XRC-137 rules
Read-only metadata-assisted search for existing owner XRC-137 contracts that could be reused instead of redeployed.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'ruleHash': {'type': 'string', 'minLength': 1, 'description': 'Value for the rule hash parameter.'}, 'draftRule': {'type': 'object', 'description': 'Value for the draft rule parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'includeUsage': {'type': 'boolean', 'description': 'Value for the include usage parameter.'}, 'allowEncrypted': {'type': 'boolean', 'description': 'Value for the allow encrypted parameter.'}, 'requiredInputKeys': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Value for the required input keys parameter.'}, 'requiredOutputKeys': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Value for the required output keys parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
find_startable_xdala_workflows
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'network': {'type': 'string', 'minLength': 1, 'description': 'Target network name or environment, for example mainnet or devnet.'}, 'includeGraph': {'type': 'boolean', 'description': 'Value for the include graph parameter.'}, 'includeOwner': {'type': 'boolean', 'description': 'Value for the include owner parameter.'}, 'includeExecutor': {'type': 'boolean', 'description': 'Value for the include executor parameter.'}, 'includeWildcard': {'type': 'boolean', 'description': 'Value for the include wildcard parameter.'}, 'includePayloadSchema': {'type': 'boolean', 'description': 'Value for the include payload schema parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_account_live_state
Get account live state
Use this for live EVM account state. Returns balance, nonce and contract code for an address.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_account_transactions
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'direction': {'enum': ['in', 'out', 'both'], 'type': 'string', 'description': 'Value for the direction parameter.'}, 'valueOnly': {'type': 'boolean', 'description': 'Value for the value only parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_address_relation_graph
Get XGR address relation graph
Read-only bounded graph of indexed native XGR transfers around an address. Returns aggregated on-chain relations, verified Explorer labels, depth and truncation metadata. A relation proves only that transactions occurred between addresses; it does not imply common ownership or identity.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'depth': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'Value for the depth parameter.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'maxEdges': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Value for the max edges parameter.'}, 'maxNodes': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Value for the max nodes parameter.'}, 'aggregate': {'type': 'boolean', 'description': 'Value for the aggregate parameter.'}, 'direction': {'enum': ['in', 'out', 'both'], 'type': 'string', 'description': 'Value for the direction parameter.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the min value wei parameter.'}, 'toTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to timestamp parameter.'}, 'fromTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from timestamp parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_block_transactions
Get block transactions
Read-only list of transactions in a specific indexed block, latest indexed block, or latest indexed block minus latestOffset.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'blockNumber': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Block number or block identifier used for the chain lookup.'}, 'latestOffset': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the latest offset parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_chain_status
Get XGRChain status
Use this for live XGRChain status. Returns chain id, latest block number and gas price from JSON-RPC, plus official XGR.Network entry points for the connected mainnet.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_latest_block
Get latest block
Use this when the user asks for the latest EVM block details from XGRChain.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_latest_session_payload
Get latest XDaLa 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_operation_status
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['operationId'], 'properties': {'secret': {'type': 'string', 'description': 'Secret token required to read or cancel protected handoff state.'}, 'operationId': {'type': 'string', 'minLength': 1, 'description': 'Identifier of a stored offchain operation handoff.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_recent_value_transfers
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Recipient address, contract address or upper bound used for the query.'}, 'from': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Sender address or lower bound used for the query.'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the min value wei parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_recent_xdala_sessions
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'includePayload': {'type': 'boolean', 'description': 'Value for the include payload parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_relation_edge_transactions
Get transactions behind an XGR graph relation
Returns the indexed native XGR transactions represented by one directed graph edge, with the same minimum-value and time filters used by the relation graph.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source', 'target'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'source': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Source EVM address of the directed graph relation.'}, 'target': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Target EVM address of the directed graph relation.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the min value wei parameter.'}, 'toTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to timestamp parameter.'}, 'fromTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from timestamp parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_session_receipt_logs
Get XDaLa 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId', 'owner'], 'properties': {'limit': {'type': 'integer', 'maximum': 10000, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'filters': {'type': 'object', 'description': 'Value for the filters parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'stepIds': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Value for the step ids parameter.'}, 'includeTx': {'type': 'boolean', 'description': 'Value for the include tx parameter.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}, 'includeRaw': {'type': 'boolean', 'description': 'Value for the include raw parameter.'}, 'includeBlock': {'type': 'boolean', 'description': 'Value for the include block parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_sessions_overview
Get XDaLa sessions overview
Use this for high-level indexed XDaLa session analytics from the Explorer API.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'window': {'enum': ['24h', '7d', '30d', '1y', 'all'], 'type': 'string', 'description': 'Time window for aggregated analytics or overview data.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_session_status_live
Get live XDaLa session status
Use this to check live session status from XGR RPC. Returns xgr_sessionAlive for a session owner and session id.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId', 'owner'], 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_session_transactions
Get XDaLa 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId', 'owner'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_transaction_evidence
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['txHash'], 'properties': {'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': '0x-prefixed transaction hash to inspect or resolve.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_transaction_receipt
Get transaction receipt
Use this for receipt logs, status and gas usage of a transaction. Prefers Explorer decoded receipt data.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['txHash'], 'properties': {'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': '0x-prefixed transaction hash to inspect or resolve.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_transaction_stats
Get transaction stats
Read-only compact chain transaction statistics from the Explorer transaction index, with optional block or block-timestamp window filters.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'toBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to block parameter.'}, 'fromBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from block parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_unused_xrc137_rules
Get unused XRC-137 rules
Read-only list of owner XRC-137 rules with no observed tx_receipts engine_rule_contract usage.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_active_sessions_timeseries
Get XDaLa active sessions timeseries
Use this when the user asks for active/concurrent XDaLa sessions over time.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_authoring_rules
Get XDaLa authoring rules
Use this before creating, modifying or reviewing XRC/XDaLa artifacts.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_bundle_deploy_handoff
Get XDaLa bundle deploy handoff
Return stored metadata, bundle JSON, and any recorded deployed result/artifact for an XDaLa bundle deploy handoff handle.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_bundle_deploy_result
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_payload_field_value_stats
Get XDaLa payload field value statistics
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â.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['field'], 'properties': {'field': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'Value for the field parameter.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'source': {'enum': ['payload', 'apiSaves', 'contractSaves', 'extras'], 'type': 'string', 'description': 'Source type for deriving the prepared XDaLa request.'}, 'outcome': {'enum': ['any', 'success', 'fail', 'unknown'], 'type': 'string', 'description': 'Value for the outcome parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_payload_key_stats
Get XDaLa payload key statistics
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'source': {'enum': ['payload', 'apiSaves', 'contractSaves', 'extras'], 'type': 'string', 'description': 'Source type for deriving the prepared XDaLa request.'}, 'outcome': {'enum': ['any', 'success', 'fail', 'unknown'], 'type': 'string', 'description': 'Value for the outcome parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_payload_term_stats
Get XDaLa payload term statistics
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['keys', 'values', 'keys_and_values'], 'type': 'string', 'description': 'Value for the mode parameter.'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'source': {'enum': ['payload', 'apiSaves', 'contractSaves', 'extras'], 'type': 'string', 'description': 'Source type for deriving the prepared XDaLa request.'}, 'outcome': {'enum': ['any', 'success', 'fail', 'unknown'], 'type': 'string', 'description': 'Value for the outcome parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'minTermLength': {'type': 'integer', 'maximum': 64, 'minimum': 1, 'description': 'Value for the min term length parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_process_mermaid
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['source'], 'properties': {'bundle': {'type': 'object', 'description': 'Canonical XDaLa bundle JSON object to validate, store or hand off.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}, 'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'source': {'enum': ['runtime', 'bundle', 'bundle_handoff'], 'type': 'string', 'description': 'Source type for deriving the prepared XDaLa request.'}, 'direction': {'enum': ['TD', 'LR'], 'type': 'string', 'description': 'Value for the direction parameter.'}, 'includeRules': {'type': 'boolean', 'description': 'Value for the include rules parameter.'}, 'xrc729Address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the xrc729 address parameter.'}, 'includeWarnings': {'type': 'boolean', 'description': 'Value for the include warnings parameter.'}, 'includeAddresses': {'type': 'boolean', 'description': 'Value for the include addresses parameter.'}, 'includeRuleSummary': {'type': 'boolean', 'description': 'Value for the include rule summary parameter.'}, 'includePayloadFields': {'type': 'boolean', 'description': 'Value for the include payload fields parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_session_detail
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner', 'sessionId'], 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}, 'limitSteps': {'type': 'integer', 'maximum': 1000, 'minimum': 1, 'description': 'Value for the limit steps parameter.'}, 'includePayloads': {'type': 'boolean', 'description': 'Value for the include payloads parameter.'}, 'includeFinalPayload': {'type': 'boolean', 'description': 'Value for the include final payload parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_session_start_handoff
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_session_start_result
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['handle'], 'properties': {'handle': {'type': 'string', 'minLength': 1, 'description': 'Opaque handoff handle returned by a previous XDaLa MCP tool.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_session_stats
Get XDaLa session statistics
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_session_timeseries
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".
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'bucket': {'enum': ['hour', 'day', 'month'], 'type': 'string', 'description': 'Value for the bucket parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_start_payload_history
Get XDaLa start payload history
Read-only indexed history of payload values used when starting a specific XRC-729 OSTC entry step. Reads Explorer PGRO through the MCP gateway only, selects the first matching entry-step receipt per owner/session, and returns compact scalar value statistics for UI pickers.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['xrc729Address', 'ostcId', 'stepId'], 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'stepId': {'type': 'string', 'minLength': 1, 'description': 'Canonical XDaLa step id used by Workbench/session-start requests.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'xrc729Address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the xrc729 address parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xdala_step_stats
Get XDaLa step statistics
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â.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'bucket': {'enum': ['none', 'hour', 'day', 'month'], 'type': 'string', 'description': 'Value for the bucket parameter.'}, 'sessionId': {'type': 'string', 'description': 'XDaLa session identifier used to query runtime or explorer data.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_circulating_supply
Get XGR circulating supply
Use this to retrieve circulating supply information exposed by xgr_getCirculatingSupply.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_core_addresses
Get XGR core addresses
Use this to retrieve XGR core protocol addresses exposed by the xgr_getCoreAddrs RPC method.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_doc
Get XGR documentation topic
Retrieve canonical Markdown documentation for an XGR/XDaLa topic.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['topic'], 'properties': {'topic': {'enum': ['xdala-authoring', 'xrc-137-rule-document', 'xrc-137-contract', 'xrc-729-contract', 'xrc-729-orchestration', 'expression-evaluation', 'mcp-authoring', 'mcp-tools', 'xrc-137', 'xrc-729', 'rules', 'api-calls', 'contract-reads', 'xgr-multibundle'], 'type': 'string', 'description': 'Value for the topic parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_multibundle_reference
Get XGR MultiBundle reference
Retrieve canonical xgr-multi-bundle@1 Markdown documentation.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_multibundle_schema
Get XGR MultiBundle schema
Retrieve canonical XGR MultiBundle schema.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_network_info
Get official XGR.Network information
Use this when the user asks what XGR.Network, XGRChain or XDaLa is, or requests official XGR URLs, chain metadata, RPC, Explorer, MCP, testnet faucet, documentation, XRC standards, source repositories or ecosystem entry points. Returns canonical project metadata and links; use get_chain_status for live chain state.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_purchase_options
Get XGR purchase options
Call this first for every XGR purchase. Read live price, stock and payment assets; use payment_assets[].key exactly as payment_asset and inspect requires_sender_wallet before creating an order.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_session_start_schema
Get XGR Session Start schema
Retrieve canonical Workbench xgr-session-start@1 handoff schema.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_standard_example
Get XGR standard example
Retrieve a concrete JSON example for XRC-137 or XRC-729.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['standard', 'name'], 'properties': {'name': {'type': 'string', 'minLength': 1, 'description': 'Name used for lookup, generation or display.'}, 'standard': {'enum': ['xrc-137', 'xrc-729', 'xdala-authoring', 'xgr-multibundle'], 'type': 'string', 'description': 'Value for the standard parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_standard_reference
Get XGR standard reference
Use this before drafting XRC-137 or XRC-729 artifacts.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['standard'], 'properties': {'standard': {'enum': ['xrc-137', 'xrc-729', 'xdala-authoring', 'xgr-multibundle'], 'type': 'string', 'description': 'Value for the standard parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_standard_schema
Get XGR standard schema
Retrieve machine-readable JSON schema for XGR standards.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['standard'], 'properties': {'standard': {'enum': ['xrc-137', 'xrc-729', 'xdala-authoring', 'xgr-multibundle'], 'type': 'string', 'description': 'Value for the standard parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xgr_starter_gas_options
Get XGR starter gas options
Check whether free native XGR starter gas is available for a low-balance EVM address. Use this before deployments, session starts, contract calls or other on-chain actions when the address lacks gas. Returns the fixed 1 XGR grant policy and the tool to call next.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc729_authority
Get XRC-729 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['orchestration'], 'properties': {'orchestration': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Address or identifier of the deployed XDaLa orchestration contract.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc729_ostc_state
Get XRC-729 OSTC state
Read-only list of indexed OSTC state entries for an XRC-729 contract.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'includeDeleted': {'type': 'boolean', 'description': 'Value for the include deleted parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc_contract
Get indexed XRC contract
Read-only lookup of one indexed XRC contract by address.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc_contract_events
Get indexed XRC contract events
Read-only list of all indexed XRC events for one contract.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc_failure_stats
Get XRC failure stats
Read-only invalid/failure statistics associated with an XRC-137 rule or XRC-729 OSTC/process filters.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'type': {'enum': ['xrc137', 'xrc729'], 'type': 'string', 'description': 'Operation or handoff type identifier.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'ostcHash': {'type': 'string', 'minLength': 1, 'description': 'Hash or identifier of the orchestration step contract artifact.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc_owner_summary
Get XRC owner summary
Compact read-only summary of XRC-137/XRC-729 assets and recent XRC events for an owner.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['owner'], 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
get_xrc_usage
Get XRC session usage
Read-only usage statistics from Explorer PGRO tx_receipts for XRC-137 rules or XRC-729 OSTC/process filters.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'type': {'enum': ['xrc137', 'xrc729'], 'type': 'string', 'description': 'Operation or handoff type identifier.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'ostcHash': {'type': 'string', 'minLength': 1, 'description': 'Hash or identifier of the orchestration step contract artifact.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_recent_operations
List recent operations
List recent offchain operation handoffs. Secrets and browser execution tokens are never returned by this tool.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'description': 'Maximum number of records to return.', 'exclusiveMinimum': 0}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_wakeup_targets_by_address
List open XDaLa wake-up 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'last': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of most recent records to inspect.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xdala_session_ids
List XDaLa session IDs grouped by owner
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'outcome': {'enum': ['any', 'success', 'fail', 'unknown'], 'type': 'string', 'description': 'Value for the outcome parameter.'}, 'limitOwners': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Value for the limit owners parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'maxSessionIdsPerOwner': {'type': 'integer', 'maximum': 2000, 'minimum': 1, 'description': 'Value for the max session ids per owner parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xdala_session_owners
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xdala_sessions
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'cursor': {'type': 'object', 'required': ['lastSeenAt', 'owner', 'sessionId'], 'properties': {'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'sessionId': {'type': 'string', 'minLength': 1}, 'lastSeenAt': {'type': 'string', 'minLength': 1}}, 'description': 'Value for the cursor parameter.'}, 'outcome': {'enum': ['any', 'success', 'fail', 'unknown'], 'type': 'string', 'description': 'Value for the outcome parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xgr_docs
List XGR documentation topics
List canonical Markdown documentation topics served by the MCP knowledge base.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xgr_standard_examples
List XGR standard examples
List available example artifacts for a standard.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['standard'], 'properties': {'standard': {'enum': ['xrc-137', 'xrc-729', 'xdala-authoring', 'xgr-multibundle'], 'type': 'string', 'description': 'Value for the standard parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xgr_standards
List XGR standards
List agent-readable XGR and XDaLa standards available in the MCP knowledge base.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xrc729_contracts_by_executor
List XRC-729 contracts by executor
Read-only Explorer lookup for active XRC-729 executor relations of one address. This is index-backed, does not scan contracts, and returns Explorer pagination metadata.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['executor'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'executor': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the executor parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xrc_contracts
List indexed XRC contracts
Read-only list of indexed XRC-137/XRC-729 contracts globally or filtered by owner/type.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'type': {'enum': ['xrc137', 'xrc729'], 'type': 'string', 'description': 'Operation or handoff type identifier.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xrc_events
List indexed XRC events
Read-only list of XRC events globally or by owner, contract, type/action, tx hash, or block range.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'type': {'enum': ['xrc137', 'xrc729'], 'type': 'string', 'description': 'Operation or handoff type identifier.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'action': {'enum': ['deploy', 'update', 'ostc_update', 'ostc_delete'], 'type': 'string', 'description': 'Value for the action parameter.'}, 'txHash': {'type': 'string', 'minLength': 1, 'description': '0x-prefixed transaction hash to inspect or resolve.'}, 'toBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to block parameter.'}, 'contract': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the contract parameter.'}, 'fromBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from block parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
list_xrc_process_sessions
List XRC process sessions
Read-only list of sessions associated with an XRC-729 OSTC id/hash.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'ostcHash': {'type': 'string', 'minLength': 1, 'description': 'Hash or identifier of the orchestration step contract artifact.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'xrc729Address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the xrc729 address parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
quote_xgr_purchase
Quote XGR purchase budget
Use only when the user specifies a maximum USDC/USDT payment budget. Call get_xgr_purchase_options first, pass payment_assets[].key, and treat this result as planning only: it creates no order and is not a payment instruction.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['max_payment_amount', 'payment_asset'], 'properties': {'payment_asset': {'type': 'string', 'minLength': 1, 'description': 'Exact payment_assets[].key returned by get_xgr_purchase_options, for example usdc_eth. Do not use the display symbol.'}, 'safety_margin_bps': {'type': 'integer', 'maximum': 1000, 'minimum': 0, 'description': 'Conservative planning margin in basis points. Omit to use the default 100 bps.'}, 'max_payment_amount': {'type': 'number', 'description': 'Maximum amount of the selected payment asset the user authorizes. This is USDC or USDT, not EUR.', 'exclusiveMinimum': 0}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
read_xrc137_rule_json
Read XRC-137 rule JSON
Read-only eth_call to XRC137.getRule(), returning the runtime rule JSON string.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
read_xrc729_ostc_json
Read XRC-729 OSTC JSON
Read-only eth_call to XRC729.getOSTC(ostcId), returning the runtime OSTC JSON string.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address', 'ostcId'], 'properties': {'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
request_xgr_starter_gas
Request XGR starter gas
Use this tool when a user or agent needs native XGR to pay transaction fees on the configured XGR network. It sends one fixed 1 XGR grant from a dedicated server-controlled funding wallet to an eligible low-balance EVM address. Use it before deployments, session starts, contract calls or other on-chain actions when the address lacks gas. One confirmed grant per address; client-IP request limits apply; no repayment is required. The service never requests, receives or stores user or third-party private keys and cannot sign on behalf of users.
Open world
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address'], 'properties': {'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'purpose': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Value for the purpose parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
resolve_wakeup_payload_schema
Resolve XDaLa wake-up 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['address', 'owner', 'sessionId'], 'properties': {'pid': {'type': 'string', 'minLength': 1, 'description': 'XDaLa process id within a session tree.'}, 'step': {'type': 'string', 'minLength': 1, 'description': 'Human-readable XDaLa step label or step identifier.'}, 'owner': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM address of the XDaLa session owner or relevant account.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'EVM wallet, Safe or contract address in 0x-prefixed hexadecimal format.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
resolve_xrc729_process_graph
Resolve XRC-729 process graph
Resolve deployed XRC-729 OSTC runtime JSON and linked indexed XRC-137 rule contracts without mutating chain state.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['xrc729Address'], 'properties': {'ostcId': {'type': 'string', 'minLength': 1, 'description': 'Orchestration step contract id for the XDaLa workflow.'}, 'includeRules': {'type': 'boolean', 'description': 'Value for the include rules parameter.'}, 'includeUsage': {'type': 'boolean', 'description': 'Value for the include usage parameter.'}, 'xrc729Address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Value for the xrc729 address parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
search_transactions
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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Recipient address, contract address or upper bound used for the query.'}, 'from': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Sender address or lower bound used for the query.'}, 'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'One-based page number for paginated explorer/API results.'}, 'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'valid': {'type': 'boolean', 'description': 'Value for the valid parameter.'}, 'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': '0x-prefixed transaction hash to inspect or resolve.'}, 'toBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to block parameter.'}, 'executed': {'type': 'boolean', 'description': 'Value for the executed parameter.'}, 'hasInput': {'type': 'boolean', 'description': 'Value for the has input parameter.'}, 'hasValue': {'type': 'boolean', 'description': 'Value for the has value parameter.'}, 'fromBlock': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from block parameter.'}, 'sessionId': {'type': 'string', 'minLength': 1, 'description': 'XDaLa session identifier used to query runtime or explorer data.'}, 'valueEqWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the value eq wei parameter.'}, 'valueGtWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the value gt wei parameter.'}, 'valueLtWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the value lt wei parameter.'}, 'windowHours': {'type': 'integer', 'maximum': 8760, 'minimum': 0, 'description': 'Value for the window hours parameter.'}, 'contractCreation': {'type': 'boolean', 'description': 'Value for the contract creation parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
search_xgr_transactions
Search native XGR transactions for flow analysis
Find indexed native-XGR transactions using time, value and address filters before choosing a transaction for Relation Graph or Value Flow analysis. Typical use: all native transfers in the last 24 hours above a given XGR/wei amount. Results are read-only and cursor-paginated for latest/oldest sorting.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'sort': {'enum': ['latest', 'oldest', 'largest'], 'type': 'string', 'description': 'Sort order. largest is intentionally a bounded single-page picker view.'}, 'limit': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of records to return.'}, 'cursor': {'type': 'string', 'pattern': '^\\d+:\\d+$', 'description': 'Cursor returned by a previous latest/oldest search.'}, 'address': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Optional address that may appear on either side of the transfer.'}, 'toAddress': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Optional exact recipient address.'}, 'fromAddress': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$', 'description': 'Optional exact sender address.'}, 'maxValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Optional maximum native XGR transfer value in wei.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Minimum native XGR transfer value in wei.'}, 'toTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Optional inclusive Unix-seconds upper time bound.'}, 'fromTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Optional inclusive Unix-seconds lower time bound.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
trace_xgr_transaction
Trace an XGR transaction relation graph
Loads an indexed transaction, uses its sender as the bounded graph root, returns sender/recipient trace roots plus the graph and an explicit edge to highlight. Useful for following native XGR transaction relations, but it does not attribute later mixed balances to the seed value.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['txHash'], 'properties': {'depth': {'type': 'integer', 'maximum': 4, 'minimum': 1, 'description': 'Value for the depth parameter.'}, 'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': '0x-prefixed transaction hash to inspect or resolve.'}, 'maxEdges': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Value for the max edges parameter.'}, 'maxNodes': {'type': 'integer', 'maximum': 300, 'minimum': 1, 'description': 'Value for the max nodes parameter.'}, 'direction': {'enum': ['in', 'out', 'both'], 'type': 'string', 'description': 'Value for the direction parameter.'}, 'minValueWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Value for the min value wei parameter.'}, 'toTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the to timestamp parameter.'}, 'fromTimestamp': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Value for the from timestamp parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
trace_xgr_value_flow
Trace native XGR value provenance
Read-only native-XGR value-flow analysis starting from one transaction. Use model="possible" for conservative attribution ranges or model="proportional" for haircut attribution. Native XGR has no per-coin identity, so results are provenance models rather than proof that a specific coin moved. maxTransfers and maxHops accept a number or "all"; "all" is still bounded by Explorer server safety caps and reports truncation explicitly.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['txHash'], 'properties': {'model': {'enum': ['possible', 'proportional'], 'type': 'string', 'description': 'possible returns attribution ranges; proportional applies a haircut/share model.'}, 'txHash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': '0x-prefixed transaction hash to inspect or resolve.'}, 'maxHops': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, {'type': 'string', 'const': 'all'}], 'description': 'Maximum propagation hops from the seed recipient, or "all" subject to server safety caps.'}, 'amountWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Optional amount of the seed transaction value to trace in wei. Defaults to the full native XGR value of the seed transaction.'}, 'maxTransfers': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1}, {'type': 'string', 'const': 'all'}], 'description': 'Maximum propagated transfers to return, or "all" to continue until exhaustion subject to server safety caps.'}, 'minAttributedWei': {'type': 'string', 'pattern': '^\\d+$', 'description': 'Ignore branches whose possible/attributed amount falls below this wei threshold.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xdala_blueprint
Validate XDaLa blueprint
Validate XRC-729 OSTC plus per-step XRC-137 payload-flow consistency.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ostc', 'xrc137ByStep', 'entryStepId'], 'properties': {'ostc': {'type': 'object', 'description': 'Value for the ostc parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'entryStepId': {'type': 'string', 'minLength': 1, 'description': 'Value for the entry step id parameter.'}, 'xrc137ByStep': {'type': 'object', 'description': 'Value for the xrc137 by step parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'initialPayloadFields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Value for the initial payload fields parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xdala_bundle
Validate XDaLa bundle
Alias for validate_xgr_multibundle.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bundle'], 'properties': {'bundle': {'type': 'object', 'description': 'Canonical XDaLa bundle JSON object to validate, store or hand off.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xdala_rules
Validate XDaLa rule expressions
Validate rule expressions against available placeholder fields.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rules'], 'properties': {'rules': {'type': 'array', 'items': {}, 'description': 'Value for the rules parameter.'}, 'availableFields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Value for the available fields parameter.'}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xgr_multibundle
Validate XGR MultiBundle
Validate canonical deployable xgr-multi-bundle@1.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['bundle'], 'properties': {'bundle': {'type': 'object', 'description': 'Canonical XDaLa bundle JSON object to validate, store or hand off.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xgr_session_start
Validate legacy XGR Session Start
Validate legacy low-level session-start payload only.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionStart'], 'properties': {'sessionStart': {'type': 'object', 'description': 'Value for the session start parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xgr_session_start_handoff
Validate XGR Session Start Handoff
Validate a canonical Workbench xgr-session-start@1 request.
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['request'], 'properties': {'request': {'type': 'object', 'description': 'Canonical request object used by the target XDaLa workflow operation.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
validate_xrc137_authoring
Validate XRC-137 authoring rules
Validate a drafted XRC-137 authoring object.
Read only
Open world
Idempotent
Input schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['rule'], 'properties': {'rule': {'type': 'object', 'description': 'Value for the rule parameter.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}}}
Output schema
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['data'], 'properties': {'data': {'description': 'Structured result data returned by the XGR MCP gateway.'}}, 'additionalProperties': False}
History
Recent tool changes
Added
request_xgr_starter_gas
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_starter_gas_options
Sept. 17, 2026, 12:53 p.m.
Added
create_xgr_purchase_order_by_budget
Sept. 17, 2026, 12:53 p.m.
Added
create_xgr_purchase_order
Sept. 17, 2026, 12:53 p.m.
Added
quote_xgr_purchase
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_purchase_options
Sept. 17, 2026, 12:53 p.m.
Added
validate_xdala_blueprint
Sept. 17, 2026, 12:53 p.m.
Added
validate_xdala_rules
Sept. 17, 2026, 12:53 p.m.
Added
validate_xrc137_authoring
Sept. 17, 2026, 12:53 p.m.
Added
validate_xdala_bundle
Sept. 17, 2026, 12:53 p.m.
Added
validate_xgr_multibundle
Sept. 17, 2026, 12:53 p.m.
Added
validate_xgr_session_start_handoff
Sept. 17, 2026, 12:53 p.m.
Added
validate_xgr_session_start
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_session_start_schema
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_multibundle_schema
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_multibundle_reference
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_standard_example
Sept. 17, 2026, 12:53 p.m.
Added
list_xgr_standard_examples
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_standard_schema
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_standard_reference
Sept. 17, 2026, 12:53 p.m.
Added
get_xdala_authoring_rules
Sept. 17, 2026, 12:53 p.m.
Added
get_xgr_doc
Sept. 17, 2026, 12:53 p.m.
Added
list_xgr_docs
Sept. 17, 2026, 12:53 p.m.
Added
list_xgr_standards
Sept. 17, 2026, 12:53 p.m.
Added
get_xdala_process_mermaid
Sept. 17, 2026, 12:53 p.m.
Added
list_recent_operations
Sept. 17, 2026, 12:53 p.m.
Added
get_xdala_session_start_result
Sept. 17, 2026, 12:53 p.m.
Added
cancel_xdala_session_start_handoff
Sept. 17, 2026, 12:53 p.m.
Added
get_xdala_session_start_handoff
Sept. 17, 2026, 12:53 p.m.
Added
create_xdala_session_start_handoff
Sept. 17, 2026, 12:53 p.m.
Discover
Similar MCP servers
Delx Commerce — Pay-per-Result APIs for Agents
io.github.davidmosiah/delx-mcp-a2a
Provides pay-per-result APIs and agent protocol tools for continuity, multi-agent coordination, document OCR, and crypto-related …
SAP MCP Server
ai.oobeprotocol.sap.mcp/sap-mcp
Provides an MCP gateway connecting SAP-related tools with Solana, DeFi, decentralized identity, and x402 payments.
TheProtocol — Sovereign AI Agent Platform
cloud.theprotocol/registry
Manages sovereign AI agents, identities, contracts, payments, governance, exchanges, and cross-frame token transfers.
hyperion
com.thetempleofdoom.hyperion/hyperion
Acts as a paid MCP tool marketplace and utility gateway with server discovery, HTTP and JavaScript tools, research, data conversi…
AgentBIT
app.agentbit/mcp
Routes pay-per-call tools over x402 on Base, covering discovery, data conversion, company research, counterparty screening, domai…
webbersites-x402-data-api
io.github.webberdesign/webbersites-x402-data-api
Provides pay-per-call utilities for web scraping, SEO and accessibility audits, document extraction, DNS and email checks, crypto…
Wisely x402 Agent-Payment Infrastructure
com.wiselyenterprisesllc/x402-agent-payment-infrastructure
Provides agent payment workflows for x402 endpoints, wallet handoffs, receipts, creator catalogs, local commerce bridges, endpoin…
Taifoon coordination layer
io.taifoon/coordination-layer
Coordinates agent registration, hiring, benchmarking, resource grids, assurance workflows, and blockchain-based settlement and pr…