How to Use the Lineascan MCP in Mastra AI

Build resilient Linea indexing workflows with Mastra AI and automated retries.

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 Mastra AI

Create your Vinkius account to connect Lineascan to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate contract audits with Mastra AI workflows

`get_source_code` retrieves contract files so your Mastra AI agent can audit them automatically before triggering a Linea deployment. If the contract is unverified, the Mastra AI workflow branches to notify your team via Slack. The agent uses `get_abi` to parse the interface and prepare automated integration tests on Linea.

Resilient balance monitoring via this MCP Server

`balance_multi` tracks whale addresses and triggers automated ledger updates inside your Mastra AI workflow. If the Lineascan API rate limit triggers, Mastra's engine retries the call with exponential backoff. This setup ensures your Mastra AI monitoring agents never miss a balance change due to temporary Linea network drops.

Multi-step transaction analysis with conditional branch steps

`get_tx_receipt_status` determines whether a transaction succeeded before your Mastra AI agent executes the next step in your pipeline. Upon receiving a failed execution status, your Mastra AI agent automatically triggers `tx_list_internal` to diagnose the gas execution error. This conditional branching keeps your automated Linea ledger audits completely accurate.

Setup guide

Set up Lineascan MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Lineascan tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "lineascan-mcp-client",
  servers: {
    "lineascan-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Lineascan Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Lineascan tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Lineascan transactions"
);
console.log(result.text);

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 Mastra AI

Instantiate the MCPClient with your Vinkius URL and register it in your Mastra AI agent configuration. The agent instantly gains access to all 25 Lineascan tools, including tx_list and get_logs.

Yes, Mastra AI supports requireToolApproval for sensitive actions. You can pause the workflow when the agent attempts to call verify_source_code until a developer reviews the payload.

The Mastra AI workflow engine intercepts failures from tools like eth_get_transaction_receipt and executes your defined retry policy. This prevents transient Lineascan API hiccups from crashing your long-running blockchain monitoring agents.

Yes, you can trigger a Mastra AI workflow on a cron schedule to execute get_block_reward. The agent processes the block data and stores it in your database automatically.

No, this MCP setup only routes your queries to the public Linea network to fetch balances and contract states. Vinkius runs the Mastra AI server in an ephemeral sandbox, meaning your queried wallet addresses and transaction hashes are wiped immediately.

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