# mcp-server

Connects your AI agent to Puter for files, websites and workers. Useful when the project already lives in Puter's cloud.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 43872
- Author: HeyPuter
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HeyPuter/puter
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-server

## What it does

mcp-server is an MCP server from HeyPuter that lets AI tools talk to Puter. The agent manages files, websites and workers from the chat instead of you clicking through the dashboard.

It is a remote HTTP server at `https://mcp.puter.com/`, so there is nothing to install locally. Claude takes one command; Cursor and GitHub Copilot take a JSON block in their MCP config. Codex, Cline, Zed and Windsurf connect the same way.

The repository is AGPL-3.0. That matters if you fork Puter itself rather than just pointing a client at the hosted endpoint. For plain use through `https://mcp.puter.com/` the license does not get in the way.

## Requirements
- Remote server: `https://mcp.puter.com/`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.puter.com/
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mcp-server --url https://mcp.puter.com/
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "url": "https://mcp.puter.com/"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "http",
            "url": "https://mcp.puter.com/"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mcp-server https://mcp.puter.com/
```

## When to use it
- upload a file to Puter storage from the agent chat
- publish a site and confirm it loads
- start a worker and check its status
- list what is inside a remote folder
- wire an AI agent to cloud storage without manual exports

## Example prompts
- List the files in my Puter folder
- Publish this site through Puter and give me the link
- Start the worker and tell me if it fails

## Similar
- [firebase-security-rules-auditor](https://affpapa.org/en/nevibecode/skills/firebase-security-rules-auditor.md) — skill · 138600 installs
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669

---
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