The official Model Context Protocol (MCP) server for String AI's Web Unblocker API. Connect any MCP-compatible client — VS Code, Cursor, Windsurf, Claude Desktop, and more — to String AI's powerful web access capabilities.

Tools

Tool	Description
`unblocker_fetch`	Fetch any webpage with automatic anti-bot bypass, CAPTCHA handling, and JavaScript rendering
`unblocker_search`	Search the web with reliable results — bypasses rate limits and bot protection on search engines

Quick Start

Run with npx (once published to npm)

env STRING_AI_API_KEY=your-key npx @usestring/mcp

Install globally

npm install -g @usestring/mcp
STRING_AI_API_KEY=your-key string-ai-mcp

Build from source

git clone https://github.com/durable-alpha/string-ai-mcp.git
cd string-ai-mcp
npm install
npm run build
STRING_AI_API_KEY=your-key node build/index.js

Environment Variables

Variable	Required	Description
`STRING_AI_API_KEY`	Yes	Your String AI API key

Client Configuration

VS Code

Press Ctrl+Shift+P → Preferences: Open User Settings (JSON) and add:

{
	"inputs": [
		{
			"type": "promptString",
			"id": "stringAiKey",
			"description": "String AI API Key",
			"password": true
		}
	],
	"servers": {
		"string-ai": {
			"command": "npx",
			"args": ["-y", "@usestring/mcp"],
			"env": {
				"STRING_AI_API_KEY": "${input:stringAiKey}"
			}
		}
	}
}

Or add a .vscode/mcp.json file to share the configuration with your team.

Cursor

Open Settings → Features → MCP Servers → + Add new global MCP server and paste:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "string-ai": {
      "command": "npx",
      "args": ["-y", "@usestring/mcp"],
      "env": {
        "STRING_AI_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Testing with the MCP Inspector

The MCP Inspector lets you test your server interactively in a browser:

npx @modelcontextprotocol/inspector node build/index.js

Then open http://127.0.0.1:6274, connect via stdio, and try calling each tool from the UI.

How It Works

┌──────────────────┐   stdio (JSON-RPC)   ┌──────────────────┐   HTTPS   ┌──────────────────┐
│  VS Code / Cursor │ ◄──────────────────► │  String AI       │ ────────► │  String AI       │
│  Windsurf / Claude│                      │  Unblocker MCP   │           │  Unblocker API   │
└──────────────────┘                       └──────────────────┘           └──────────────────┘

The IDE spawns this server as a child process and communicates over stdio.
When the LLM decides it needs web content, it invokes unblocker_fetch or unblocker_search.
This server forwards the request to String AI's Unblocker API (using your API key from the environment) and returns the result to the LLM.

About String AI

String AI provides a powerful web unblocker API that handles proxies, anti-bot measures, and JavaScript rendering automatically. Get your API key at usestring.ai.