Oxylabs MCP

When to choose Oxylabs MCP

Connect to Oxylabs MCP

Choose a connection profile below and replace credential placeholders in your own MCP client. The transport describes the MCP connection.

{
  "mcpServers": {
    "oxylabs": {
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Match the task to the product before calling a tool

A suggested sequence using the documented tools. Check the connected server's tool schema before making a call.

1. Discover relevant sources

   Use google_search_scraper for a bounded search. Pick source URLs that answer the research question rather than treating a result listing as the full source.

   Tools: google_search_scraper

   Sources: Oxylabs official MCP repository

2. Retrieve and inspect page content

   Use universal_scraper for selected URLs and the required output format. Review whether rendering is needed, because target and rendering choices can affect Web Scraper API consumption.

   Tools: universal_scraper

   Sources: Oxylabs official MCP repository, Oxylabs billing explanation

3. Use AI Studio only for a matching task

   If the task needs the documented browser agent, supply the separate AI Studio credential before calling ai_browser_agent. Keep the requested interaction bounded and inspect its result.

   Tools: ai_browser_agent

   Sources: Oxylabs official MCP repository

Selected tools & example tasks

• universal_scraper

  Retrieve page content with optional rendering.

  Example task: Read a JavaScript-rendered public page.

  Sources: Oxylabs official MCP repository
• google_search_scraper

  Retrieve Google results.

  Example task: Find source pages for research.

  Sources: Oxylabs official MCP repository
• ai_browser_agent

  Run a prompted browser task with AI Studio credentials.

  Example task: Navigate and interact with a page.

  Sources: Oxylabs official MCP repository

Troubleshoot the connection

Limits & undocumented behavior

• The official repository is no longer archived (commits on 2026-10-15 added API-token auth). Oxylabs' current MCP documentation does not list this server; it points Web API users to a separate server, oxylabs/web-api-mcp. WPS has not run an authenticated connection test against the hosted endpoint.
• This setup enables Web Scraper API requests. AI Studio tools require an additional X-Oxylabs-AI-Studio-Api-Key header.
• Hosted tools may be listed without their required credentials; those calls fail until the correct product credentials are supplied.
• The reviewed tool documentation does not establish proxy purchasing or proxy account management.

Sources & review history

This listing is documentation-confirmed. We reviewed the primary sources below; this does not establish successful tool execution.

Record updated 2026-10-26. Review due 2026-11-25.

1. Oxylabs official MCP repositoryChecked 2026-09-27 · Publisher, hosted headers and token authentication, product-specific tools and MIT license
2. Oxylabs billing explanationChecked 2026-09-27 · Web Scraper API result-based billing
3. Cursor MCP configuration referenceChecked 2026-09-27 · Client JSON format and remote header support
4. Oxylabs MCP documentationChecked 2026-10-26 · Current product MCP documentation lists oxylabs-web-api-mcp for Web API, not this server

Spotted a change? Send the source and the affected setup step to our contact address.

Alternatives to Oxylabs MCP

These integrations share documented capabilities with Oxylabs MCP. Compare their setup and product requirements for your task.