# Oxylabs MCP (MCP server)

> Oxylabs MCP is an MCP server that adds web browsing tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Fetch and process content from specified URLs & sources using the Oxylabs Web Scraper API. It has 104 GitHub stars, is released under the MIT license and runs locally with uvx oxylabs-mcp.

The missing link between AI models and the real‑world web: one API that delivers clean, structured data from any site. The Oxylabs MCP server provides a bridge between AI models and the web. It enables them to scrape any URL, render JavaScript-heavy pages, extract and format content for AI use, manage CAPTCHA, and access geo-restricted web data from 195+ countries.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/oxylabs/oxylabs-mcp |
| GitHub stars | 104 |
| License | MIT |
| Language | Python |
| Transport | stdio, streamable-http |
| Packages | pypi: oxylabs-mcp |
| Remote URL | https://mcp.oxylabs.io/mcp |
| Needs API key | yes |
| Official | yes |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Web & browsing |
| Latest release | v0.10.0 (Oct 15, 2026) |
| Last commit | Oct 15, 2026 |
| MCP registry name | io.oxylabs/oxylabs-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "oxylabs-mcp": {
      "command": "uvx",
      "args": [
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "your-value",
        "OXYLABS_PASSWORD": "your-value",
        "OXYLABS_AI_STUDIO_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env OXYLABS_USERNAME=your-value --env OXYLABS_PASSWORD=your-value --env OXYLABS_AI_STUDIO_API_KEY=your-value --transport stdio oxylabs-mcp -- uvx oxylabs-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "oxylabs-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "your-value",
        "OXYLABS_PASSWORD": "your-value",
        "OXYLABS_AI_STUDIO_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "oxylabs_username",
      "description": "OXYLABS_USERNAME",
      "password": true
    },
    {
      "type": "promptString",
      "id": "oxylabs_password",
      "description": "OXYLABS_PASSWORD",
      "password": true
    },
    {
      "type": "promptString",
      "id": "oxylabs_ai_studio_api_key",
      "description": "OXYLABS_AI_STUDIO_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "oxylabs-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "oxylabs-mcp"
      ],
      "env": {
        "OXYLABS_USERNAME": "${input:oxylabs_username}",
        "OXYLABS_PASSWORD": "${input:oxylabs_password}",
        "OXYLABS_AI_STUDIO_API_KEY": "${input:oxylabs_ai_studio_api_key}"
      }
    }
  }
}
```

### Claude Code (remote)

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

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `OXYLABS_USERNAME` (secret): Your Oxylabs username
- `OXYLABS_PASSWORD` (secret): Your Oxylabs password
- `OXYLABS_AI_STUDIO_API_KEY` (secret): Your Oxylabs AI Studio api key

## Similar MCP servers

- [MCP Screenshot Website Fast](https://appsgit.com/mcp-servers/mcp-screenshot-website-fast): Quickly screenshots webpages and converts to an LLM friendly size. (110 stars, MIT)
- [Web Browser (kogiQA)](https://appsgit.com/mcp-servers/web-browser-kogiqa): This web browser has been designed to help your agent debug and develop complex web applications. (91 stars, MIT, official)
- [Scrapegraph MCP](https://appsgit.com/mcp-servers/scrapegraph-mcp): AI-powered web scraping and data extraction capabilities through ScrapeGraph API. (118 stars, MIT)
- [Supadata](https://appsgit.com/mcp-servers/supadata): Video transcripts, metadata and structured data from YouTube, TikTok, Instagram, X; web scraping. (63 stars, MIT, official, needs API key)
- [Three.js DevTools MCP](https://appsgit.com/mcp-servers/three-js-devtools-mcp): Inspect and edit Three.js scenes, materials, shaders, lights in real time from any AI agent. (128 stars, MIT)
- [Vaaya](https://appsgit.com/mcp-servers/vaaya): Paid APIs and tokenized shares for agents. (44 stars, MIT, official)

---

Canonical page: https://appsgit.com/mcp-servers/oxylabs-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.