How to Use the Lineascan MCP in OpenAI Agents SDK

Query Linea state directly inside your OpenAI Agents SDK production pipeline. Get balance, transaction, and contract data in real-time.

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 OpenAI Agents SDK

Create your Vinkius account to connect Lineascan to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated Transaction History Tracking

Your agent pulls transaction data using `tx_list` and `tx_list_internal` to reconcile user history. It handles the heavy lifting of indexing so your code stays clean. This MCP Server provides the raw data your agent needs to verify transfers. You get exact records for `token_tx` and `token_nft_tx` without writing custom indexers.

Real-time Contract Inspection

Verify smart contract logic by pulling bytecode and ABI definitions directly via `get_source_code` and `get_abi`. Your agents can audit logic on the fly. You avoid manual lookups by using `verify_source_code` to confirm deployment state. It connects your agent to the Linea chain registry instantly.

Network Status and Gas Estimation

Your agent calculates transaction costs using `eth_estimate_gas` before executing any actions. This prevents failed transactions and saves your budget. Access `eth_block_number` and `eth_price` to build context-aware agents. The data feeds directly into your logic for precise network operations.

Setup guide

Set up Lineascan MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Lineascan tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Lineascan tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Lineascan tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Lineascan Agent",
            instructions="You have access to Lineascan tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

Install the server via Vinkius and pass the endpoint to your Agent constructor using the MCP server list. Your OpenAI Agents SDK instance will auto-discover all 25 tools.

Yes, but keep your rate limits in mind. Use the cacheToolsList flag in your OpenAI Agents SDK configuration to reduce overhead on repeated calls.

The server provides standardized outputs consistent with standard RPC responses. You can add validation logic within your agent to handle edge cases.

Vinkius manages the connection via an ephemeral sandbox. Your environment only sees the tool outputs you explicitly allow the agent to invoke.

No. The server only reads public blockchain data like balances or transaction logs. It never touches your private keys or sensitive user credentials.

Use it with your favorite AI tools

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