# Uplink

Runs a real browser on a device you pair, inside a session you are already signed into. Useful when headless automation gets blocked at login or by a captcha.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: uplink-code
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/uplink-code/mcp
- Updated: 2026-06-23
- HTML: https://affpapa.org/en/nevibecode/mcp/uplink

## What it does

Uplink takes over a phone or laptop you have paired. The model works inside your live session, so it sees the actual DOM, the network requests and the console output. Nothing is stored on the server side, because you sign in yourself in your own browser.

Setup goes in two steps. You ask your AI client to connect and it hands back a pairing link; you open that link on the device in the Uplink Connect app. Before any of that, sign in once with `npx @uplink-code/cli login` — the server reads the credentials that CLI writes.

The package is proprietary, not open source. You need Node.js so `npx` can fetch it. Pair a device where you are not signed in and there is nothing for the model to drive.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add uplink -- npx -y @uplink-code/mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add uplink -- npx -y @uplink-code/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "uplink": {
            "command": "npx",
            "args": [
                "-y",
                "@uplink-code/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "uplink": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@uplink-code/mcp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add uplink npx -y @uplink-code/mcp
```

## When to use it
- walk through a flow on a site that blocks headless browsers
- see how a page behaves inside a logged-in account
- capture real network traffic and console errors
- let an agent reach a site without handing over a password

## Example prompts
- Connect through Uplink and open the orders page in my account
- Run the checkout flow on the paired device and show me what goes over the network
- Pull the console errors from this page with Uplink

## Similar
- [browser-screenshot](https://affpapa.org/en/nevibecode/skills/browser-screenshot.md) — skill · 4100 installs
- [agent-browser](https://affpapa.org/en/nevibecode/skills/brianlovin-agent-browser.md) — skill · 2800 installs
- [dev-browser](https://affpapa.org/en/nevibecode/skills/dev-browser.md) — skill · 2500 installs
- [agent-browser-automation](https://affpapa.org/en/nevibecode/skills/agent-browser-automation.md) — skill · 2100 installs
- [Agent Browser](https://affpapa.org/en/nevibecode/skills/am-will-agent-browser.md) — skill · 1200 installs
- [browser-control](https://affpapa.org/en/nevibecode/skills/browser-control.md) — skill · 1000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md