
vanborn-labs-mcp
io.github.arkaduush-code/vanborn-labs-mcp
MCP server for Van Born Labs: YouTube, Google News, email/domain validation, and ATS jobs.
Documentation
Van Born Labs MCP Server
Model Context Protocol (MCP) server for Van Born Labs data tools. AI assistants such as Claude, Cursor, ChatGPT (connectors) and Grok can discover and call Merchant Feed Doctor, YouTube scrapers, a Google News RSS scraper, an email and domain validator, ATS job scrapers, and more.
Store: apify.com/vanborn_labs
Website: arkadiuszvanborn.com/labs
Source: github.com/arkaduush-code/vanborn-labs-mcp
Product pages:
- MCP overview
- Merchant Feed Doctor
- YouTube Video Details & Outlier Score
- YouTube Comments Scraper
- ATS Career Jobs Scraper
- Google News RSS Scraper
- Email Verifier & Domain Validator
- YouTube Outlier Score (Chrome extension, live)
- Job Post Age Checker (Chrome extension, coming soon)
Contact: arkadiuszvanborn@gmail.com
You bring your own Apify API token. Each tool starts a Van Born Labs pay-per-event actor on your account, so you are billed for the run and we earn the developer share. The server never uses a shared token.
Tools
Enabled today (public on the Apify Store):
| Tool | What it does | Price (pay-per-event) |
|---|---|---|
youtube_video_details | YouTube video details, views, likes, tags, chapters and outlier score | $0.80 / 1,000 videos |
youtube_comments | YouTube comments and replies from videos, Shorts, channels or search | $1.00 / 1,000 comments |
ats_career_jobs | Jobs from Greenhouse, Lever, Ashby, Workable and other public ATS boards | $2.00 / 1,000 jobs |
google_news_rss | Google News headlines by keyword, topic, site or country | $1.00 / 1,000 articles |
email_domain_validator | Email and domain validation: syntax, typos, MX, SPF, DMARC, disposable | $0.50 / 1,000 results |
vanborn_labs_catalog | Lists every configured tool (including ones not yet enabled). Free, no run. | — |
Now enabled as well: Merchant Feed Doctor, GTA 6 news and viral-clip trackers, Content Rewards campaigns monitor and Clip Views & Earnings Tracker. More actors are in actors.json with "enabled": false and will be switched on after they are published on the Store: Company Hiring Signals, Competitor Ads Radar, Unified Reviews Monitor, Google Ads Transparency, Website SEO Audit, YouTube Shorts outliers, Google Trends, the Apple App Store scraper, Campaign Top Clips, YouTube Viral Moments and Transcripts.
Each tool uses the actor’s official input schema. If you omit the limit field (maxItems, maxResults, maxJobs, …), the server applies a small default so a casual prompt does not start a large, expensive run.
Install
Requirements: Node.js 18.18 or later, and an Apify API token from console.apify.com/settings/integrations.
npx (recommended)
npx -y vanborn-labs-mcp
Claude Desktop
Add this to claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"vanborn-labs": {
"command": "npx",
"args": ["-y", "vanborn-labs-mcp"],
"env": {
"APIFY_TOKEN": "your_apify_token"
}
}
}
}
Restart Claude Desktop after saving.
Cursor
Add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"vanborn-labs": {
"command": "npx",
"args": ["-y", "vanborn-labs-mcp"],
"env": {
"APIFY_TOKEN": "your_apify_token"
}
}
}
}
Streamable HTTP (ChatGPT connectors, remote hosts, Docker)
npx -y vanborn-labs-mcp --http --host 127.0.0.1 --port 8080
The MCP endpoint is http://127.0.0.1:8080/mcp (POST). Health check: GET /health.
For a container:
docker build -t vanborn-labs-mcp .
docker run --rm -e APIFY_TOKEN=your_apify_token -p 8080:8080 vanborn-labs-mcp
From source
git clone https://github.com/arkaduush-code/vanborn-labs-mcp.git
cd vanborn-labs-mcp
npm install
npm run build
node dist/index.js
Configuration
| Variable | Purpose |
|---|---|
APIFY_TOKEN | Required to call tools. Your personal Apify API token. Never committed. |
VANBORN_LABS_MCP_CONFIG | Optional path to a custom actors.json. |
VANBORN_LABS_MCP_ROOT | Optional package root if actors.json and schemas/ live elsewhere. |
The tool list is driven by actors.json. To add an actor after it is published:
- Fetch its input schema (or run
npm run sync-schemaswithAPIFY_TOKEN). - Add one entry to
actors.jsonwithtoolName,actorId(username~name),schemaFile,limitField,defaultMaxItems,timeoutSecsand a keyword-richdescription. - Set
"enabled": true. - Rebuild.
Input schemas in schemas/ were taken from each actor’s input schema via the Apify API.
Development
npm install
npm run build
npm test # list tools + two cheap live runs (needs APIFY_TOKEN; keep under $0.05)
npx -y @modelcontextprotocol/inspector node dist/index.js
Publishing
This package is ready to publish but is not published yet. See PUBLISH.md for the npm, GitHub, Smithery and Glama steps. Do not run those steps until the accounts and repository exist.
License
MIT © Van Born Labs
https://github.com/arkaduush-code/vanborn-labs-mcp/releases/download/v0.2.0/vanborn-labs-mcp-0.2.0.mcpb# mcpb: https://github.com/arkaduush-code/vanborn-labs-mcp/releases/download/v0.2.0/vanborn-labs-mcp-0.2.0.mcpb