Skip to content
MCP server

Oxylabs MCP

Oxylabs MCP server for scraping, Google and Amazon search and AI-driven crawling

Pricing
Free trial
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.10.2
Listing updated
3 days ago

About Oxylabs MCP

Oxylabs MCP is an MCP server for web search and scraping. It can run locally on your machine or as a hosted remote server.

Two sets of tools sit behind one server. The Web Scraper API set covers universal_scraper for any URL with optional JavaScript rendering, geo-targeting and Markdown, HTML or link output, plus scrapers for Google Search results and for Amazon search and product pages, with optional parsing to JSON. The AI Studio set adds AI extraction to JSON, CSV, Markdown or TOON, a prompt-driven crawler, a browser agent that clicks and fills forms, web search, site URL mapping and a schema generator.

You can use Oxylabs' hosted endpoint at mcp.oxylabs.io/mcp, passing credentials as headers, or run the PyPI package locally with uv. You need either a Web Scraper API account, which has a 1-week free trial, or an AI Studio key with 1,000 free credits. The README says the server handles CAPTCHA and reaches geo-restricted data from 195+ countries, and points Web API users to a separate Web API MCP repository, while saying this one is still fully supported.

Install

Run in a terminal

claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.oxylabs.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "oxylabs-mcp": {
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "oxylabs-mcp": {
      "serverUrl": "https://mcp.oxylabs.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}

Configuration

  • OXYLABS_API_TOKENYour Oxylabs Web Scraper API token (alternative to username and password)
  • OXYLABS_USERNAMEYour Oxylabs username
  • OXYLABS_PASSWORDYour Oxylabs password
  • OXYLABS_AI_STUDIO_API_KEYYour Oxylabs AI Studio api key

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

universal_scraper
Scrape any URL with optional JavaScript rendering and geo-targeting.
google_search_scraper
Extract Google Search results, optionally parsed to JSON.
amazon_search_scraper
Scrape Amazon search result pages.
amazon_product_scraper
Extract data from Amazon product pages.
ai_scraper
AI-powered extraction in JSON, CSV, Markdown or TOON.
ai_crawler
Crawl a site from a starting URL based on a prompt.
ai_browser_agent
Control a real browser from a prompt.
ai_search
Search the web, optionally returning Markdown of each result.
ai_map
Map a website's URLs filtered by keywords or a prompt.
generate_schema
Generate a JSON schema for structured extraction.

What it does

Universal scraping
Fetch any URL with optional JavaScript rendering and geo-targeting.
Search engine scrapers
Structured results from Google Search and Amazon.
AI extraction
Pull page content as JSON, CSV, Markdown or TOON.
Prompt-driven crawler
Collect data across pages from a starting URL.
Browser agent
Navigates, clicks and fills forms from a prompt.
Hosted or local
Use the hosted endpoint or run the PyPI package.

Good for

  • Pull product data from Amazon pages into a report
  • Scrape a JavaScript-heavy page as Markdown for an agent
  • Map a website's URLs before crawling
  • Check Google results from a specific country

Pricing

Free trial, from $15 a month

Oxylabs plans from $15/mo (Starter); $5 welcome credits; 1-week API trial; AI Studio 1,000 free credits

Prices change. Check oxylabs.io before you buy.

Oxylabs MCP FAQ

What accounts do I need?

An Oxylabs Web Scraper API account, which has a 1-week free trial, or an AI Studio API key with 1,000 free credits.

Can I run it without installing anything?

Yes, through the hosted server at https://mcp.oxylabs.io/mcp with credentials in headers.

How do I run it locally?

Install the oxylabs-mcp package with uv and set your credentials in environment variables.

Which countries can it target?

The README says 195+ countries.

Is Oxylabs MCP free?

Oxylabs MCP is a paid product with a free trial. Paid plans start at $15 a month.

How do I add Oxylabs MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp

What are the best alternatives to Oxylabs MCP?

The closest alternatives to Oxylabs MCP are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

Alternatives to Oxylabs MCP

  1. MCP server for AI clients to scrape sites with HTTP and stealth browser sessions

    Runs locally
    • 17 tools
    • Open source
    • 104K GitHub stars
    • Web search and scraping
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP server for web search and page reading through a SearXNG instance

    Runs locally
    • 3 tools
    • Open source
    • 1.4K GitHub stars
    • Web search and scraping
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce