comprehensive_chain_status
Monitor Arbitrum chain health by checking ArbOS version, batch posting status, assertion monitoring, and gas prices. Use this tool to get comprehensive status updates for PM and support teams.
Instructions
Get comprehensive chain status including ArbOS version, batch posting, assertion monitoring, and gas prices. Perfect for PM and support teams asking 'what is the current status of XAI?' or similar comprehensive status checks. Auto-resolves contract addresses from chain name when possible.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| rpcUrl | No | The RPC URL of the Arbitrum chain (optional if default is set) | |
| chainName | No | Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve RPC URL and contract addresses | |
| parentRpcUrl | No | Parent chain RPC URL (auto-resolved if chainName provided) | |
| sequencerInboxAddress | No | Sequencer inbox contract address (auto-resolved if chainName provided) | |
| bridgeAddress | No | Bridge contract address (auto-resolved if chainName provided) | |
| rollupAddress | No | Rollup contract address (auto-resolved if chainName provided) |
Implementation Reference
- src/index.ts:775-809 (handler)MCP tool execution handler for 'comprehensive_chain_status'. Resolves RPC URL and chain name, auto-populates parent RPC and contract addresses using ChainLookupService, instantiates ArbitrumChainClient, calls getComprehensiveChainStatus, and returns formatted JSON response.case "comprehensive_chain_status": { const rpcUrl = await this.resolveRpcUrl( (args.rpcUrl as string) || (args.chainName as string) ); const chainDataClient = new ArbitrumChainClient(rpcUrl); // Get chain info to auto-populate contract addresses let chainInfo = null; if (args.chainName) { chainInfo = await this.chainLookupService.findChainByName(args.chainName as string); } const parentRpcUrl = args.parentRpcUrl as string || (chainInfo?.parentChainId === 1 ? "https://eth.llamarpc.com" : "https://arb1.arbitrum.io/rpc"); const sequencerInboxAddress = args.sequencerInboxAddress as string || chainInfo?.ethBridge?.sequencerInbox || ""; const bridgeAddress = args.bridgeAddress as string || chainInfo?.ethBridge?.bridge || ""; const rollupAddress = args.rollupAddress as string || chainInfo?.ethBridge?.rollup || ""; const chainName = args.chainName as string || chainInfo?.name || "Unknown Chain"; const status = await chainDataClient.getComprehensiveChainStatus( chainName, parentRpcUrl, sequencerInboxAddress, bridgeAddress, rollupAddress ); return { content: [ { type: "text", text: JSON.stringify(status, null, 2), }, ], }; }
- Core helper function getComprehensiveChainStatus that concurrently fetches and aggregates ArbOS version, batch posting status, assertion status, and gas status using Promise.allSettled for graceful error handling, returning a comprehensive ChainStatus object.async getComprehensiveChainStatus( chainName: string, parentRpcUrl: string, sequencerInboxAddress: string, bridgeAddress: string, rollupAddress: string ): Promise<ChainStatus> { // Use Promise.allSettled to handle individual failures gracefully const results = await Promise.allSettled([ this.getArbOSVersion(), this.getBatchPostingStatus(parentRpcUrl, sequencerInboxAddress, bridgeAddress), this.getAssertionStatus(parentRpcUrl, rollupAddress), this.getGasStatus() ]); const arbosVersion = results[0].status === 'fulfilled' ? results[0].value : "Error retrieving ArbOS version"; const batchPosting = results[1].status === 'fulfilled' ? results[1].value : { lastBatchPostedSecondsAgo: 999999, lastBlockReported: "0", latestChildChainBlockNumber: "0", backlogSize: "0", summary: "Error retrieving batch posting status" }; const assertions = results[2].status === 'fulfilled' ? results[2].value : { latestCreatedAssertion: null, latestConfirmedAssertion: null, creationConfirmationGap: "0", summary: "Error retrieving assertion status" }; const gasStatus = results[3].status === 'fulfilled' ? results[3].value : { currentGasPrice: "0", currentGasPriceGwei: "0", summary: "Error retrieving gas status" }; return { chainName, arbosVersion, batchPosting, assertions, gasStatus }; }
- src/index.ts:1642-1677 (schema)Input schema definition for the 'comprehensive_chain_status' tool, specifying properties for RPC URL, chain name, and optional contract addresses with detailed descriptions of auto-resolution capabilities.name: "comprehensive_chain_status", description: "Get comprehensive chain status including ArbOS version, batch posting, assertion monitoring, and gas prices. Perfect for PM and support teams asking 'what is the current status of XAI?' or similar comprehensive status checks. Auto-resolves contract addresses from chain name when possible.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum chain (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve RPC URL and contract addresses", }, parentRpcUrl: { type: "string", description: "Parent chain RPC URL (auto-resolved if chainName provided)", }, sequencerInboxAddress: { type: "string", description: "Sequencer inbox contract address (auto-resolved if chainName provided)", }, bridgeAddress: { type: "string", description: "Bridge contract address (auto-resolved if chainName provided)", }, rollupAddress: { type: "string", description: "Rollup contract address (auto-resolved if chainName provided)", }, }, required: [], }, },
- TypeScript interfaces defining the output structure for ChainStatus, including nested BatchPostingStatus, AssertionStatus, and GasStatus for comprehensive chain monitoring data.export interface BatchPostingStatus { lastBatchPostedSecondsAgo: number; lastBlockReported: string; latestChildChainBlockNumber: string; backlogSize: string; summary: string; } export interface AssertionStatus { latestCreatedAssertion: string | null; latestConfirmedAssertion: string | null; creationConfirmationGap: string; summary: string; } export interface GasStatus { currentGasPrice: string; // in wei currentGasPriceGwei: string; // in gwei for readability summary: string; } export interface ChainStatus { chainName: string; arbosVersion: string; batchPosting: BatchPostingStatus; assertions: AssertionStatus; gasStatus: GasStatus; }
- src/index.ts:821-1681 (registration)Tool registration via getAvailableTools() method that returns the list of all available tools including 'comprehensive_chain_status' for the MCP ListToolsRequestSchema handler.private getAvailableTools(): Tool[] { console.error("ArbitrumMCPServer: Creating tools list"); const tools = [ { name: "set_rpc_url", description: "Set the default RPC URL for subsequent requests", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL to set as default", }, }, required: ["rpcUrl"], }, }, { name: "get_rpc_url", description: "Get the current default RPC URL", inputSchema: { type: "object" as const, properties: {}, }, }, { name: "clear_rpc_url", description: "Clear the default RPC URL", inputSchema: { type: "object" as const, properties: {}, }, }, { name: "node_health", description: "Check Arbitrum node health status (requires admin API access - may not work with public RPCs)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "sync_status", description: "Get node synchronization status (may fall back to current block number if sync API unavailable)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, }, required: [], }, }, { name: "node_peers", description: "Get connected peers information (requires admin API access - will not work with public RPCs)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, }, required: [], }, }, { name: "arbos_version", description: "Get the ArbOS version number for any Arbitrum chain. Use this for questions like 'what ArbOS version is Xai running?', 'ArbOS version of Arbitrum One', 'what version of ArbOS', or 'check ArbOS version'. Supports chain names like 'Xai', 'Arbitrum One', 'Nova', etc.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One', 'Nova') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "latest_block", description: "Get the latest block information", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, }, required: [], }, }, { name: "get_balance", description: "Get balance of an address in wei", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, address: { type: "string", description: "Ethereum address to check balance for", }, }, required: ["address"], }, }, { name: "get_balance_ether", description: "Get balance of an address in ETH", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, address: { type: "string", description: "Ethereum address to check balance for", }, }, required: ["address"], }, }, { name: "get_transaction", description: "Get transaction details by hash", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, txHash: { type: "string", description: "Transaction hash", }, }, required: ["txHash"], }, }, { name: "get_transaction_receipt", description: "Get transaction receipt by hash", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, txHash: { type: "string", description: "Transaction hash", }, }, required: ["txHash"], }, }, { name: "is_contract", description: "Check if an address is a contract", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the chain (optional if default is set)", }, address: { type: "string", description: "Address to check", }, }, required: ["address"], }, }, { name: "list_chains", description: "List all available Arbitrum Orbit chains and their names. Use this to see what chains are available for querying.", inputSchema: { type: "object" as const, properties: {}, }, }, { name: "search_chains", description: "Search for Arbitrum chains by name, chain ID, or partial name match. Perfect for finding chains when you have incomplete information.", inputSchema: { type: "object" as const, properties: { query: { type: "string", description: "Search query (chain name like 'Xai', 'Arbitrum One', chain ID like '42161', or partial name)", }, }, required: ["query"], }, }, { name: "chain_info", description: "Get comprehensive chain information including rollup contract address, bridge addresses, chain ID, RPC URL, explorer URL, native token details, and all bridge contract addresses. Use this for questions about rollup addresses, bridge contracts, chain IDs, or any chain-specific data for Arbitrum chains like Xai, Arbitrum One, etc.", inputSchema: { type: "object" as const, properties: { chainName: { type: "string", description: "Chain name to look up (e.g., 'Xai', 'Arbitrum One', 'Nova', 'Stylus')", }, }, required: ["chainName"], }, }, { name: "get_rollup_address", description: "Get the rollup contract address for a specific Arbitrum chain. Use this for direct rollup address queries like 'what's the rollup address of Xai?', 'Xai rollup contract', or 'rollup address for Arbitrum One'.", inputSchema: { type: "object" as const, properties: { chainName: { type: "string", description: "Chain name to get rollup address for (e.g., 'Xai', 'Arbitrum One', 'Nova')", }, }, required: ["chainName"], }, }, // ========== NEW ARBITRUM NODE TOOLS ========== { name: "arb_check_publisher_health", description: "Check the health status of the transaction publisher/sequencer (requires admin API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "arb_get_raw_block_metadata", description: "Retrieve raw block metadata for specified block ranges (requires admin API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, fromBlock: { type: "number", description: "Starting block number", }, toBlock: { type: "number", description: "Ending block number (defaults to fromBlock if not provided)", }, }, required: ["fromBlock"], }, }, { name: "arb_latest_validated", description: "Get the latest validated global state information (requires admin API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "arbtrace_call", description: "Trace individual calls with specified trace types (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, callArgs: { type: "object", description: "Call arguments (to, from, data, etc.)", }, traceTypes: { type: "array", description: "Array of trace types (e.g., ['trace', 'stateDiff'])", items: { type: "string" }, }, blockNumOrHash: { type: "string", description: "Block number or hash (defaults to 'latest')", }, }, required: ["callArgs"], }, }, { name: "arbtrace_callMany", description: "Trace multiple calls in batch for efficiency (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, calls: { type: "array", description: "Array of call objects to trace", items: { type: "object" }, }, blockNumOrHash: { type: "string", description: "Block number or hash (defaults to 'latest')", }, }, required: ["calls"], }, }, { name: "arbtrace_replayBlockTransactions", description: "Replay and trace all transactions in a specific block (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, blockNumOrHash: { type: "string", description: "Block number or hash to replay", }, traceTypes: { type: "array", description: "Array of trace types (e.g., ['trace', 'stateDiff'])", items: { type: "string" }, }, }, required: ["blockNumOrHash"], }, }, { name: "arbtrace_replayTransaction", description: "Replay and trace a specific transaction (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, txHash: { type: "string", description: "Transaction hash to replay", }, traceTypes: { type: "array", description: "Array of trace types (e.g., ['trace', 'stateDiff'])", items: { type: "string" }, }, }, required: ["txHash"], }, }, { name: "arbtrace_transaction", description: "Get trace information for a specific transaction (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, txHash: { type: "string", description: "Transaction hash to trace", }, }, required: ["txHash"], }, }, { name: "arbtrace_get", description: "Get specific trace data at a given path within a transaction (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, txHash: { type: "string", description: "Transaction hash", }, path: { type: "array", description: "Path to specific trace data", items: { type: "string" }, }, }, required: ["txHash"], }, }, { name: "arbtrace_block", description: "Get trace information for all transactions in a block (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, blockNumOrHash: { type: "string", description: "Block number or hash to trace", }, }, required: ["blockNumOrHash"], }, }, { name: "arbtrace_filter", description: "Filter traces based on specified criteria (requires trace API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, filter: { type: "object", description: "Filter criteria for traces", }, }, required: ["filter"], }, }, { name: "arbdebug_validateMessageNumber", description: "Validate a specific message number (requires debug API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, msgNum: { type: "number", description: "Message number to validate", }, full: { type: "boolean", description: "Whether to perform full validation", }, moduleRoot: { type: "string", description: "Optional module root hash", }, }, required: ["msgNum"], }, }, { name: "arbdebug_validationInputsAt", description: "Get validation inputs at a specific message (requires debug API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, msgNum: { type: "number", description: "Message number to get validation inputs for", }, target: { type: "string", description: "Target for validation inputs", }, }, required: ["msgNum"], }, }, { name: "maintenance_status", description: "Check maintenance status - seconds since last maintenance (requires admin API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "maintenance_trigger", description: "Manually trigger maintenance operations (requires admin API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "timeboost_sendExpressLaneTransaction", description: "Submit priority transactions through express lanes for faster processing (requires timeboost API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, submission: { type: "object", description: "Express lane submission data", }, }, required: ["submission"], }, }, { name: "auctioneer_submitAuctionResolutionTransaction", description: "Submit auction resolution transactions for express lane functionality (requires auctioneer API)", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum node (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, transaction: { type: "object", description: "Auction resolution transaction data", }, }, required: ["transaction"], }, }, // ========== MONITORING TOOLS ========== { name: "batch_posting_status", description: "Monitor batch posting activity. Tracks when batches were last posted to the sequencer inbox and current backlog size. Essential for PM and support teams to understand chain data availability status.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum chain (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, parentRpcUrl: { type: "string", description: "Parent chain RPC URL (e.g., Ethereum mainnet RPC)", }, sequencerInboxAddress: { type: "string", description: "Sequencer inbox contract address", }, bridgeAddress: { type: "string", description: "Bridge contract address", }, }, required: ["parentRpcUrl", "sequencerInboxAddress", "bridgeAddress"], }, }, { name: "assertion_status", description: "Monitor assertion creation and confirmation activity. Tracks NodeCreated vs NodeConfirmed events to understand rollup validation status. Critical for PM and support teams to monitor chain security and finality.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum chain (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, parentRpcUrl: { type: "string", description: "Parent chain RPC URL (e.g., Ethereum mainnet RPC)", }, rollupAddress: { type: "string", description: "Rollup contract address", }, }, required: ["parentRpcUrl", "rollupAddress"], }, }, { name: "gas_status", description: "Monitor current gas prices on the chain. Essential for identifying gas price spikes and understanding transaction costs. Useful for PM and support teams to monitor network congestion.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum chain (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve to RPC URL", }, }, required: [], }, }, { name: "comprehensive_chain_status", description: "Get comprehensive chain status including ArbOS version, batch posting, assertion monitoring, and gas prices. Perfect for PM and support teams asking 'what is the current status of XAI?' or similar comprehensive status checks. Auto-resolves contract addresses from chain name when possible.", inputSchema: { type: "object" as const, properties: { rpcUrl: { type: "string", description: "The RPC URL of the Arbitrum chain (optional if default is set)", }, chainName: { type: "string", description: "Chain name (e.g., 'Xai', 'Arbitrum One') - will auto-resolve RPC URL and contract addresses", }, parentRpcUrl: { type: "string", description: "Parent chain RPC URL (auto-resolved if chainName provided)", }, sequencerInboxAddress: { type: "string", description: "Sequencer inbox contract address (auto-resolved if chainName provided)", }, bridgeAddress: { type: "string", description: "Bridge contract address (auto-resolved if chainName provided)", }, rollupAddress: { type: "string", description: "Rollup contract address (auto-resolved if chainName provided)", }, }, required: [], }, }, ]; console.error(`ArbitrumMCPServer: Created ${tools.length} tools`); return tools; }