MCP Integration
The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external tools and data sources. Scavio runs an MCP server that gives any compatible client access to 106 tools by default across Google Search, YouTube, Amazon, Walmart, Reddit, TikTok, TikTok Shop, Instagram, X, LinkedIn and Extract -- or all 191 tools across 32 platforms when you opt in. Setup takes under 2 minutes.
One server, every client
A single hosted server at https://mcp.scavio.dev/mcp gives any MCP-compatible client the full tool set -- nothing to install, just add the URL and your API key.
Introduction
Scavio's remote MCP server is a cost-effective Tavily and SerpAPI alternative that any Model Context Protocol client can connect to over Streamable HTTP. Authenticate with your API key via the x-api-key header and your assistant gains real-time search across Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram. The sections below cover setup for the most common clients -- Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, ChatGPT, Cline, Zed, and the Claude apps -- plus a universal config for anything else.
Prerequisites
- Get your API key at dashboard.scavio.dev
- Replace
YOUR_SCAVIO_API_KEY in the examples below with your actual key
Claude Code
Run this single command in your terminal:
claude mcp add --transport http scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_SCAVIO_API_KEY"
To add it to a shared project config (checked into version control), use --scope project:
claude mcp add --transport http --scope project scavio https://mcp.scavio.dev/mcp \
--header "x-api-key: YOUR_SCAVIO_API_KEY"
Alternatively, add the JSON config directly:
claude mcp add-json scavio '{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}'
Verify the connection:
claude mcp list
Claude Desktop
- Open Claude Desktop
- Go to Settings > Developer > Edit Config
- Add Scavio to your
claude_desktop_config.json:
{
"mcpServers": {
"scavio": {
"command": "npx",
"args": ["-y", "@scavio/mcp-server"],
"env": {
"SCAVIO_API_KEY": "YOUR_SCAVIO_API_KEY"
}
}
}
}
- Save and restart Claude Desktop
Requires Node.js 20+.
Config file location:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude (claude.ai and Cowork)
The Claude apps (claude.ai on web and Claude Cowork) support remote MCP servers as custom connectors:
- Go to Settings > Connectors
- Click Add custom connector
- Enter the MCP server URL:
https://mcp.scavio.dev/mcp
- Configure authentication with your API key and save
Custom connectors require a paid Claude plan and may require additional auth configuration depending on your workspace. For the terminal, use the Claude Code command above.
Cursor
- Open Cursor and go to Settings > Tools & MCP
- Click + Add New MCP Server
- Select type HTTP and enter:
- Name:
scavio
- URL:
https://mcp.scavio.dev/mcp
- Headers:
x-api-key: YOUR_SCAVIO_API_KEY
- Click Save
Or manually edit .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
- Open Windsurf and click the hammer icon in Cascade
- Click Configure to open the MCP config
- Add Scavio to
~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
- Save the file and refresh Windsurf
VS Code (GitHub Copilot)
- 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"
}
}
}
}
- Open the Command Palette (
Ctrl+Shift+P / Cmd+Shift+P)
- Run MCP: List Servers to verify the connection
For global setup, add the same config to your VS Code user settings under mcp.servers.
ChatGPT
ChatGPT supports remote MCP servers through its Apps & Connectors feature:
- Go to ChatGPT Settings > Apps & Connectors
- Click Add custom connector
- Enter the MCP server URL:
https://mcp.scavio.dev/mcp
- Configure authentication with your API key
- Save and start using Scavio tools in your chats
ChatGPT MCP support requires a Plus or Team plan and may require OAuth configuration depending on your setup.
Cline (VS Code Extension)
- Open VS Code with Cline installed
- Click the MCP Servers icon in the Cline sidebar
- Click Configure MCP Servers
- Add Scavio to the config:
{
"mcpServers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
- Save and Cline will auto-detect the new server
Zed Editor
- Open Settings (
Cmd+,)
- Navigate to the Assistant section
- Add Scavio under MCP servers:
{
"assistant": {
"mcp_servers": {
"scavio": {
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
}
}
}
Any MCP-Compatible Client
Scavio works with any tool that supports the Model Context Protocol. The universal config:
{
"type": "http",
"url": "https://mcp.scavio.dev/mcp",
"headers": {
"x-api-key": "YOUR_SCAVIO_API_KEY"
}
}
| Detail | Value |
|---|
| Transport | HTTP (Streamable HTTP) |
| URL | https://mcp.scavio.dev/mcp |
| Authentication | API key via x-api-key header |
Available Tools
Once connected, your AI assistant can use the default tool set below. Send x-scavio-platforms: all to register all 191 tools across 32 platforms, including eBay, Target, Home Depot, Zillow, Redfin, Airbnb, Booking.com, Tripadvisor, Yelp, Indeed, Glassdoor, G2, Capterra, the App Store, Google Play, SEC EDGAR, Companies House and the ad libraries.
Google Search
| Tool | Description |
|---|
search_google | Web search (v2) with organic results, ads, and AI Overview |
google_ai_mode | AI Mode conversational answer with cited sources |
google_maps_search | Search Google Maps for local businesses |
google_maps_place | Place details: address, phone, hours, rating |
google_maps_reviews | Reviews for a place with pagination |
google_shopping | Product listings with price, store, and rating |
google_shopping_product | Product detail and sellers |
google_shopping_stores | More sellers for a product (pagination) |
google_flights | Flight itineraries with prices and stops |
google_hotels | Hotel search with prices and ratings |
google_hotels_detail | Hotel property details |
google_news | News results by query, topic, story, or publication |
google_trends | Interest-over-time and related queries |
google_trending | Trending searches |
YouTube
| Tool | Description |
|---|
search_youtube | Search videos, channels, and playlists |
get_youtube_metadata | Get video metadata (title, views, likes, duration) |
get_youtube_channel | Get a YouTube channel's profile as JSON |
get_youtube_channel_community | List a YouTube channel's community posts as JSON, under data.posts (the only YouTube endpoint whose list key is not results) |
get_youtube_channel_shorts | List a YouTube channel's Shorts as JSON |
get_youtube_channel_videos | List a YouTube channel's videos as JSON |
get_youtube_comment_replies | Get replies to a specific YouTube comment as JSON |
get_youtube_comments | Get comments on a YouTube video as JSON |
get_youtube_related | Get videos related to a YouTube video as JSON |
get_youtube_streams | Get direct media stream URLs for a YouTube video as JSON |
get_youtube_transcript | Get the transcript of a YouTube video as JSON |
get_youtube_video | Get full details for a YouTube video as JSON |
resolve_youtube_channel | Resolve a YouTube @handle or channel URL to its canonical channel ID and URL, returned as JSON |
search_youtube_channels | Search YouTube channels by keyword as JSON |
search_youtube_shorts | Search YouTube Shorts and return short-form video results as JSON |
youtube_search_suggestions | Get YouTube search autocomplete suggestions for a partial query as JSON |
Amazon
| Tool | Description |
|---|
search_amazon | Search product listings across 22 marketplaces. Results are unordered: the marketplace ignores every sort value, so there is no sort, category, merchant or price filter |
get_amazon_product | Get full product details by ASIN |
get_amazon_offers | List every seller offer on an ASIN, including who holds the buy box |
get_amazon_options | List the Amazon marketplaces the API supports, as JSON |
Walmart
| Tool | Description |
|---|
search_walmart | Search product listings with price and delivery filters |
get_walmart_product | Get full product details by product ID |
get_walmart_category | Browse the products inside a Walmart category as JSON, without a search query |
get_walmart_offers | Get the BUY-BOX offer for a Walmart product as JSON โ which seller currently wins the listing, at what price |
get_walmart_reviews | Get customer reviews for a Walmart product as JSON |
get_walmart_seller | Get a Walmart marketplace seller's storefront as JSON |
get_walmart_seller_products | List the products a Walmart marketplace seller sells, as JSON |
TikTok
| Tool | Description |
|---|
get_tiktok_profile | Get user profile (bio, follower/following counts, likes) |
get_tiktok_user_posts | List a user's videos with stats |
get_tiktok_video | Get detailed info for a single video |
get_tiktok_video_comments | Get comments on a video |
get_tiktok_comment_replies | Get replies to a specific comment |
search_tiktok_videos | Search videos by keyword |
search_tiktok_users | Search users by keyword |
get_tiktok_hashtag | Get hashtag details and stats |
get_tiktok_hashtag_videos | List videos for a hashtag |
get_tiktok_user_followers | Get a user's follower list |
get_tiktok_user_followings | Get a user's following list |
Instagram
| Tool | Description |
|---|
get_instagram_profile | Get user profile (bio, follower/following/post counts) |
get_instagram_user_posts | List a user's posts with pagination |
get_instagram_user_reels | List a user's Reels with pagination |
get_instagram_user_tagged | List posts a user is tagged in |
get_instagram_user_stories | Get a user's active stories |
get_instagram_post | Get a single post by URL, media_id, or shortcode |
get_instagram_post_comments | Get comments on a post |
get_instagram_comment_replies | Get replies to a specific comment |
search_instagram_users | Search users by keyword |
search_instagram_hashtags | Search hashtags by keyword |
get_instagram_user_followers | Get a user's follower list |
get_instagram_user_followings | Get a user's following list |
Reddit
| Tool | Description |
|---|
search_reddit | Search posts by query with sort and pagination |
get_reddit_post | Get a full post with threaded comments by URL |
get_reddit_comment_replies | Get the replies to a specific Reddit comment as JSON |
get_reddit_popular | Get the site-wide popular feed as JSON |
get_reddit_post_comments | Get the top-level comments for a Reddit post as JSON |
get_reddit_search_suggestions | Get Reddit search autocomplete suggestions for a query as JSON |
get_reddit_subreddit | Get metadata for a subreddit as JSON, including its name, title, description, subscriber count, type, NSFW flag, icon, banner, primary color, and creation date |
get_reddit_subreddit_posts | List a subreddit's post feed as JSON |
get_reddit_trending | Get Reddit's current trending search queries as JSON |
get_reddit_user | Get a redditor's profile as JSON, including their ID, name, employee/verified flags, account type, and whether they accept private messages |
get_reddit_user_comments | List a redditor's comments as JSON |
get_reddit_user_posts | List a redditor's submitted posts as JSON |
X (Twitter)
| Tool | Description |
|---|
search_x | Search X posts by keyword, with cursor pagination |
get_tweet | Full detail for a single post |
get_tweet_comments | Replies to a post |
get_tweet_retweeters | Accounts that reposted a post |
get_x_user | Profile: bio, follower and following counts, verified status |
get_x_user_tweets | A user's posts timeline |
get_x_user_replies | A user's replies timeline |
get_x_user_media | A user's photo and video posts |
get_x_user_followers | Who follows this account |
get_x_user_followings | Who this account follows |
get_x_trending | Current trending topics |
LinkedIn
| Tool | Description |
|---|
get_linkedin_person | Person profile: headline, location, experience (1 credit) |
get_linkedin_person_about | A person's about section (1 credit) |
get_linkedin_person_posts | A person's posts (10 credits) |
get_linkedin_company | Company profile, including a sample of featured employees (1 credit) |
get_linkedin_company_posts | A company's posts (10 credits) |
search_linkedin_jobs | Search job listings by keyword and location (10 credits) |
get_linkedin_job | Full detail for one job listing (30 credits) |
get_linkedin_post | A single post (1 credit) |
get_linkedin_post_comments | Comments on a post (10 credits) |
TikTok Shop
| Tool | Description |
|---|
search_tiktok_shop | Search the product catalog, with exact prices |
get_tiktok_shop_search_suggestions | Keyword autocomplete and expansion |
get_tiktok_shop_product | Full product detail (no price -- take price from a listing call) |
get_tiktok_shop_product_reviews | Paginated reviews with a star histogram |
get_tiktok_shop_categories | The global category tree |
get_tiktok_shop_category_products | Products in a category, with exact prices |
get_tiktok_shop_shop_products | A seller's catalog, with exact prices |
resolve_tiktok_shop_url | Resolve any TikTok Shop link to a product or shop id |
Extract (any URL)
| Tool | Description |
|---|
extract_url | Read any web page |
eBay
| Tool | Description |
|---|
get_ebay_product | Get one eBay listing in full as JSON |
get_ebay_seller | Get an eBay seller's profile card as JSON |
search_ebay | Search live or SOLD eBay listings and return them as JSON |
Target
| Tool | Description |
|---|
get_target_category | List the products inside one Target category as JSON |
get_target_product | Get one product's full detail by TCIN as JSON |
get_target_reviews | Get a product's reviews by TCIN as JSON |
search_target_products | Search its catalogue by keyword and return the product grid as JSON |
Home Depot
| Tool | Description |
|---|
get_home_depot_product | Get one Home Depot item in full as JSON |
get_home_depot_reviews | Get one page of Home Depot reviews for an item as JSON |
search_home_depot | Search Home Depot and return the product grid as JSON |
Booking.com
| Tool | Description |
|---|
get_booking_hotel | Get one Booking.com property in full as JSON |
get_booking_reviews | Get Booking.com guest reviews for one property as JSON, with the score breakdown by category (staff, cleanliness, value, location, comfort, facilities) and Booking's own summary of what guests praised and complained about |
search_booking | Search Booking.com for hotels, apartments, hostels, resorts and other stays in a destination, as JSON |
Airbnb
| Tool | Description |
|---|
get_airbnb_listing | Get one Airbnb listing in full as JSON |
get_airbnb_reviews | Get Airbnb review BODIES for one listing as JSON |
search_airbnb | Search Airbnb stays in a location as JSON |
Tripadvisor
| Tool | Description |
|---|
get_tripadvisor_location | Get one Tripadvisor restaurant, hotel or attraction in full as JSON |
get_tripadvisor_reviews | Get a page of Tripadvisor reviews for one location as JSON |
resolve_tripadvisor_location | START HERE for Tripadvisor |
search_tripadvisor | List the restaurants, hotels or attractions in a Tripadvisor geo, in Tripadvisor's own ranked order, as JSON |
Yelp
| Tool | Description |
|---|
get_yelp_business | Get one Yelp business in full as JSON |
get_yelp_reviews | Get a page of Yelp reviews for one business as JSON |
search_yelp | Search Yelp for local businesses and return them in Yelp's own ranked order as JSON |
Indeed
| Tool | Description |
|---|
get_indeed_company | Get an Indeed employer profile as JSON |
get_indeed_company_reviews | Get Indeed EMPLOYEE reviews for a company as JSON |
get_indeed_job | Get one Indeed job posting in full as JSON |
search_indeed_jobs | Search Indeed job postings as JSON |
Glassdoor
| Tool | Description |
|---|
get_glassdoor_company | Get a Glassdoor employer profile as JSON |
get_glassdoor_reviews | Get Glassdoor employee reviews for one employer as JSON |
get_glassdoor_salaries | Get Glassdoor salary data for one employer as JSON, broken down by job title |
resolve_glassdoor_company | START HERE for Glassdoor |
Zillow
| Tool | Description |
|---|
get_zillow_agent_reviews | Get a Zillow real-estate AGENT's profile and their reviews as JSON |
get_zillow_property | Get one Zillow listing in full as JSON |
search_zillow | Search Zillow for US real-estate listings in a region and return them as JSON |
Redfin
| Tool | Description |
|---|
get_redfin_market | Get Redfin housing-market statistics for a US region as JSON |
get_redfin_property | Get one Redfin listing (US residential real estate) in full as JSON |
search_redfin | Search Redfin, the US residential real-estate marketplace, and return listings as JSON |
Apple App Store
| Tool | Description |
|---|
get_app_store_app | Get one Apple App Store listing in full as JSON |
get_app_store_reviews | Get a page of Apple App Store customer reviews as JSON |
search_app_store | Search Apple's App Store (iPhone, iPad and Mac apps) and return up to 200 fully-shaped app rows as JSON - the same 43-field row get_app_store_app returns, so this doubles as a bulk metadata fetch |
Google Play
| Tool | Description |
|---|
get_google_play_app | Get one Google Play (Android app store) listing in full as JSON |
get_google_play_reviews | Get a page of Google Play (Android app store) reviews as JSON |
search_google_play | Search Google Play, the Android app store (NOT Google web search), and return ranked apps as JSON |
G2
| Tool | Description |
|---|
get_g2_product | G2, the B2B software review site |
get_g2_reviews | G2, the B2B software review site |
search_g2_software | G2, the B2B software review site |
Capterra
| Tool | Description |
|---|
get_capterra_product | Capterra, the B2B software review site |
get_capterra_reviews | Capterra, the B2B software review site |
search_capterra_software | Capterra, the B2B software review site |
SEC EDGAR
| Tool | Description |
|---|
get_sec_company | Get a US SEC EDGAR filer's profile as JSON |
get_sec_concept | Get every value a US SEC EDGAR filer reported for one XBRL financial concept as JSON, newest period first, with the form and filing each number came from |
get_sec_facts | Get the index of every XBRL concept a US SEC EDGAR filer reports as JSON - tag, label, description, units and most recent value - across us-gaap, dei and any other taxonomy it uses |
get_sec_filings | List one US SEC EDGAR filer's filings as JSON |
resolve_sec_company | START HERE for SEC EDGAR, the US Securities and Exchange Commission's public filing system |
search_sec_filings | Full-text search across US SEC EDGAR filing DOCUMENTS |
UK Companies House
| Tool | Description |
|---|
get_companies_house_company | Get a UK company's full entry on the Companies House register as JSON |
get_companies_house_filing_history | List a UK company's filings from the Companies House register as JSON, most recent first |
get_companies_house_officers | List a UK company's officers, current and resigned, from the Companies House register as JSON |
search_companies_house | START HERE for Companies House, the official UK company register |
Google Ads Transparency
| Tool | Description |
|---|
get_google_ads_creative | The public record of ads running on Google Search, YouTube, Maps, Play and Shopping |
resolve_google_ads_advertiser | The public record of ads running on Google Search, YouTube, Maps, Play and Shopping |
search_google_ads | The public record of ads running on Google Search, YouTube, Maps, Play and Shopping |
Meta Ad Library
| Tool | Description |
|---|
get_meta_ad | Every ad running on Facebook and Instagram, public and logged-out |
get_meta_ads_advertiser | Every ad running on Facebook and Instagram, public and logged-out |
search_meta_ads | Every ad running on Facebook and Instagram, public and logged-out |
Threads
| Tool | Description |
|---|
get_threads_post | Get a single Threads post by its id or its threads.net URL, as JSON |
get_threads_post_comments | List the replies to a Threads post as JSON |
get_threads_profile | Get a Threads (Meta's text app, threads.net) user profile as JSON |
get_threads_user_posts | List a Threads user's own posts as JSON |
get_threads_user_replies | List the replies a Threads user has written to other people's posts, as JSON โ the "Replies" tab of their profile, not their own posts (use get_threads_user_posts for those) |
search_threads_users | Search Threads PROFILES by name or handle, as JSON |
Kuaishou
| Tool | Description |
|---|
get_kuaishou_comment_replies | Expand one comment thread on a Kuaishou (China) video |
get_kuaishou_profile | Get the full profile of a Kuaishou (China) creator by user id as JSON |
get_kuaishou_tag_feed | Read the feed behind a Kuaishou (China) hashtag as JSON, 20 posts a page |
get_kuaishou_trending | One board per call, and each call bills |
get_kuaishou_user_live | Check whether one Kuaishou (China) creator is broadcasting right now, as JSON |
get_kuaishou_user_posts | List a Kuaishou (China) creator's top posts as JSON, under data.feeds[] |
get_kuaishou_video | Get one Kuaishou (China) video by photo id or URL as JSON |
get_kuaishou_video_comments | Get the comment thread under a Kuaishou (China) video as JSON, 30 root comments per page |
get_kuaishou_videos_batch | Look up as many as 20 Kuaishou (China) videos in ONE request as JSON, under data.photos[] |
resolve_kuaishou_user | Turn a Kuaishou (China) share link into the user id that get_kuaishou_profile, get_kuaishou_user_posts and get_kuaishou_user_live all require |
search_kuaishou | Run Kuaishou (China)'s own MIXED search for a keyword as JSON |
search_kuaishou_live | Search Kuaishou (China) live streams that are ON AIR RIGHT NOW for a keyword, as JSON |
search_kuaishou_users | Find Kuaishou (China) creators by name, handle or topic as JSON, 20 accounts a page |
search_kuaishou_videos | Search Kuaishou (China) videos by keyword as JSON, 20 ranked results a page |
Account
| Tool | Description |
|---|
get_usage | Check your credit balance, plan, and usage stats |
Troubleshooting
Server not connecting?
- Verify your API key is correct and active
- Check your credits with
get_usage or at dashboard.scavio.dev
- Ensure the URL is exactly
https://mcp.scavio.dev/mcp (no trailing slash)
Tools not showing up?
- Restart your AI client after adding the config
- Check for JSON syntax errors in your config file
- Confirm the MCP server appears as "connected" in your client's MCP settings
Benefits of Scavio + MCP
- Universal: works with any MCP-compatible client, from Claude Code to ChatGPT.
- Comprehensive: 191 tools spanning Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram.
- Zero install: a hosted remote server over Streamable HTTP -- just add the URL, no packages to manage.
- Secure: authenticate with your API key via the
x-api-key header; the model never handles credentials.
Next Steps