# BabelWrap MCP Server (Node.js)

An [MCP](https://modelcontextprotocol.io) server that gives AI agents web browsing superpowers via the [BabelWrap](https://babelwrap.com) API.

Works with Claude Desktop, Cursor, Claude Code, and any MCP-compatible client.

## Installation

```bash
# Using npx (recommended -- no install required)
npx babelwrap-mcp

# Using npm (global)
npm install -g babelwrap-mcp
```

## Setup

### 1. Get an API Key

Sign up at [babelwrap.com](https://babelwrap.com) and create an API key from your dashboard.

### 2. Configure Your MCP Client

#### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "babelwrap": {
      "command": "npx",
      "args": ["-y", "babelwrap-mcp"],
      "env": {
        "BABELWRAP_API_KEY": "bw_your_api_key_here"
      }
    }
  }
}
```

#### Claude Code

```bash
claude mcp add babelwrap -- npx -y babelwrap-mcp
```

Then set your API key:

```bash
export BABELWRAP_API_KEY=bw_your_api_key_here
```

## Tools

| Tool | Description |
|------|-------------|
| `babelwrap_new_session` | Create a new browser session |
| `babelwrap_close_session` | Close a browser session |
| `babelwrap_navigate` | Navigate to a URL |
| `babelwrap_snapshot` | Get current page state |
| `babelwrap_click` | Click an element by description |
| `babelwrap_fill` | Fill a form field |
| `babelwrap_submit` | Submit a form |
| `babelwrap_extract` | Extract structured data |
| `babelwrap_screenshot` | Take a screenshot |
| `babelwrap_press` | Press a keyboard key |
| `babelwrap_upload` | Upload a file |
| `babelwrap_hover` | Hover over an element |
| `babelwrap_back` | Navigate back |
| `babelwrap_forward` | Navigate forward |
| `babelwrap_scroll` | Scroll the page |
| `babelwrap_wait_for` | Wait for a condition |
| `babelwrap_list_pages` | List open tabs/pages |
| `babelwrap_switch_page` | Switch to another tab |

## Also Available

- **Python**: `pip install babelwrap-mcp` ([babelwrap-mcp on PyPI](https://pypi.org/project/babelwrap-mcp/))
- **JS/TS SDK**: `npm install babelwrap` ([babelwrap on npm](https://www.npmjs.com/package/babelwrap))
- **Python SDK**: `pip install babelwrap` ([babelwrap on PyPI](https://pypi.org/project/babelwrap/))

## License

MIT