# FourA MCP server

> Provides AI agents with reliable web access through smart HTTP requests, rotating proxies, and full-browser rendering to bypass bot detection.

- Repository: https://github.com/fouradata/mcp
- Page: https://hostedmcp.org/servers/fouradata/mcp
- Transport: stdio, remote
- Stars: 7
- License: MIT
- Latest version: 0.8.3

## Install

### Claude Code

```sh
claude mcp add --env FOURA_API_KEY=<YOUR_FOURA_API_KEY> mcp -- npx -y @fouradata/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fouradata/mcp"
      ],
      "env": {
        "FOURA_API_KEY": "<YOUR_FOURA_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@fouradata/mcp"
      ],
      "env": {
        "FOURA_API_KEY": "<YOUR_FOURA_API_KEY>"
      }
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fouradata/mcp"
      ],
      "env": {
        "FOURA_API_KEY": "<YOUR_FOURA_API_KEY>"
      }
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@fouradata/mcp"]

[mcp_servers.mcp.env]
FOURA_API_KEY = "<YOUR_FOURA_API_KEY>"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@fouradata/mcp"
      ],
      "env": {
        "FOURA_API_KEY": "<YOUR_FOURA_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FOURA_API_KEY` | yes | yes | Your FourA API key (pk_live_...), managed at https://foura.ai/dashboard/#api-keys |

## Tools (3)

- `browser`
- `version`
- `profile`

## FAQ

### How do I start using FourA with my AI agent?

You can use the `foura_auto` tool, which takes a URL and automatically chooses the best fetch method, handling common blocks for you.

### Can I control which browser or operating system is used for requests?

Yes, you can explicitly specify the browser (Chrome, Firefox, etc.) and the operating system (Windows, macOS, etc.) to match specific target requirements.

### What happens if a direct HTTP request is blocked?

You can use the `foura_proxy` tool, which routes requests through rotating proxies and includes automatic retries on failure.

### Does the server provide structured data or just plain text?

Every response includes human-readable text and a typed `structuredContent` JSON object validated against a schema, ensuring predictable responses for agents.