Lineascan MCP for AI. Query ETH Balances, Track Transfers, and Inspect Contract Code.

Yo, listen up. The Lineascan MCP Server hooks your AI agent right into the Linea blockchain data. It gives you a ton of tools to read and inspect everything happening on the EVM—no leaving your IDE for this mess. You're gonna be able to track complex L2 transactions without breaking a sweat.

Checking Balances and Supply

When you need to know who's got cash, you can use get_balance to grab the ETH balance for just one address. If ya gotta check multiple accounts at once, hit up balance_multi; it gets ETH balances for a list of addresses all in one go. For big picture stuff, eth_supply returns the total circulating supply amount of ETH on Linea.

You can also see how much gas you're gonna spend by running eth_estimate_gas, which calculates the required gas for any specific transaction operation.

Tracking Assets and Transfers

To follow token movements, use token_tx to list every ERC-20 standard token transfer event associated with an address. If you're tracking NFTs (those are ERC-721s), token_nft_tx lists all those specific NFT transfer events for a given address and includes full metadata. For general activity, tx_list gets a list of normal, successful transactions tied to an address, while tx_list_internal pulls in the internal calls that happened during execution.

Analyzing Transactions Deeply

Need the nitty-gritty on a transaction? You can get full details about a single transfer using its hash with eth_get_transaction_by_hash. Once the transaction's done, you retrieve the final results—the receipt data—using eth_get_transaction_receipt. If you need to monitor something live, get_status checks the execution status of an ongoing transaction. To confirm a past transaction finished right, use get_tx_receipt_status to verify the final outcome and status from a previous receipt.

You can also check event logs from any contract using get_logs, giving you filtering options like address or topic. For tracking general activity history on an account, get_mined_blocks lists every block mined by that specific wallet address.

Understanding the Network State

If you wanna know what's going down with the network itself, you can grab the number of the most recent block using eth_block_number. Need data for a specific historical moment? Run eth_get_block_by_number to pull all info related to a specified block. You can also find out which block corresponds to a certain time stamp with get_block_no_by_time, or figure out the timestamp from a block number using get_block_countdown.

For rewards, get_block_reward retrieves the block and uncle rewards for any given block number. If you wanna know what's going on right now, eth_price gives you the current market price of ETH in both USD and BTC.

Reading Smart Contract Code

When you need to understand how a contract works, these tools are your ticket. To read its logic, you can fetch the Application Binary Interface (ABI) using get_abi. If you wanna see the original code, get_source_code retrieves the source for verified smart contracts. You also have control over submitting new code by running verify_source_code, which sends a contract's source to Lineascan for official verification.

When that submission is in progress, you can check its live status using check_verify_status.

Advanced Data Retrieval and Calls

Sometimes ya don't wanna send a transaction just to read data. For that, run eth_call; it executes a read-only message call without spending gas or creating any actual transaction. You can also get all the event logs from a contract using get_logs, giving you filtering options like address or topic.

This server gives ya everything: tracking assets with token_tx and token_nft_tx, checking balances with balance_multi and get_balance, pulling code with get_source_code and get_abi, analyzing transaction history using eth_get_transaction_by_hash and get_status, and monitoring the network state using eth_block_number and eth_price. It's everything you need, period.