How to Use the URL Metadata Scraper MCP in Mastra AI

Q: How can I use the URL Metadata Scraper within Mastra AI's workflow engine?

You integrate scrapeurl as a tool call in your multi-step workflow. The structured metadata it returns becomes an input variable for subsequent conditional steps, making your logic reliable.

Q: Can I use the URL Metadata Scraper as part of a larger automated process with Mastra AI?

You can absolutely embed scrapeurl into any complex, deployable workflow. This allows you to enforce data quality checks—like ensuring an image link exists—before completing your main task.

Build resilient, multi-step workflows that process metadata using Mastra AI.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect URL Metadata Scraper MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Conditional Workflow Branching

The `scrape_url` tool provides structured metadata, which you can use in a conditional branch. For instance, if the description field is empty, your workflow automatically triggers an alert or retries with a different scraping parameter. This capability means your complex multi-step workflows handle failures gracefully using Mastra AI's built-in branching logic.

Resilient Data Retrieval

You can incorporate the `scrape_url` tool into a process that expects failure (like hitting rate limits). If initial scraping fails, the workflow doesn't crash; Mastra AI automatically retries with exponential backoff. This makes your entire operational pipeline robust enough for production use cases.

Deployment-Ready Metadata Checks

Use `scrape_url` as a required step in a one-command deploy process. Before deploying content, you run the tool to validate that all necessary OpenGraph metadata exists and is structured correctly. This ensures your final product only deploys when the foundational data checks pass.

Setup guide

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

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

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

You integrate `scrape_url` as a tool call in your multi-step workflow. The structured metadata it returns becomes an input variable for subsequent conditional steps, making your logic reliable.

Yes. Because you're building complex workflows in Mastra AI, if the initial scrape fails (e.g., due to network issues), the platform automatically retries the `scrape_url` call for better data capture.

The tool provides clean OpenGraph metadata, including Title and Description. Mastra AI uses this structured output to validate your site's basic SEO presence across multiple steps.

You can absolutely embed `scrape_url` into any complex, deployable workflow. This allows you to enforce data quality checks—like ensuring an image link exists—before completing your main task.

This server handles Title, Description, and Image URLs from a given source. Your agent receives these standard text and URL strings for use in advanced workflow logic.

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