Connect Diffbot to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the analyze text tool in Diffbot
Use the extract page tool in Diffbot
Use the manage crawl tool in Diffbot
Use the enhance entity tool in Diffbot
Use the search knowledge graph tool in Diffbot
Use the manage bulk job tool in Diffbot
Supported Tools
analyze_text
Analyze Text
Extract entities, facts, relationships, and sentiment from raw text using Diffbot's NLP engine. Identifies people, organizations, products, and other entities, links them to Knowledge Graph records, and extracts structured facts and relationships between entities.
extract_page
Extract Page
Extract structured data from a web page using Diffbot's AI-powered extraction engine. Supports automatic page type detection or targeted extraction for articles, products, discussions, images, videos, lists, events, and job postings. Can also process raw HTML/text content directly.
manage_crawl
Manage Crawl
Create, monitor, control, and retrieve results from Diffbot web crawl jobs. Crawls spider websites from seed URLs, discover linked pages, and process them through Diffbot's extraction APIs. Supports creating new crawls, checking status, pausing/resuming, restarting, deleting, and listing all crawl jobs.
enhance_entity
Enhance Entity
Enrich a person or organization record with comprehensive data from the public web. Provide minimal identifiers (name, domain, email, etc.) and receive a complete entity profile with 50+ fields. Optionally combine a person lookup with their current employer data in a single request.
search_knowledge_graph
Search Knowledge Graph
Search Diffbot's Knowledge Graph containing over 10 billion entities (organizations, people, articles, products, etc.) using DQL (Diffbot Query Language). Returns structured records with comprehensive fields and properties.
manage_bulk_job
Manage Bulk Job
Create, monitor, and retrieve results from Diffbot bulk extraction jobs. Bulk jobs process a list of known URLs through Diffbot's extraction APIs as a batch. Supports creating jobs, checking status, deleting, listing, and downloading results.
web_search
Web Search
Search Diffbot’s web index and return ranked page URLs, titles, content highlights, and publication dates.
get_account
Get Account
Get the connected Diffbot account name, email, plan, status, and recent API usage.
Enable Diffbot in Metorial. In your Metorial portal, enable the Diffbot MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Diffbot tools.
Enable Diffbot in Metorial. In your Metorial portal, enable the Diffbot MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Diffbot tools.
Enable Diffbot in Metorial. In your Metorial portal, enable the Diffbot MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Diffbot tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Diffbot in Metorial. In your Metorial portal, enable the Diffbot MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Diffbot tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Diffbot in Metorial. In your Metorial portal, enable the Diffbot MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Diffbot tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Diffbot through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Diffbot and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Diffbot tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Extract structured data from web pages using AI-powered computer vision and NLP. Automatically classify and parse articles, products, events, jobs, discussions, images, and videos into clean JSON. Search a knowledge graph of 10+ billion entities (organizations, people, articles, products) using Diffbot Query Language (DQL). Enrich person and organization records from minimal identifiers. Analyze natural language text to extract entities, facts, sentiment, and relationships. Crawl entire websites or process bulk URL lists through extraction APIs. Define custom extraction rules with CSS selectors for specific domains.
Frequently asked questions
Common questions about connecting Diffbot to AI agents with Metorial.
How many tools does the Diffbot MCP server have?
The Diffbot MCP server exposes 8 tools, including Analyze Text, Extract Page, Manage Crawl. Each one is governed and traced through Metorial.
Does the Diffbot MCP server support triggers?
Diffbot exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Diffbot MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Diffbot MCP server through the same Metorial URL.
How do I give only some teams access to Diffbot?
Use role-based access control to decide which teams, users, and agents can use Diffbot and which of its tools they can call.
Can I self-host the Diffbot MCP server?
Yes. Metorial is open source, so you can run the Diffbot MCP server yourself or use the hosted gateway.
Connect Diffbot to production AI agents
See how Metorial gives your team governed access to Diffbot, with tracing and security controls built in.