Metadata-Version: 2.4
Name: babelwrap-mcp
Version: 0.1.1
Summary: MCP server for BabelWrap — give AI agents web browsing superpowers.
Author: Pedro M. Fernandes
License-Expression: MIT
Project-URL: Homepage, https://babelwrap.com
Project-URL: Documentation, https://babelwrap.com/docs/mcp
Project-URL: Repository, https://github.com/babelwrap/babelwrap-mcp
Project-URL: Issues, https://github.com/babelwrap/babelwrap-mcp/issues
Keywords: mcp,ai-agents,browser,automation,claude,model-context-protocol
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: fastmcp>=2.3

# BabelWrap MCP Server

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 uvx (recommended -- no install required)
uvx babelwrap-mcp

# Using pip
pip install babelwrap-mcp

# Using pipx (isolated environment)
pipx install 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": "uvx",
      "args": ["babelwrap-mcp"],
      "env": {
        "BABELWRAP_API_KEY": "bw_your_api_key_here"
      }
    }
  }
}
```

If you installed with `pip` or `pipx`, use the binary directly:

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

#### Claude Code

```bash
claude mcp add babelwrap -- uvx babelwrap-mcp
```

Then set your API key as an environment variable:
```bash
export BABELWRAP_API_KEY="bw_your_api_key_here"
```

## Available 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 |
| `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_scroll` | Scroll the page |
| `babelwrap_hover` | Hover over an element |
| `babelwrap_upload` | Upload a file |
| `babelwrap_back` / `babelwrap_forward` | Browser history |
| `babelwrap_wait_for` | Wait for a condition |
| `babelwrap_list_pages` / `babelwrap_switch_page` | Multi-tab support |

## Environment Variables

| Variable | Required | Description |
|---|---|---|
| `BABELWRAP_API_KEY` | Yes | Your BabelWrap API key |
| `BABELWRAP_API_URL` | No | API base URL (default: `https://api.babelwrap.com/v1`) |

## Documentation

Full documentation at [babelwrap.com/docs/mcp](https://babelwrap.com/docs/mcp)

## License

MIT

<!-- mcp-name: io.github.soulfir/babelwrap-mcp -->
