Blockscout MCP Server

Instructions

Implementation Reference

• blockscout_mcp_server/tools/transaction/get_transaction_info.py:20-81 (handler)

  The main asynchronous handler function that fetches transaction data from Blockscout API, processes it (including truncation), transforms it, and returns a structured ToolResponse with TransactionInfoData.
  @log_tool_invocation async def get_transaction_info( chain_id: Annotated[str, Field(description="The ID of the blockchain")], transaction_hash: Annotated[str, Field(description="Transaction hash")], ctx: Context, include_raw_input: Annotated[ bool | None, Field(description="If true, includes the raw transaction input data.") ] = False, ) -> ToolResponse[TransactionInfoData]: """ Get comprehensive transaction information. Unlike standard eth_getTransactionByHash, this tool returns enriched data including decoded input parameters, detailed token transfers with token metadata, transaction fee breakdown (priority fees, burnt fees) and categorized transaction types. By default, the raw transaction input is omitted if a decoded version is available to save context; request it with `include_raw_input=True` only when you truly need the raw hex data. Essential for transaction analysis, debugging smart contract interactions, tracking DeFi operations. """ # noqa: E501 api_path = f"/api/v2/transactions/{transaction_hash}" await report_and_log_progress( ctx, progress=0.0, total=2.0, message=f"Starting to fetch transaction info for {transaction_hash} on chain {chain_id}...", ) base_url = await get_blockscout_base_url(chain_id) await report_and_log_progress( ctx, progress=1.0, total=2.0, message="Resolved Blockscout instance URL. Fetching transaction data..." ) response_data = await make_blockscout_request(base_url=base_url, api_path=api_path) await report_and_log_progress(ctx, progress=2.0, total=2.0, message="Successfully fetched transaction data.") processed_data, was_truncated = _process_and_truncate_tx_info_data(response_data, include_raw_input) final_data_dict = _transform_transaction_info(processed_data) transaction_data = TransactionInfoData(**final_data_dict) notes = None if was_truncated: notes = [ ( "One or more large data fields in this response have been truncated " '(indicated by "value_truncated": true or "raw_input_truncated": true).' ), ( f"To get the full, untruncated data, you can retrieve it programmatically. " f'For example, using curl:\n`curl "{str(base_url).rstrip("/")}/api/v2/transactions/{transaction_hash}"`' ), ] instructions = [ ( "To check for ERC-4337 User Operations related to this tx, call " f"`direct_api_call` with endpoint `/api/v2/proxy/account-abstraction/operations` " f"with query_params={{'transaction_hash': '{transaction_hash}'}}." ) ] return build_tool_response(data=transaction_data, notes=notes, instructions=instructions)
• blockscout_mcp_server/server.py:202-204 (registration)

  Registration of the get_transaction_info tool with the FastMCP server instance, including annotations.
  structured_output=False, annotations=create_tool_annotations("Get Transaction Information"), )(get_transaction_info)
• blockscout_mcp_server/models.py:224-274 (schema)

  Pydantic models defining the output schema for get_transaction_info: TransactionInfoData (main), TokenTransfer, and DecodedInput. Used in the tool's return type ToolResponse[TransactionInfoData].
  # --- Model for get_transaction_info Data Payload --- class TokenTransfer(BaseModel): """Represents a single token transfer within a transaction.""" model_config = ConfigDict(extra="allow") # External APIs may add new fields; allow them to avoid validation errors from_address: str | None = Field(alias="from", description="Sender address of the token transfer if available.") to_address: str | None = Field(alias="to", description="Recipient address of the token transfer if available.") token: dict[str, Any] = Field(description="Token metadata dictionary associated with the transfer.") transfer_type: str = Field(alias="type", description="Type of transfer (e.g., 'transfer', 'mint').") # --- Model for get_transaction_info Data Payload --- class DecodedInput(BaseModel): """Represents the decoded input data of a transaction.""" model_config = ConfigDict(extra="allow") # External APIs may add new fields; allow them to avoid validation errors method_call: str = Field(description="Name of the called method.") method_id: str = Field(description="Identifier of the called method.") parameters: list[Any] = Field(description="List of decoded input parameters for the method call.") # --- Model for get_transaction_info Data Payload --- class TransactionInfoData(BaseModel): """Structured representation of get_transaction_info data.""" model_config = ConfigDict(extra="allow") # External APIs may add new fields; allow them to avoid validation errors from_address: str | None = Field( default=None, alias="from", description="Sender of the transaction if available.", ) to_address: str | None = Field( default=None, alias="to", description="Recipient of the transaction if available.", ) token_transfers: list[TokenTransfer] = Field( default_factory=list, description="List of token transfers related to the transaction." ) decoded_input: DecodedInput | None = Field( default=None, description="Decoded method input if available.", ) raw_input: str | None = Field(default=None, description="Raw transaction input data if returned.") raw_input_truncated: bool | None = Field(default=None, description="Indicates if raw_input was truncated.")