Connect MCP To BlitzBrowser

The Model Context Protocol is one of the popular ways to add context to your LLMs and AI agents. We support the MCP open protocol to allow your AI agents to connect to the web by controling web browsers on scale. You have the possibility to automate tasks, extract data and use our residential proxies with your agents.

This is the URL to connect your MCP client to our MCP server.

MCP Authentication Connection Parameters

HTTP Headers

Connect your MCP client to our browsers with HTTP header as authentication method. HTTP header is the preferred method to authenticate your MCP client since it is more secure. HTTP headers are not logged in general.

We support 2 HTTP headers to authenticate your client. You only need to use one and don't have a preference on which you should use. You can learn how to create your access key here. We provide examples below on how to setup the header.

Query Param

You can use query params to authenticate to our browsers when HTTP header as an authentication method isn't available. We don't support OAuth 2.0 authorization method. HTTP header is the preferred method to authenticate your MCP client since it is more secure. HTTP headers are not logged in general.

MCP Proxy Parameters

You have 2 ways to connect your browser to our residential proxies. By default the browsers don't use any proxy. These parameters are optional and only required if you need to use the proxies. You can configure your proxy parameters from the dashboard.

Query Params

When connecting your MCP client to our MCP server, you can specify the proxies to use from the query params. They have priority over the proxy properties from the prompts.

The proxyCountry parameter will proxy all your requests from a specific country. The country code is in ISO 3166-1 alpha-2 format.

The proxyCountry and proxyState parameters will proxy all your requests from a state within a country. The state code is in subdivision ISO 3166-1 alpha-2 format.

The proxyLocation parameter will proxy all your requests from a specific city. The ID is the ID of the city you are requesting the proxies. You have to use the dashboard tool to find the city ID.

Prompts

The most simple way is to let your AI agent to configure the proxy params.

Open a browser on https://blitzbrowser.com from a proxy in Quebec, Canada. Go to https://blitzbrowser.com and use a proxy from Germany.

MCP Client Examples

Claude.ai

Claude.ai requires OAuth 2.0 authorization method. We don't support this method, so you have to pass your access key as a query parameter.

Claude Desktop

You need to add the following mcp server config into your Claude config file. Don't forget to replace the access key with your own key.

{
	"mcpServers": {
        // ...
		"blitzbrowser": {
			"command": "npx",
			"args": [
				"mcp-remote",
				"https://api.blitzbrowser.com/mcp",
				"--header",
				"x-api-key: ${ACCESS_KEY}"
			]
		}
        // ...
	}
}