How to Use the ZenRows MCP in Mastra AI

Q: Can the MCP Server handle geo-specific content for Mastra AI?

Yes. You can use scrapegeo to target localized content from specific countries, like 'us' or 'gb'. This ensures your complex workflows pull data relevant to the correct region.

Q: What if my scrape needs JavaScript rendering for Mastra AI?

The scrapejs tool enables full JS rendering using ZenRows' headless browser. It makes sure that dynamic content—the stuff that loads after the initial page load—is captured correctly.

Q: How do I handle waiting for content with ZenRows and Mastra AI?

Use scrapewait to pause execution until a specific CSS selector appears. This prevents premature scraping, ensuring that when your workflow continues, the required data is actually present.

Build reliable workflows with Mastra AI using ZenRows web scraping tools.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect ZenRows MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Reliable Data Retrieval for Mastra AI

The `scrape_html` tool is your main workhorse. ZenRows automatically rotates proxies and handles CAPTCHAs, giving you reliable raw HTML even when the source site fights back. For high-stakes data extraction within a workflow, use `scrape_premium`. This sets premium proxy access, boosting anonymity and making sure your multi-step process doesn't hit rate limits.

Custom Scraping for Mastra AI MCP Server

Need to scrape something super specific? The `scrape_custom` tool lets you define advanced parameters, including CSS selectors and session IDs. This gives your workflow the granular control it needs. If your data is highly protected, remember `scrape_antibot`. It enables JS rendering and bypasses bot detection, ensuring that complex workflows don't stall out on blocked pages.

Structured Content for Mastra AI

The `scrape_autoparse` tool automatically structures messy web content. Instead of dealing with a giant blob of text, your workflow gets organized data it can process and act upon. When you combine this with `get_screenshot`, your agent can first visually confirm the page state before running its next conditional step.

Setup guide

Set up ZenRows 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 ZenRows 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: "zenrows-mcp-client",
  servers: {
    "zenrows-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

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

const result = await agent.generate(
  "List recent ZenRows 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 ZenRows. 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 ZenRows 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 ZenRows MCP in Mastra AI

ZenRows manages proxy rotation and CAPTCHA handling, which drastically reduces failure points. This stability is critical when your workflow depends on successful data acquisition across multiple steps.

Yes. You can use `scrape_geo` to target localized content from specific countries, like 'us' or 'gb'. This ensures your complex workflows pull data relevant to the correct region.

The `scrape_js` tool enables full JS rendering using ZenRows' headless browser. It makes sure that dynamic content—the stuff that loads after the initial page load—is captured correctly.

Use `scrape_wait` to pause execution until a specific CSS selector appears. This prevents premature scraping, ensuring that when your workflow continues, the required data is actually present.

The server processes raw HTML, clean Markdown, and visual screenshots. You get options ranging from structured data to pixel-perfect images that your workflow engine can interpret.

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