How to Use the Lineascan MCP in Windsurf

Q: Can Cascade run multi-step token audits using Lineascan in Windsurf?

Yes. Cascade chains balancemulti with tokentx to map out token distributions across multiple Linea addresses in your Windsurf sidebar. It analyzes the flow of ERC-20 tokens autonomously and writes a summary report.

Q: How does Windsurf handle gas estimation using the Lineascan tools?

Cascade calls ethestimategas to calculate the exact gas limits for your Linea contract deployment. It then matches this with ethprice to show you the dollar cost inside Windsurf before you run it.

Let Cascade autonomously inspect smart contracts and track transactions on Linea directly inside your Windsurf IDE.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Lineascan MCP to Windsurf

Create your Vinkius account to connect Lineascan to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Lineascan with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Linea Contracts via Windsurf MCP Server

The Lineascan MCP server exposes `get_source_code` and `get_abi` so Cascade can fetch verified smart contracts without you opening a browser. Cascade takes this raw code, analyzes it for security vulnerabilities, and writes patches directly in your Windsurf workspace. When Cascade encounters an unverified contract on Linea, it uses `verify_source_code` and `check_verify_status` to submit the source files and monitor verification. This entire loop happens in one autonomous Windsurf run, keeping your focus on writing solid Solidity code.

Reconstruct Transaction Histories Instantly

Cascade pulls transaction histories using `tx_list` and `tx_list_internal` to piece together the execution path of complex Linea smart contract calls. You don't have to copy-paste hashes because Windsurf automatically feeds the output of one tool directly into the next step. For token activity, the agent queries `token_tx` and `token_nft_tx` to map out ERC-20 and ERC-721 movements across any Linea address. It builds a complete timeline of asset flows, allowing Cascade to display the entire history right inside Windsurf.

Query Live Chain Metrics and Gas Estimates

Cascade uses `eth_estimate_gas` and `eth_price` to calculate Linea transaction costs in real-time before staging deployment scripts. It combines these metrics with `eth_block_number` to ensure your Windsurf deployment scripts execute during low-congestion windows. If you need specific block data, Cascade invokes `eth_get_block_by_number` and `get_block_countdown` to track Linea mining progress. This direct access to Linea's state ensures your local Windsurf development environment matches the live network conditions.

Setup guide

Set up Lineascan MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Lineascan MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Lineascan payment history." If connected, Cascade will call the Lineascan tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "lineascan-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Lineascan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Lineascan now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Lineascan MCP in Windsurf

It feeds live Linea blockchain data directly to Cascade. When an execution fails, Cascade calls `eth_get_transaction_receipt` and `get_status` to find the exact revert reason in Windsurf.

Yes. Cascade chains `balance_multi` with `token_tx` to map out token distributions across multiple Linea addresses in your Windsurf sidebar. It analyzes the flow of ERC-20 tokens autonomously and writes a summary report.

No. Vinkius manages your Lineascan API credentials securely behind a single endpoint token. Windsurf connects to the MCP server, and Cascade immediately discovers all twenty-five tools without requiring keys in your codebase.

Cascade calls `eth_estimate_gas` to calculate the exact gas limits for your Linea contract deployment. It then matches this with `eth_price` to show you the dollar cost inside Windsurf before you run it.

This MCP server only processes public blockchain data like Linea contract addresses, transaction hashes, and Solidity source code. Vinkius runs this server inside an isolated, zero-trust sandbox, meaning your local files and private keys never leave your Windsurf session.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript