io.github.junct-bot/blockscout-mcp

[DISCOVERY] search Returns: { items: string[], next_page_params: object }.

search redirect Returns: { parameter: string, redirect: boolean, type: string }.

[DISCOVERY] get transactions Returns: { items: { timestamp: string, fee: { type: unknown, value: unknown }, gas_limit: number, block_number: number, status: string, method: string, ... }[], next_page_params: object }.

[DISCOVERY] get blocks Returns: { items: { base_fee_per_gas: string, burnt_fees: string, burnt_fees_percentage: number, difficulty: string, extra_data: string, gas_limit: string, ... }[], next_page_params: object }.

[DISCOVERY] get token transfers Returns: { items: { token_type: "ERC-20" | "ERC-721" | "ERC-1155" | "ERC-404", block_hash: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, log_index: number, method: string, timestamp: string, ... }[], next_page_params: object }.

[DISCOVERY] get internal transactions Returns: { items: { block_number: number, created_contract: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, error: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, gas_limit: string, index: number, ... }[], next_page_params: object }.

[DISCOVERY] get main page transactions

[DISCOVERY] get main page blocks — from Blockscout

[DISCOVERY] get indexing status Returns: { finished_indexing: boolean, finished_indexing_blocks: boolean, indexed_blocks_ratio: string, ... }.

[DISCOVERY] get stats counters Returns: { total_blocks: string, total_addresses: string, total_transactions: string, ... }.

get transactions chart Returns: { chart_data: { date: string, transactions_count: number }[] }.

get market chart Returns: { available_supply: string, chart_data: { date: string, closing_price: string, market_cap: string }[] }.

get transaction info Returns: { timestamp: string, fee: { type: string, value: string }, gas_limit: number, ... }.

get transaction token transfers Returns: { items: { token_type: "ERC-20" | "ERC-721" | "ERC-1155" | "ERC-404", block_hash: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, log_index: number, method: string, timestamp: string, ... }[], next_page_params: object }.

get transaction internal transactions Returns: { items: { block_number: number, created_contract: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, error: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, gas_limit: string, index: number, ... }[], next_page_params: object }.

get transaction logs Returns: { items: { address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, block_hash: string, block_number: number, data: string, decoded: { method_call: unknown, method_id: unknown, parameters: unknown }, index: number, ... }[], next_page_params: object }.

get transaction raw trace

get transaction state changes Returns: { items: { token: { circulating_market_cap: unknown, icon_url: unknown, name: unknown, decimals: unknown, symbol: unknown, address_hash: unknown, ... }, type: string, is_miner: boolean, address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, balance_before: string, balance_after: string, ... }[], next_page_params: object }.

get human-readable transaction summary Returns: { success: boolean, data: { summaries: { summary_template: string, summary_template_variables: unknown }[] } }.

get block info Returns: { base_fee_per_gas: string, burnt_fees: string, burnt_fees_percentage: number, ... }.

get block transactions Returns: { items: { timestamp: string, fee: { type: unknown, value: unknown }, gas_limit: number, block_number: number, status: string, method: string, ... }[], next_page_params: object }.

get block withdrawals Returns: { items: { index: number, amount: string, validator_index: number, receiver: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, block_number: number, timestamp: string }[], next_page_params: object }.

[DISCOVERY] get native coin holders list Returns: { exchange_rate: string, total_supply: string, items: { creator_address_hash: unknown, creation_transaction_hash: unknown, token: unknown, coin_balance: unknown, exchange_rate: unknown, implementation_address: unknown, ... }[], ... }.

get address info Returns: { creator_address_hash: string, creation_transaction_hash: string, token: { circulating_market_cap: string, icon_url: string, name: string, decimals: string, symbol: string, address_hash: string, ... }, ... }.

get address counters Returns: { transactions_count: string, token_transfers_count: string, gas_usage_count: string, ... }.

get address transactions Returns: { items: { timestamp: string, fee: { type: unknown, value: unknown }, gas_limit: number, block_number: number, status: string, method: string, ... }[], next_page_params: object }.

get address token transfers Returns: { items: { token_type: "ERC-20" | "ERC-721" | "ERC-1155" | "ERC-404", block_hash: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, log_index: number, method: string, timestamp: string, ... }[], next_page_params: object }.

get address internal transactions Returns: { items: { block_number: number, created_contract: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, error: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, gas_limit: string, index: number, ... }[], next_page_params: object }.

get address logs Returns: { items: { address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, block_hash: string, block_number: number, data: string, decoded: { method_call: unknown, method_id: unknown, parameters: unknown }, index: number, ... }[], next_page_params: object }.

get blocks validated by address Returns: { items: { base_fee_per_gas: string, burnt_fees: string, burnt_fees_percentage: number, difficulty: string, extra_data: string, gas_limit: string, ... }[], next_page_params: object }.

get all tokens balances for the address

[DISCOVERY] token balances with filtering and pagination Returns: { items: { token_instance: { is_unique: unknown, id: unknown, holder_address_hash: unknown, image_url: unknown, animation_url: unknown, external_app_url: unknown, ... }, value: string, token_id: string, token: { name: unknown, decimals: unknown, symbol: unknown, address_hash: unknown, type: unknown, holders_count: unknown, ... } }[], next_page_params: object }.

get address coin balance history Returns: { items: { transaction_hash: string, block_number: number, block_timestamp: string, delta: string, value: string }[], next_page_params: object }.

get address coin balance history by day

get address withdrawals Returns: { items: { index: number, amount: string, validator_index: number, receiver: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, block_number: number, timestamp: string }[], next_page_params: object }.

get list of NFT owned by address Returns: { items: { is_unique: boolean, id: string, holder_address_hash: string, image_url: string, animation_url: string, external_app_url: string, ... }[], next_page_params: object }.

get list of NFT owned by address, grouped by collection Returns: { items: { token: { circulating_market_cap: unknown, icon_url: unknown, name: unknown, decimals: unknown, symbol: unknown, address_hash: unknown, ... }, amount: string, token_instances: unknown[] }[], next_page_params: object }.

[DISCOVERY] get tokens list Returns: { items: { circulating_market_cap: string, icon_url: string, name: string, decimals: string, symbol: string, address_hash: string, ... }[], next_page_params: object }.

get token info Returns: { circulating_market_cap: string, icon_url: string, name: string, ... }.

get token token transfers Returns: { items: { token_type: "ERC-20" | "ERC-721" | "ERC-1155" | "ERC-404", block_hash: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, log_index: number, method: string, timestamp: string, ... }[], next_page_params: object }.

get token holders Returns: { items: { address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, value: string, token_id: string }[], next_page_params: object }.

get token holders Returns: { token_holders_count: string, transfers_count: string }.

get NFT instances Returns: { items: { is_unique: boolean, id: string, holder_address_hash: string, image_url: string, animation_url: string, external_app_url: string, ... }[], next_page_params: object }.

get NFT instance by id Returns: { is_unique: boolean, id: string, holder_address_hash: string, ... }. PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

get transfers of NFT instance Returns: { items: { token_type: "ERC-20" | "ERC-721" | "ERC-1155" | "ERC-404", block_hash: string, from: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, log_index: number, method: string, timestamp: string, ... }[], next_page_params: object }. PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

get token instance holders Returns: { items: { address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, value: string, token_id: string }[], next_page_params: object }. PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

get transfers count of NFT instance Returns: { transfers_count: number }. PREREQUISITE: You MUST first call a listing/map endpoint to resolve asset identifiers (id, slug, symbol) before calling data endpoints.

[DISCOVERY] re-fetch token instance metadata Returns: { message: string }.

[DISCOVERY] get verified smart contracts Returns: { items: { address_hash: { hash: unknown, implementation_name: unknown, name: unknown, ens_domain_name: unknown, metadata: unknown, is_contract: unknown, ... }, coin_balance: string, compiler_version: string, language: string, has_constructor_args: boolean, optimization_enabled: boolean, ... }[], next_page_params: object }.

[DISCOVERY] get verified smart contracts counters Returns: { new_smart_contracts_24h: string, new_verified_smart_contracts_24h: string, smart_contracts: string, ... }.