# Oxylabs MCP > Lets your agent scrape any URL, search Google and Amazon, and crawl or browse sites through Oxylabs, getting clean Markdown or data back. Oxylabs' own MCP server for its Web Scraper API and AI Studio. Your agent can scrape any URL, including JavaScript-heavy pages, with geo-targeting and rotating IPs from Oxylabs' proxy network, and get the content back as clean Markdown or structured data. It has two sets of tools that work together or on their own. What you can do with it - Scrape any URL, with optional JavaScript rendering, geo-targeting and Markdown, HTML or links output (Web Scraper API) - Get Google Search results, parsed into structured JSON if you want (Web Scraper API) - Scrape Amazon search results and product pages (Web Scraper API) - Extract content from any page with AI, as JSON, CSV, Markdown or TOON (AI Studio) - Crawl a site from a starting URL, following a prompt, and collect data across its pages (AI Studio) - Have a real browser follow a prompt: navigate, click and fill in forms, then return the result (AI Studio) - Search the web, map a site's URLs, and generate a JSON schema for structured extraction (AI Studio) How it connects Oxylabs hosts it at https://mcp.oxylabs.io/mcp, and you pass your credentials as request headers: your Web Scraper API token as a Bearer token (or your username and password with HTTP Basic auth), and your AI Studio key in X-Oxylabs-AI-Studio-Api-Key. You can also run it on your own computer from PyPI with uvx, setting OXYLABS_USERNAME and OXYLABS_PASSWORD for the scraper tools and OXYLABS_AI_STUDIO_API_KEY for the AI tools (newer versions also take OXYLABS_API_TOKEN). Good to know - You need at least one of the two: a Web Scraper API account (there's a one-week free trial) or an AI Studio API key (it comes with free credits). - Every tool is listed whatever you set up; a tool you have no credentials for returns an error saying what to add. Only set the credentials you really have, since placeholder values make calls fail. - The hosted server takes keys only as headers, so agents that can only connect remote servers with OAuth sign-in, such as custom connectors on claude.ai, can't use it yet. Oxylabs says OAuth sign-in is on its roadmap; until then, run it locally, for example in Claude Desktop. - It's open source under the MIT licence. - Type: Plugin - Made by: Oxylabs - Category: Web & browser - Formats: Remote MCP, Local MCP - Version: 0.9.1 - Website: https://oxylabs.io/ - Source: https://github.com/oxylabs/oxylabs-mcp - Page: https://pluginboard.ai/plugins/oxylabs-mcp ## Works with - ChatGPT - Claude - Muse - Grok Bot - Gemini - Grok - GitHub Copilot - Cursor - Claude Code - Codex - Antigravity - Gemini CLI - Replit - OpenClaw - OpenCode - Hermes Agent ## Install You'll need: - `Authorization` (optional): HTTP Basic auth with your Oxylabs Web Scraper API username and password: 'Basic ' - `X-Oxylabs-AI-Studio-Api-Key` (optional): Your Oxylabs AI Studio API key Replace each `` placeholder with your own value. ### ChatGPT In ChatGPT on the web: Plugins → + → Add custom MCP server, then paste https://mcp.oxylabs.io/mcp under Connection. Business and Enterprise plans; Pro can add read-only servers. ### Claude In Claude (web or desktop): Customize → Connectors → Add custom connector, then paste https://mcp.oxylabs.io/mcp ### Muse In Muse: In a Muse chat, ask it to create a custom connector for the MCP server at https://mcp.oxylabs.io/mcp. Then tap Connect on the card it shows and sign in, or add your key. ### Grok Bot In Grok Bot: In a chat with your Bot, say "Add this MCP server: https://mcp.oxylabs.io/mcp". It confirms the details with you and sets it up, and the tools are ready from your next message. ### Gemini In Gemini: At gemini.google.com: Settings → Connected Apps → Add a custom app, then paste https://mcp.oxylabs.io/mcp ### Grok In Grok on the web: At grok.com/connectors: New Connector → Custom, then enter https://mcp.oxylabs.io/mcp and sign in if it asks. ### GitHub Copilot Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22oxylabs-mcp%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.oxylabs.io%2Fmcp%22%7D Copilot CLI: ```shell copilot mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp ``` ### Cursor Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=oxylabs-mcp&config=eyJ1cmwiOiJodHRwczovL21jcC5veHlsYWJzLmlvL21jcCJ9 Add to .cursor/mcp.json: ```json { "mcpServers": { "oxylabs-mcp": { "url": "https://mcp.oxylabs.io/mcp" } } } ``` ### Claude Code Run in your terminal: ```shell claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp ``` ### Codex Run in your terminal: ```shell codex mcp add oxylabs-mcp --url https://mcp.oxylabs.io/mcp ``` ### Antigravity Add to ~/.gemini/config/mcp_config.json: ```json { "mcpServers": { "oxylabs-mcp": { "url": "https://mcp.oxylabs.io/mcp" } } } ``` ### Gemini CLI Run in your terminal: ```shell gemini mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp ``` ### Replit In Replit: At replit.com/integrations, open MCP Servers → + Add MCP server, paste https://mcp.oxylabs.io/mcp (add any headers under Advanced settings), then click Test & save. ### OpenClaw Run in your terminal: ```shell openclaw mcp add oxylabs-mcp --url https://mcp.oxylabs.io/mcp --transport streamable-http ``` If it needs a key or sign-in: For https://mcp.oxylabs.io/mcp, add --header NAME=value for each header it needs, or --auth oauth and then run openclaw mcp login oxylabs-mcp. ### OpenCode Run in your terminal: ```shell opencode mcp add oxylabs-mcp --url https://mcp.oxylabs.io/mcp ``` If it needs a key: For https://mcp.oxylabs.io/mcp, add --header 'NAME=value' for each header it needs. Add --global to use it in every project. ### Hermes Agent Run in your terminal: ```shell hermes mcp add oxylabs-mcp --url https://mcp.oxylabs.io/mcp ``` Add to ~/.hermes/config.yaml: ```json { "mcp_servers": { "oxylabs-mcp": { "url": "https://mcp.oxylabs.io/mcp" } } } ``` If it signs in with OAuth: If https://mcp.oxylabs.io/mcp asks you to sign in, add --auth oauth to the command, or auth: oauth to its entry. --- From Pluginboard (https://pluginboard.ai).