Scavio MCP Server

Scavio MCP Server

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. 191 tools across 31 platforms plus Extract, one API key.

The 22 platforms added in 0.13.0 are opt-in. Registering all 191 tools puts 262KB of tool definitions — roughly 70k tokens — into every session before you type anything. So the default is the surface 0.12.x already had, plus Extract: 106 tools, 102KB. 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:

https://mcp.scavio.dev/mcp

Pass your API key via 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

claude mcp add scavio -e SCAVIO_API_KEY=YOUR_SCAVIO_API_KEY -- npx -y @scavio/mcp-server

Any MCP-Compatible Client (Claude Desktop, Cursor, Windsurf, VS Code, etc.)

{
  "mcpServers": {
    "scavio": {
      "command": "npx",
      "args": ["-y", "@scavio/mcp-server"],
      "env": {
        "SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Requires Node.js 20+. Get your API key at scavio.dev.

---

Install

Claude Code

claude mcp add scavio --transport http --url https://mcp.scavio.dev/mcp --header "x-api-key: YOUR_SCAVIO_API_KEY"

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "scavio": {
      "command": "npx",
      "args": ["-y", "@scavio/mcp-server"],
      "env": {
        "SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

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:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

VS Code

Create .vscode/mcp.json in your project root:

{
  "servers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

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):

{
  "mcpServers": {
    "scavio": {
      "type": "http",
      "url": "https://mcp.scavio.dev/mcp",
      "headers": {
        "x-api-key": "YOUR_SCAVIO_API_KEY"
      }
    }
  }
}

Zed

Add to settings (Cmd+,):

{
  "assistant": {
    "mcp_servers": {
      "scavio": {
        "type": "http",
        "url": "https://mcp.scavio.dev/mcp",
        "headers": {
          "x-api-key": "YOUR_SCAVIO_API_KEY"
        }
      }
    }
  }
}

Any MCP-Compatible Client

{
  "type": "http",
  "url": "https://mcp.scavio.dev/mcp",
  "headers": {
    "x-api-key": "YOUR_SCAVIO_API_KEY"
  }
}

---

Choosing which tools load

Scavio exposes 191 tools. Loading all of them costs 262KB of tools/list — roughly 70k 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:

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, youtube, tiktok, instagram, reddit, x, linkedin, threads, kuaishou, amazon, walmart, ebay, target, homedepot, tiktok-shop, booking, airbnb, tripadvisor, yelp, zillow, redfin, indeed, glassdoor, appstore, googleplay, g2, capterra, googleads, metaads, sec, companieshouse

Local (stdio)

{
  "mcpServers": {
    "scavio": {
      "command": "npx",
      "args": ["-y", "@scavio/mcp-server"],
      "env": {
        "SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY",
        "SCAVIO_PLATFORMS": "extract,google,zillow,redfin"
      }
    }
  }
}

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:

{
  "scavio": {
    "type": "http",
    "url": "https://mcp.scavio.dev/mcp",
    "headers": {
      "x-api-key": "YOUR_SCAVIO_API_KEY",
      "x-scavio-platforms": "extract,google,sec,companieshouse"
    }
  }
}

https://mcp.scavio.dev/mcp?platforms=all

Upgrading from 0.12.x

Nothing to do. The default set is exactly the 10 platforms 0.12.x registered, plus Extract — every tool you were using still loads, and the context cost is unchanged. Walmart grew from 2 tools to 7, so the count moves 100 → 106.

The 22 platforms added in 0.13.0 are opt-in. Add them additively:

SCAVIO_PLATFORMS=default,zillow,redfin,sec

One breaking fix worth knowing: search_walmart previously sent fulfillment_speed: "anytime" on every call, which the API rejects. The parameter is now today or tomorrow with no default.

---

Available Tools

Every tool costs 1 credit per call unless its section says otherwise. Several platforms price per endpoint (YouTube, Instagram, LinkedIn, Kuaishou) or per request body (Extract, Threads, Walmart); get_amazon_options and get_usage are free.

Extract

Extract is tier-priced by the mode parameter, not flat: normal (plain fetch) and advanced (full JavaScript rendering) cost 1 credit, ultra (residential proxy, for hard bot walls) costs 2. Start at normal and escalate only when the content comes back empty or blocked. You are billed only on a successful extraction — a dead link, a bot wall or a timeout costs nothing. There is no pagination: the whole page comes back in one call.

Google Search API

YouTube Data API

Credit cost varies: get_youtube_transcript costs 8, get_youtube_streams 3, search_youtube and search_youtube_shorts 2, and every other YouTube tool 1. get_youtube_related accepts a cursor but never returns one, so treat it as a single page.

Amazon Product API

Walmart API

Walmart is priced by the domain parameter, not at a flat rate: com (US, default) and ca cost 1 credit, com.mx costs 2. Only search_walmart and get_walmart_category accept domain, so only those two can cost 2 — the other five are always 1. The id-keyed tools are US-only, because walmart.ca product pages cannot be fetched.

Two shapes to plan for. get_walmart_offers returns the buy-box winner only — Walmart server-renders just that one offer, so expect a single row even when total_offer_count is higher. And get_walmart_seller_products is capped at roughly the first 40 items with no page or cursor parameter; read total_count to know you are looking at a slice. Both seller tools need the NUMERIC seller_catalog_id from a product, search or offers response — the GUID-form seller_id in those same responses 404s.

TikTok API

Instagram API

Instagram is priced per endpoint, not at a flat rate: get_instagram_user_posts costs 2, get_instagram_post and get_instagram_comment_replies cost 8, and the other nine tools cost 10. The 10-credit endpoints hedge two upstream providers and bill both legs, which is what the price reflects.

Reddit API

Every Reddit tool costs 1 credit. Two things to know: search_reddit takes a query and a cursor only - there is no sort or post-type filter, results come back in relevance order - and get_reddit_post returns a flat post object with no comments, so call get_reddit_post_comments with the post id for those. Reddit is the slowest platform here, typically 5-15 seconds per call.

X API

get_x_user_tweets, get_x_user_replies and get_x_user_media return a next_cursor but no has_more, so page until the cursor is absent or the timeline comes back empty.

LinkedIn API

All take a vanity handle, slug or id, or a full LinkedIn URL. Credit cost varies: get_linkedin_person, get_linkedin_person_about, get_linkedin_company and get_linkedin_post cost 1; get_linkedin_person_posts, get_linkedin_company_posts, search_linkedin_jobs and get_linkedin_post_comments cost 10 per page; get_linkedin_job costs 30.

The upstream provider retired the datasets behind member contact info, the company employee directory, per-company job listings, people search and post search, so those five tools were removed. get_linkedin_company still returns a small sample of featured employees, and search_linkedin_jobs with a company name substitutes for per-company listings.

TikTok Shop API

Two things to know: get_tiktok_shop_product does not return a price (TikTok masks it on the product page upstream) - exact prices come from search_tiktok_shop, get_tiktok_shop_shop_products and get_tiktok_shop_category_products. And only about 44% of the product IDs returned by search resolve on get_tiktok_shop_product (11 of 25 measured), because upstream has no detail data for the rest. That miss is signalled by the HTTP 404 status, not by any field in the response body, and it is a normal outcome rather than an error to retry - the tool returns it as a plain result with status: "no_detail_data" so agents skip the product instead of looping. For an id that will not resolve, get_tiktok_shop_product_reviews is often still usable: across 8 measured ids that failed on detail, 8 of 8 returned HTTP 200 on reviews and 7 of 8 returned at least one review.

Threads

Threads is priced by how you address a user, not per endpoint: 2 credits when you pass user_id, 4 credits when you pass username. Only get_threads_profile, get_threads_user_posts and get_threads_user_replies accept a username; the other three are always 2. Prefer user_id - a handle buys a second upstream lookup.

Kuaishou (China)

Kuaishou is priced per endpoint, not at a flat rate: get_kuaishou_profile and all four search tools cost 10, get_kuaishou_video 2, get_kuaishou_videos_batch 40, and every other tool 1.

eBay

1 credit per call. get_ebay_seller is a profile card and cannot enumerate a catalogue - list a seller's inventory with search_ebay and seller set and no keyword. sold: true searches completed listings that actually sold; on that view eBay publishes no headline count, so total_results is null. per_page accepts only 60, 120 or 240.

Target

1 credit per call. get_target_product and get_target_reviews are single-shot; search and category page with page + count.

Home Depot

2 credits per call. Search page size is fixed at 12 and cannot be changed. Reviews return 30 per page; total_pages is the last page that exists and asking past it is a 404.

Booking.com

1 credit per call. Search returns 25 properties per page; get_booking_hotel and get_booking_reviews are single-shot.

Airbnb

1 credit per call. search_airbnb takes page XOR cursor - sending both is rejected, and cursor wins. 18 listings per page. get_airbnb_reviews pages with limit + offset.

Tripadvisor

2 credits per call. Start with resolve_tripadvisor_location for the geo_id / location_id pair everything else needs. Search returns 30 per page and a page past the last is a 404, not an empty result. Reviews return 15 per page for restaurants and 10 for hotels and attractions, so category must match the location's own type on any page past the first.

Yelp

2 credits per call. Yelp fixes the page size at 10. get_yelp_business already includes the first page of reviews at no extra cost. A review page past the last is a 404, not an empty result.

Zillow

1 credit per call. Only search_zillow paginates. get_zillow_agent_reviews is an AGENT profile, not a property.

Redfin

1 credit per call. search_redfin pages with page + limit, up to 350 listings per page; the other two are single-shot.

Indeed

2 credits per call. Job search returns 10 postings per page, company reviews 20 per page. get_indeed_job and get_indeed_company are single-shot.

Glassdoor

1 credit per call. Start with resolve_glassdoor_company for the employer_id. Only get_glassdoor_salaries paginates (10 job titles per page; page_count is how many exist). get_glassdoor_reviews returns up to three full reviews plus complete rating statistics - it is not a paginated review feed.

Apple App Store

1 credit per call. Reviews page 1-10 at 50 per page and stop hard at page 10: 500 reviews per storefront is Apple's anonymous ceiling, and you reach further by asking a different country. Search and app detail do not paginate.

Google Play

2 credits per call - a separate namespace from google and not on the Google-exempt price. Reviews are cursor-paginated, and the cursor is opaque, single-use and encodes the sort as well as the position, so send it back with the same sort it came from. A cursor past the last review is a 404. Search and app detail do not paginate.

G2 Software Reviews

5 credits per call - the most expensive platform on Scavio. search_g2_software pages with page + limit (capped at 100 on our side); get_g2_reviews is fixed at 10 per page and paginates well past the 10 pages G2's own widget links to. get_g2_product is single-shot.

Capterra Software Reviews

2 credits per call. Only get_capterra_reviews paginates: 25 per page, capped at page 100 - past it Capterra answers 200 with page one, so check what came back. get_capterra_product already includes the 25 most recent reviews.

Google Ads Transparency

1 credit per call. Start with resolve_google_ads_advertiser to turn a brand name or domain into an advertiser_id. search_google_ads is cursor-paginated at 100 ads per page - re-send the same filters alongside the cursor. get_google_ads_creative is the only tool carrying a creative's history, region breakdown and impression bucket.

Meta Ad Library

1 credit per call, and every cursor page is another credit: page 1 returns 30 ads, then 10 per page thereafter, so the cost of walking a whole query scales with depth. search_meta_ads and get_meta_ads_advertiser both cursor-paginate - walk has_next_page. get_meta_ad is single-shot.

SEC EDGAR

1 credit per call on the official free EDGAR JSON API. Start with resolve_sec_company to turn a name or ticker into a CIK. get_sec_filings pages with page + limit; search_sec_filings pages up to 100, because the index refuses a result window past 10,000.

Companies House

1 credit per call on the official UK register. Start with search_companies_house for a company_number. Search returns 20 per page and is capped at page 50 - the register serves a 1000-result window per term whatever hit count it prints, then answers page 51 with a 416. Officers (35/page) and filing history have no upper page bound; past the last page they return an ordinary 200 with an empty list, which looks identical to having none.

Account

---

About Scavio

Scavio is a unified search API for AI agents and a data API for developers. One key, structured JSON, no scraping or proxies:

• Google Search API — SERP results, news, images, maps, and knowledge graph
• Extract — read any URL as Markdown, plain text or raw HTML
• Amazon Product API and Walmart Product API — product search and details, alongside eBay, Target and Home Depot
• TikTok API, Instagram API, Reddit API, X API, LinkedIn API, and YouTube API — social and video data
• Travel and local — Booking.com, Airbnb, Tripadvisor, Yelp
• Real estate — Zillow, Redfin
• Jobs and employer data — Indeed, Glassdoor
• Apps, software reviews and ad libraries — App Store, Google Play, G2, Capterra, Google Ads Transparency, Meta Ad Library
• Company filings — SEC EDGAR, Companies House

Teams use it as a SerpAPI alternative with structured multi-platform data — see Tavily vs Scavio for a head-to-head comparison.

Get a free Search API key at scavio.dev.

---

License

MIT