How to Connect Oxylabs Remote MCP to Claude Code
Add Oxylabs's remote MCP server to Claude Code in about a minute.
Step-by-step
- Run the add command
claude mcp add --transport http oxylabshttps://mcp.oxylabs.io/mcp``. - AuthorizeNo authentication needed โ Oxylabs is public. Run
/mcpinside Claude Code to trigger the OAuth flow. - Verify statusRun
claude mcp listโ the server should show as connected. If the OAuth callback never completes, remove it withclaude mcp remove oxylabs, re-add, and make sure the browser can reach the callback URL. Verify in the browser: pastehttps://mcp.oxylabs.io/mcpinto remotemcp.net/inspector and run initialize + tools/list.
Troubleshooting OAuth / 401
- A
401 Unauthorizedon first connect is normal โ the endpoint is OAuth-protected; let Claude Code finish the browser consent flow. - If the consent window never opens, remove and re-add the server, then retry.
- Check the exact challenge at our OAuth debugger.
- Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"oxylabs": {
"url": "https://mcp.oxylabs.io/mcp"
}
}
}claude mcp add --transport http oxylabs https://mcp.oxylabs.io/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"oxylabs": {
"type": "http",
"url": "https://mcp.oxylabs.io/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.oxylabs.io/mcp - No authentication needed โ tools are available immediately.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"oxylabs": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.oxylabs.io/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"oxylabs": {
"serverUrl": "https://mcp.oxylabs.io/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"oxylabs": {
"url": "https://mcp.oxylabs.io/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.oxylabs] url = "https://mcp.oxylabs.io/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"oxylabs": {
"type": "streamableHttp",
"url": "https://mcp.oxylabs.io/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"oxylabs": {
"httpUrl": "https://mcp.oxylabs.io/mcp"
}
}
}Tools exposed by Oxylabs (10)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| ai_crawler ~480 tok | ๐ข Read | 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. | url*: stringuser_prompt*: stringoutput_format: stringschemarender_javascript: booleanreturn_sources_limit: integergeo_location |
| ai_scraper ~375 tok | ๐ข Read | 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. | url*: stringoutput_format: stringschemarender_javascript: booleangeo_location |
| ai_browser_agent ~356 tok | ๐ข Read | 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 | url*: stringtask_prompt*: stringoutput_format: stringschemageo_location |
| ai_search ~300 tok | ๐ข Read | 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. | query*: stringlimit: integerrender_javascript: booleanreturn_content: booleangeo_location |
| generate_schema ~78 tok | ๐ข Read | Generate a json schema in openapi format. | user_prompt*: stringapp_name*: string |
| ai_map ~405 tok | ๐ข Read | Tool useful for mapping website's URLs. | url*: stringsearch_keywordsuser_promptmax_crawl_depth: integerrender_javascript: booleanlimit: integergeo_locationallow_subdomains: booleanallow_external_domains: boolean |
| universal_scraper ~511 tok | ๐ข Read | Get a content of any webpage. Supports browser rendering, parsing of certain webpages and different output formats. | url*: stringrenderuser_agent_typegeo_locationoutput_format |
| google_search_scraper ~848 tok | ๐ข Read | Scrape Google Search results. Supports content parsing, different user agent types, pagination, domain, geolocation, locale parameters and different output formats. | query*: stringparse: booleanrenderuser_agent_typestart_page: integerpages: integerlimit: integerdomaingeo_locationlocalead_mode: booleanoutput_format |
| amazon_search_scraper ~924 tok | ๐ข Read | 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. | query*: stringcategory_idmerchant_idcurrencyparse: booleanrenderuser_agent_typestart_page: integerpages: integerdomaingeo_locationlocaleoutput_format |
| amazon_product_scraper ~849 tok | ๐ข Read | 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. | query*: stringautoselect_variant: booleancurrencyparse: booleanrenderuser_agent_typedomaingeo_locationlocaleoutput_format |
Connect Oxylabs to another client
Other servers for Claude Code
GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.
Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.