# PairOnce

> PairOnce is a freemium MCP server for files and documents. Let an AI agent send files and text to your paired phone or computer, end-to-end encrypted. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $3.99 a month
- **Platforms:** CLI, Web
- **Website:** https://paironce.com
- **Repository:** https://github.com/paironce/cli
- **MCP Registry name:** io.github.paironce/cli
- **Categories:** files and documents, communication
- **Listing updated:** 2026-11-14

## About

PairOnce pairs a terminal or agent with your own devices using a six-digit code, then moves files and text between them without an account. The other device is simply a browser with paironce.com open. During pairing both screens show a safety code, and the agent continues only after you confirm they match.

The MCP server (paironce mcp) is the agent-facing side of the npm CLI and exposes ten tools. Beyond sending, an agent can ask your device for a photo, a scan or a file with a stated reason, and you can accept or decline. It can also ask to watch your camera or screen as still frames, at most two a second, so it can talk you through a task. You see a stop button and either side can end it. Received files are saved to an inbox folder in the directory the server runs in.

Traffic is encrypted between the devices, direct when the network allows and through a relay that keeps nothing when it does not. The website says transfers are free with no sign-up, file size up to 2 GB per file in current browsers, and an optional Pro plan at $3.99 a month or $29.99 a year raises the limits.

## Features

- **Six-digit pairing:** Pair once with a code and compare a safety code on both screens.
- **Send files and text:** Sends files, messages or links to a paired device, which accepts each file.
- **Ask for a photo or scan:** The agent can request a photo, scan or file with a reason, and you can decline.
- **Watch camera or screen:** Shares still frames, at most two a second, with a visible stop control.
- **Encrypted transfer:** Direct or through a relay that stores nothing, with a fresh key per connection.
- **No account:** Runs through a browser on the other device with nothing to install.

## Good for

- Have a build agent send an artifact to your phone
- Send a photo of a whiteboard to an agent for processing
- Let an agent ask for a document scan from your phone
- Show your screen to an agent so it can guide you step by step
- Move a large file between devices without cloud storage

## Install

### Claude Code (Terminal)

```sh
claude mcp add cli -- npx -y paironce
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "paironce"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "paironce"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "cli": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "paironce"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "paironce"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cli": {
      "command": "npx",
      "args": [
        "-y",
        "paironce"
      ]
    }
  }
}
```

## Tools

- `pair_device`: Pairs one of your devices using a six-digit code.
- `send_file`: Sends a file to a paired device.
- `send_text`: Sends text to a paired device.
- `receive_files`: Waits for files sent from your device and saves them to the inbox.
- `request_photo`: Asks your device for a photo.
- `request_scan`: Asks your device for a scan.
- `request_file`: Asks your device for a file.
- `watch_frames`: Asks to see your camera or screen as still frames.
- `watch_stop`: Stops viewing.
- `list_devices`: Lists paired devices.

## FAQ

### Does PairOnce store my files?

No. The site says there is no cloud storage; files go directly to the other device or through a relay that keeps nothing.

### Do I need an account?

No account or app is needed. The other device only needs a browser with paironce.com open.

### How big can files be?

Up to 2 GB per file in current browsers, or 10 GB with PairOnce Pro on one of the two devices. Older browsers take up to 50 MB.

### What does Pro cost?

$3.99 a month or $29.99 a year; it adds relay data, larger files and higher tool limits.

### Is PairOnce free?

PairOnce has a free plan, with paid plans for more usage or features. Paid plans start at $3.99 a month.

### How do I add PairOnce to Claude Code?

Run this command in your terminal: claude mcp add cli -- npx -y paironce

### What are the best alternatives to PairOnce?

The closest alternatives to PairOnce are ASTra, BoardAgent, Callout, CARTESIAN ECU and nicemails.

## Alternatives

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/paironce
