<p align="center"><img src="assets/icon-192.png" width="96" height="96" alt="Put It Online"></p>

# Put It Online MCP server

[Put It Online](https://putit.online) turns files and AI-made web pages into short public links. This repository holds the public metadata and connection instructions for its **hosted remote MCP server**:

```
https://putit.online/mcp
```

Ask your assistant to build a landing page, an RSVP page, a chart or a report, and it publishes it as a live web page. Share a PDF, an image, a zip or any other file the same way. Every upload passes a safety check before the link goes live, and published pages are served sandboxed on their own link.

- **Transport:** Streamable HTTP (remote, nothing to install)
- **Auth:** optional. Works anonymously (7-day links plus a private manage token). Sign in with OAuth 2.1 (PKCE, client ID metadata documents or dynamic client registration) or an API key to keep links in your account.
- **Account-only URL:** `https://putit.online/mcp/account` always asks you to sign in. Use it for clients that decide on OAuth at connect time (Windsurf, Zed, Le Chat, Docker).
- **Official MCP Registry name:** `online.putit/put-it-online`
- **Docs:** https://putit.online/connect · **Privacy:** https://putit.online/privacy · **Terms:** https://putit.online/terms · **Support:** https://putit.online/support

> The server itself is a hosted service and is not open source. This repository contains only metadata (`server.json`, `gemini-extension.json`, `glama.json`), instructions and logos, under the MIT licence.

## Tools

| Tool | What it does |
|---|---|
| `publish_site` | Publish a web page or small static site (HTML, CSS, JavaScript, images) and get its link |
| `upload_file` | Share a file (text, or base64 for binary files) as a short link |
| `create_upload_session` | Get a one-time upload URL / `curl` command for large files |
| `get_link` | Check a link's status (live, checking, …), expiry and views |
| `delete_link` | Permanently delete a link and its files |
| `list_links` | List the links in the connected account |
| `set_password` | Add or remove a link password (paid plans) |
| `make_permanent` | Keep a link online permanently (paid plans) |
| `extend` | Restart a 7-day link's clock (paid plans) |
| `get_account` | The connected account's plan, limits and features |

All tools carry `title` and `readOnlyHint` / `destructiveHint` annotations and an `outputSchema`.

## Connect

### Claude (claude.ai, Desktop, mobile)

Customize → Connectors → **Add custom connector** → paste `https://putit.online/mcp` → Add. Sign in when Claude offers it.

### Claude Code

```bash
claude mcp add --transport http put-it-online https://putit.online/mcp
```

### ChatGPT

Settings → Apps → Advanced settings → turn on **Developer mode**. Then Plugins → **+** → Add custom MCP server → paste `https://putit.online/mcp` → authentication **OAuth**.

### Codex

```bash
codex mcp add put-it-online --url https://putit.online/mcp
```

or in `~/.codex/config.toml`:

```toml
[mcp_servers.put-it-online]
url = "https://putit.online/mcp"
```

### Cursor

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=put-it-online&config=eyJ1cmwiOiJodHRwczovL3B1dGl0Lm9ubGluZS9tY3AifQ==) (deeplink), or `~/.cursor/mcp.json`:

```json
{ "mcpServers": { "put-it-online": { "url": "https://putit.online/mcp" } } }
```

### VS Code / GitHub Copilot

[Install in VS Code](vscode:mcp/install?%7B%22name%22%3A%22put-it-online%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A//putit.online/mcp%22%7D) (deeplink), or `.vscode/mcp.json`:

```json
{ "servers": { "put-it-online": { "type": "http", "url": "https://putit.online/mcp" } } }
```

or `code --add-mcp '{"name":"put-it-online","type":"http","url":"https://putit.online/mcp"}'`

### Gemini CLI

```bash
gemini extensions install https://github.com/kitsunde/putit-mcp
# or
gemini mcp add --transport http put-it-online https://putit.online/mcp
```

### Windsurf (`mcp_config.json`)

```json
{ "mcpServers": { "put-it-online": { "serverUrl": "https://putit.online/mcp/account" } } }
```

### Zed (`settings.json`)

```json
{ "context_servers": { "put-it-online": { "url": "https://putit.online/mcp/account" } } }
```

### Cline

Add a remote server (Streamable HTTP) with URL `https://putit.online/mcp`. See [`llms-install.md`](llms-install.md).

### API key instead of OAuth

Create a key at https://putit.online/connect and send it as `Authorization: Bearer pio_…`:

```json
{
  "mcpServers": {
    "put-it-online": {
      "url": "https://putit.online/mcp",
      "headers": { "Authorization": "Bearer pio_your_api_key" }
    }
  }
}
```

### Clients that only run local (stdio) servers

```json
{
  "mcpServers": {
    "put-it-online": {
      "command": "npx",
      "args": ["-y", "https://putit.online/downloads/putit-mcp.tgz"],
      "env": { "PUTIT_URL": "https://putit.online" }
    }
  }
}
```

Add `"PUTIT_API_KEY": "pio_…"` to `env` for account mode. Node 20+.

## Example prompts

- "Build a one-page RSVP site for Sam's 30th on 14 Nov and put it online."
- "Put this PDF online and give me a link I can send to the client."
- "Which of my links expire this week?"
- "Add a password to the proposal link."
- "Delete the link I made yesterday."

## Also available as

- REST API: [OpenAPI 3.1](https://putit.online/api/v1/openapi.json)
- [llms.txt](https://putit.online/llms.txt)

## Privacy

Put It Online receives only what the assistant sends to it (tool inputs and files, client name and request metadata), never your conversation. Details: https://putit.online/privacy. Content rules: https://putit.online/acceptable-use. Report abuse: https://putit.online/report.

## Licence

The metadata and documentation in this repository are MIT licensed. The Put It Online service is operated by Kit Sunde, Singapore.