Skip to main content
Glama

get_block_at_time

Read-onlyIdempotent

chainpeek: find the block at a point in time on Ethereum, Base or Robinhood Chain. For the latest block use get_block_number. Returns block (the last block at or before the time) and next_block, or is_latest: true when the time is at or after the head. A time before Base's genesis is a 422 before_genesis (not charged). A malformed or inconsistent node answer is a 5xx and is not charged. Typically 1-3 s (about 3-6 reads). Price: USD 0.003. Free: 10 chain reads per IP per UTC day. Docs: https://tanod.dev/learn/block-at-timestamp-api.html

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "chain": "<chain>",
      "timestamp": "<timestamp>"
    },
    "name": "get_block_at_time"
  }
}

Input Schema

NameRequiredDescriptionDefault
chainYesChain to read.
timestampYesUnix seconds or ISO 8601 (no offset = UTC), e.g. 2026-01-01T00:00:00Z.

Output Schema

NameRequiredDescriptionDefault
blockNo
chainNo
errorNoOnly on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object.
is_latestNo
rpc_callsNo
timestampNo
next_blockNo
assumed_utcNo
timestamp_isoNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changed
    • removedInput schema / properties / chain / title
      Removed value: -"Chain"
    • removedInput schema / properties / timestamp / title
      Removed value: -"Timestamp"
    • removedInput schema / title
      Removed value: -"get_block_at_timeArguments"
    • removedOutput schema / properties / block / properties
      Removed value: -{
      -  "number": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "timestamp": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "timestamp_iso": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
    • removedOutput schema / properties / next_block / properties
      Removed value: -{
      -  "number": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "timestamp": {
      -    "type": [
      -      "integer",
      -      "null"
      -    ]
      -  },
      -  "timestamp_iso": {
      -    "type": [
      -      "string",
      -      "null"
      -    ]
      -  }
      -}
  2. Changed1 schema field changed
    • changedInput schema / properties / chain / enum
      Previous value: -[
      -  "ethereum",
      -  "base"
      -]New value: +[
      +  "ethereum",
      +  "base",
      +  "robinhood"
      +]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "properties": {
      +    "assumed_utc": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "block": {
      +      "properties": {
      +        "number": {
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "timestamp": {
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "timestamp_iso": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "chain": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "error": {
      +      "description": "Only on an error result: an object {code, message}, or the reason string of an x402 PaymentRequired object."
      +    },
      +    "is_latest": {
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "next_block": {
      +      "properties": {
      +        "number": {
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "timestamp": {
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "timestamp_iso": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    },
      +    "rpc_calls": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "timestamp": {
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "timestamp_iso": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  4. Added

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources