Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic ${OXYLABS_MCP_TOKEN}",
        "X-Oxylabs-AI-Studio-Api-Key": "${X_OXYLABS_AI_STUDIO_API_KEY}"
      }
    }
  }
}

claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp --header "Authorization: Basic ${OXYLABS_MCP_TOKEN}" --header "X-Oxylabs-AI-Studio-Api-Key: ${X_OXYLABS_AI_STUDIO_API_KEY}"

[mcp_servers.oxylabs-mcp]
url = "https://mcp.oxylabs.io/mcp"
http_headers = { "Authorization" = "Basic ${OXYLABS_MCP_TOKEN}" }
env_http_headers = { "X-Oxylabs-AI-Studio-Api-Key" = "X_OXYLABS_AI_STUDIO_API_KEY" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "oxylabs-mcp": {
      "type": "remote",
      "url": "https://mcp.oxylabs.io/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Basic {env:OXYLABS_MCP_TOKEN}",
        "X-Oxylabs-AI-Studio-Api-Key": "{env:X_OXYLABS_AI_STUDIO_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic ${OXYLABS_MCP_TOKEN}",
        "X-Oxylabs-AI-Studio-Api-Key": "${X_OXYLABS_AI_STUDIO_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=oxylabs-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLm94eWxhYnMuaW8vbWNwIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmFzaWMgJHtPWFlMQUJTX01DUF9UT0tFTn0iLCJYLU94eWxhYnMtQUktU3R1ZGlvLUFwaS1LZXkiOiIke1hfT1hZTEFCU19BSV9TVFVESU9fQVBJX0tFWX0ifX0%3D"
}

{
  "servers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic ${OXYLABS_MCP_TOKEN}",
        "X-Oxylabs-AI-Studio-Api-Key": "${X_OXYLABS_AI_STUDIO_API_KEY}"
      }
    }
  }
}

{
  "mcpServers": {
    "oxylabs-mcp": {
      "httpUrl": "https://mcp.oxylabs.io/mcp",
      "headers": {
        "Authorization": "Basic ${OXYLABS_MCP_TOKEN}",
        "X-Oxylabs-AI-Studio-Api-Key": "${X_OXYLABS_AI_STUDIO_API_KEY}"
      }
    }
  }
}

extensions:
  "oxylabs-mcp":
    enabled: true
    name: "oxylabs-mcp"
    type: streamable_http
    uri: "https://mcp.oxylabs.io/mcp"
    headers:
      "Authorization": "Basic ${OXYLABS_MCP_TOKEN}"
      "X-Oxylabs-AI-Studio-Api-Key": "${X_OXYLABS_AI_STUDIO_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${OXYLABS_MCP_TOKEN}, ${X_OXYLABS_AI_STUDIO_API_KEY}. The registry never accepts secret values.

Quality 88 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations10 of 10 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: ai_crawler (destructiveHint, idempotentHint, openWorldHint); ai_browser_agent (destructiveHint, idempotentHint, openWorldHint); ai_map (destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 5,059 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependencies100 · weight 15

pass
deps.known_vulnsno known advisory in 80 resolved packages
pass
deps.mcp_sdk_versionmcp 2.2.0, no known advisory
pass
deps.resolvable[email protected] resolved: 80 packages

10 tools, about 5,059 tokens to load them all · tool set b3abb7b9d1d7 · checked 2026-10-19 10:52 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 97 / 100

provenance100

liveness100

freshness85

hygiene100

+repository +namespace-matches-repo +dns-namespace +website +reachable +uptime-100% ~updated-69d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI79 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://mcp.oxylabs.io/mcp` streamable-http	none	yes	100%	554 ms	2025-11-25	2026-10-19

package	registry	version	runtime	secrets
`oxylabs-mcp`	pypi	0.9.1	–	`OXYLABS_USERNAME`, `OXYLABS_PASSWORD`, `OXYLABS_AI_STUDIO_API_KEY`

Tools (10)

`ai_browser_agent`read-only	Run the browser agent and return the data in the specified format. This tool is useful if you need navigate around the website and do some actions. It allows navigating to any url, clicking on links, filling forms, scrolling, etc. Finally it returns the data in the specified format. Schema is required only if output_format is json, csv or toon. 'task_prompt' describes what browser agent should achieve
`ai_crawler`read-only	Tool useful for crawling a website from starting url and returning data in a specified format. Schema is required only if output_format is json, csv or toon. 'render_javascript' is used to render javascript heavy websites. 'return_sources_limit' is used to limit the number of sources to return, for example if you expect results from single source, you can set it to 1.
`ai_map`read-only	Tool useful for mapping website's URLs.
`ai_scraper`read-only	Scrape the contents of the web page and return the data in the specified format. Schema is required only if output_format is json or csv. 'render_javascript' is used to render javascript heavy websites.
`ai_search`read-only	Search the web based on a provided query. 'return_content' is used to return markdown content for each search result. If 'return_content' is set to True, you don't need to use ai_scraper to get the content of the search results urls, because it is already included in the search results. if 'return_content' is set to True, prefer lower 'limit' to reduce payload size.
`amazon_product_scraper`read-only	Scrape Amazon products. Supports content parsing, different user agent types, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as currency and getting more accurate pricing data with auto select variant.
`amazon_search_scraper`read-only	Scrape Amazon search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. Supports Amazon specific parameters such as category id, merchant id, currency.
`generate_schema`read-only	Generate a json schema in openapi format.
`google_search_scraper`read-only	Scrape Google Search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats.
`universal_scraper`read-only	Get a content of any webpage. Supports browser rendering, parsing of certain webpages and different output formats.

Schemas: list_tools.

Also listed as

1 other active names share this repository: ai.smithery/oxylabs-oxylabs-mcp

Similar MCP servers

Official server.json

{
  "name": "io.oxylabs/oxylabs-mcp",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp.oxylabs.io/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "HTTP Basic auth with your Oxylabs Web Scraper API username and password: 'Basic <base64(username:password)>'"
        },
        {
          "name": "X-Oxylabs-AI-Studio-Api-Key",
          "isSecret": true,
          "description": "Your Oxylabs AI Studio API key"
        }
      ]
    }
  ],
  "version": "0.9.1",
  "packages": [
    {
      "version": "0.9.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "oxylabs-mcp",
      "registryType": "pypi",
      "environmentVariables": [
        {
          "name": "OXYLABS_USERNAME",
          "format": "string",
          "isSecret": true,
          "description": "Your Oxylabs username"
        },
        {
          "name": "OXYLABS_PASSWORD",
          "format": "string",
          "isSecret": true,
          "description": "Your Oxylabs password"
        },
        {
          "name": "OXYLABS_AI_STUDIO_API_KEY",
          "format": "string",
          "isSecret": true,
          "description": "Your Oxylabs AI Studio api key"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/oxylabs/oxylabs-mcp",
    "source": "github"
  },
  "websiteUrl": "https://oxylabs.io",
  "description": "Fetch and process content from specified URLs & sources using the Oxylabs Web Scraper API."
}