get_block_info
Retrieve detailed information about a specific block by its number or hash across supported blockchain networks using the Bankless Onchain MCP Server.
Instructions
Gets detailed information about a specific block by number or hash
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| blockId | Yes | The block number or block hash to fetch information for | |
| network | Yes | The blockchain network (e.g., "ethereum", "base") |
Implementation Reference
- src/operations/blocks.ts:35-82 (handler)The core handler function that performs the API call to retrieve block information, handles various Bankless API errors, and returns a BlockInfoVO object.export async function getBlockInfo( network: string, blockId: string ): Promise<BlockInfoVO> { const token = process.env.BANKLESS_API_TOKEN; if (!token) { throw new BanklessAuthenticationError('BANKLESS_API_TOKEN environment variable is not set'); } const endpoint = `${BASE_URL}/chains/${network}/block/${blockId}`; try { const response = await axios.get( endpoint, { headers: { 'Content-Type': 'application/json', 'X-BANKLESS-TOKEN': `${token}` } } ); // Convert server response to match our BlockInfoVO structure return response.data } catch (error) { if (axios.isAxiosError(error)) { const statusCode = error.response?.status || 'unknown'; const errorMessage = error.response?.data?.message || error.message; if (statusCode === 401 || statusCode === 403) { throw new BanklessAuthenticationError(`Authentication Failed: ${errorMessage}`); } else if (statusCode === 404) { throw new BanklessResourceNotFoundError(`Block not found: ${blockId}`); } else if (statusCode === 422) { throw new BanklessValidationError(`Validation Error: ${errorMessage}`, error.response?.data); } else if (statusCode === 429) { // Extract reset timestamp or default to 60 seconds from now const resetAt = new Date(); resetAt.setSeconds(resetAt.getSeconds() + 60); throw new BanklessRateLimitError(`Rate Limit Exceeded: ${errorMessage}`, resetAt); } throw new Error(`Bankless API Error (${statusCode}): ${errorMessage}`); } throw new Error(`Failed to get block info: ${error instanceof Error ? error.message : String(error)}`); } }
- src/operations/blocks.ts:13-29 (schema)Input schema (BlockInfoSchema) using Zod for validation of network and blockId parameters, and output type definition (BlockInfoVO).export const BlockInfoSchema = z.object({ network: z.string().describe('The blockchain network (e.g., "ethereum", "base")'), blockId: z.string().describe('The block number or block hash to fetch information for') }); // Block Info Response type - matches the Kotlin model export type BlockInfoVO = { number: string; // BigInteger in Kotlin hash: string; timestamp: string; // BigInteger in Kotlin baseFeePerGas: string; // BigInteger in Kotlin blobGasUsed: string; // BigInteger in Kotlin gasUsed: string; // BigInteger in Kotlin gasLimit: string; // BigInteger in Kotlin readableTimestamp: string; // Instant in Kotlin, ISO string in TypeScript network: string; // Added to maintain consistency with other response types };
- src/index.ts:130-134 (registration)Registration of the 'get_block_info' tool in the MCP server's tool list for ListToolsRequest, including name, description, and reference to the input schema.{ name: "get_block_info", description: "Gets detailed information about a specific block by number or hash", inputSchema: zodToJsonSchema(blocks.BlockInfoSchema), }
- src/index.ts:257-266 (registration)Dispatch handler in the CallToolRequest switch statement that parses arguments using the schema, calls the getBlockInfo handler, and formats the response for MCP.case "get_block_info": { const args = blocks.BlockInfoSchema.parse(request.params.arguments); const result = await blocks.getBlockInfo( args.network, args.blockId ); return { content: [{type: "text", text: JSON.stringify(result, null, 2)}], }; }