How to Use the Diffbot MCP in Mastra AI

Q: Can I use Diffbot workflows with Mastra AI conditional branching?

Absolutely. You can check the output of analyzepagetype and route the execution path based on the result. If it's a product page, the workflow triggers extractproductdata automatically.

Build resilient web-scraping workflows and knowledge graph lookups using Mastra AI and Diffbot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Diffbot MCP to Mastra AI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Resilient web scraping with Mastra AI workflows

Web scraping is notoriously unreliable. By pairing Mastra with this MCP Server, you can build workflows that automatically retry `extract_product_data` if a site times out. You define the backoff strategy directly in TypeScript. If the primary extraction fails, your agent can branch to `analyze_page_type` to diagnose the issue before trying again.

Automated background research pipelines

Building a lead generation pipeline requires clean data. You can chain `search_knowledge_graph` with `enhance_company_profile` to automatically qualify target accounts. Mastra executes these steps sequentially or in parallel depending on your workflow graph. You get structured, verified company profiles without manual data entry.

Guardrails for autonomous market analysis

Sometimes you need a human eye before updating a production database. This MCP integration supports manual approval steps before executing deep searches. Your agent can gather potential leads using `enhance_person_profile` and pause for authorization. Once approved, the workflow resumes and writes the clean data to your CRM.

Setup guide

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

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

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

You instantiate the MCP client and spread the tools directly into your Agent configuration. Mastra handles the tool schemas automatically. Your agent can immediately call `extract_article_data` without manual mapping.

Absolutely. You can check the output of `analyze_page_type` and route the execution path based on the result. If it's a product page, the workflow triggers `extract_product_data` automatically.

You configure Mastra's built-in workflow engine to handle retries with exponential backoff. If the API returns a rate limit error, the system pauses and retries without crashing your process.

Yes, you can run the server locally and connect Mastra via a local HTTP transport. Use `test_diffbot_auth` to verify your environment variables are configured correctly before deploying.

All lookup queries are sent directly to the secure API over encrypted TLS connections. The Vinkius environment handles token authentication securely on the backend. No third-party logs are kept of your search queries.

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