scavio-ai/scavio-mcp

Scavio is a unified Web Search API and MCP server that gives AI agents web search, page extraction, and structured data from e-commerce, social, travel, jobs, real-estate, app-store, ad-library and company-filing sources. 266 tools across 38 platforms plus Extract, map, crawl and batch, one API key.
**The 22 platforms added in 0.13.0 are opt-in.** Registering all 266 tools puts 253KB of tool definitions — roughly 64k tokens — into every session before you type anything. So the default is the platform set 0.12.x already had, plus Extract: 142 tools, 112KB. Upgrading never removes a tool you were using. Everything else is one env var away: see Choosing which tools load.
Remote MCP Server
Connect directly to Scavio's remote MCP server without any local installation:
Two ways to authenticate:
- **Sign in with OAuth, no key to copy.** Claude Desktop, claude.ai and Claude Code sign in to your Scavio account through the server. In Claude Desktop or claude.ai: Settings > Connectors > Add custom connector, name it Scavio, paste the URL, then Connect and Authorize. In Claude Code: claude mcp add --transport http scavio https://mcp.scavio.dev/mcp, then run /mcp and choose Authenticate.
- **API key.** Pass it in the x-api-key header. Get your key at scavio.dev.
---
Run Locally (npx)
Prefer to run the server on your own machine? Use npx with no clone or build. The server runs over stdio and only needs your SCAVIO_API_KEY.
Claude Code
Any MCP-Compatible Client (Claude Desktop, Cursor, Windsurf, VS Code, etc.)
Requires Node.js 20+. Get your API key at scavio.dev.
---
Install
Claude Code
Sign in with OAuth, then run /mcp inside Claude Code and choose Authenticate:
Or pass an API key:
Claude Desktop
No API key needed: Settings > Connectors > Add custom connector, name it Scavio, paste https://mcp.scavio.dev/mcp, then Connect and sign in to your Scavio account. The same steps work on claude.ai.
Or run the server locally. Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
Requires Node.js 20+. Restart Claude Desktop after saving.
Cursor
Or add to .cursor/mcp.json in your project root or ~/.cursor/mcp.json for global:
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
VS Code
Create .vscode/mcp.json in your project root:
ChatGPT
1. Go to ChatGPT > **Settings** > **Apps & Connectors**
2. Click **Add custom connector**
3. Enter the MCP server URL: https://mcp.scavio.dev/mcp
4. Configure authentication with your API key
Cline
Add to cline_mcp_settings.json (open via Cline sidebar > MCP Servers > Configure):
Zed
Add to settings (Cmd+,):
Any MCP-Compatible Client
---
Choosing which tools load
Scavio exposes 266 tools. Loading all of them costs 253KB of tools/list —
roughly 64k tokens of context in every session before the user has said anything,
and more tools than some clients will accept at all. So the server registers a
curated subset by default and lets you pick the rest. The sizes below are
measured, not estimated: npm run toolslist reproduces them.
SCAVIO_PLATFORMS is a comma-separated allowlist of platform keys:
| Value | Registers |
|-------|-----------|
| *(unset)* or default | Every platform 0.12.x had, plus extract — **142 tools, 112KB** |
| all | every platform — **266 tools, 253KB** |
| extract,sec,g2 | just those platforms — 18 tools, 21KB |
| default,zillow,metaads | the default set plus two more — 148 tools, 120KB |
| default,chatgpt,gemini | the default set plus ChatGPT and Gemini — 144 tools, 115KB |
| none | no platform tools, only get_usage |
Keys are matched case- and punctuation-insensitively, so meta-ads, metaads
and META_ADS are the same thing, and twitter resolves to x. An unknown key
is logged to stderr and skipped rather than failing the server.
get_usage always registers — it is free, and it is what every install guide
tells you to call to check the server works.
**Platform keys:** extract, google, chatgpt, gemini, youtube, tiktok, instagram,
reddit, x, linkedin, threads, kuaishou, amazon, walmart, ebay,
target, homedepot, costco, mercadolibre, tiktok-shop, booking, airbnb,
tripadvisor, yelp, zillow, redfin, realtor, rightmove, indeed, glassdoor,
appstore, googleplay, g2, capterra, trustpilot, googleads, metaads, sec, companieshouse
Local (stdio)
Remote (HTTP)
The hosted server has no env var to read, so pass the allowlist per connection —
either as a header or as a query parameter:
Upgrading from 0.12.x
Nothing to do. The default set is exactly the 10 platforms 0.12.x registered,