MCP Server

Active

AGPL-3.0

com.puter/mcp-server MCP Server

com.puter/mcp-server

Let AI agents manage your Puter files, websites, and serverless workers over MCP.

What is the com.puter/mcp-server MCP server?

The Puter MCP server is a remote Model Context Protocol endpoint (https://mcp.puter.com/) that lets AI tools and agents interact with Puter, an open-source, self-hostable "internet computer" platform. It exposes Puter's file storage, website hosting, and serverless worker capabilities so an AI client can manage a user's Puter account programmatically.

Puter's MCP server connects AI assistants like Claude or Cursor to a Puter account via a remote streamable-HTTP endpoint. Puter itself is an open-source, self-hostable cloud platform combining file storage, apps, AI, databases, and serverless workers under one roof. Through this MCP server, an AI agent can manage files, publish and manage websites, and work with serverless workers on behalf of a user, without needing to run any local server since the connection is remote.

How to install com.puter/mcp-server

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.puter.com/"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.puter.com/"
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.puter.com/"
    }
  }
}

Claude Desktop

Claude Desktop connects to remote servers via the mcp-remote bridge.

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.puter.com/"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http mcp-server https://mcp.puter.com/

Use cases

Have an AI agent read, write, and organize files in a user's Puter cloud storage
Publish or update static websites hosted on Puter directly from an AI assistant
Manage Puter serverless workers through natural-language AI commands
Automate routine Puter account tasks (files, apps) via an MCP-compatible client like Claude or Cursor

com.puter/mcp-server MCP server FAQ

What does the Puter MCP server do?

It gives AI tools like Claude or Cursor access to a Puter account so they can manage files, websites, and serverless workers through the Model Context Protocol.

Is the Puter MCP server free to use?

Puter itself is open-source under AGPL-3.0 and can be self-hosted for free, or used as a hosted service at puter.com. The README does not specify separate pricing for the MCP endpoint itself.

How do I connect the Puter MCP server in Cursor or Claude?

Add it as a remote MCP server using the streamable-HTTP endpoint https://mcp.puter.com/ in your client's MCP configuration; no local installation is required.

What authentication does the Puter MCP server require?

The README does not detail specific auth steps beyond connecting to the hosted endpoint; typically this would involve authenticating with a Puter account to authorize access.

Can I self-host the Puter MCP server instead of using the hosted one?

The README describes self-hosting the full Puter platform (via git clone/npm start or the self-host script), but the MCP-specific instructions given are for the remote hosted endpoint at mcp.puter.com.

What can an AI agent actually manage through this server?

Based on the description, it can manage files, websites, and workers within a Puter account; the detailed README does not list a specific tool-by-tool breakdown.

README (reference)

Source of truth, from the repository.

<h3 align="center"><img width="80" alt="Puter.com, The Personal Cloud Computer: All your files, apps, and games in one place accessible from anywhere at any time." src="https://assets.puter.site/puter-logo.png"></h3> <h3 align="center">The Open-Source Internet Computer!</h3> <p align="center"> <a href="https://puter.com/?ref=github.com"><strong>« LIVE DEMO »</strong></a> <br /> <br /> <a href="https://puter.com/?ref=github.com">Puter.com</a> · <a href="https://apps.puter.com/">App Store</a> · <a href="https://developer.puter.com" target="_blank">Developers</a> · <a href="https://discord.com/invite/PQcx7Teh8u">Discord</a> · <a href="https://reddit.com/r/puter">Reddit</a> · <a href="https://twitter.com/HeyPuter">X</a> </p> <h3 align="center"><img width="800" style="border-radius:5px;" alt="screenshot" src="https://assets.puter.site/puter.com-screenshot.webp"></h3> <br/>

Puter

Puter is an advanced, open-source, self-hostable internet computer designed to be feature-rich, fast, and highly extensible.

For Users

Puter's goal is to provide you with every app and feature you need to work, create, and play under one roof. From a simple Notepad and Voice Recorder to Spreadsheet and Camera, Puter wants to be the all-in-one solution for your digital life.

For Developers

Puter provides everything you need to build and publish web apps and games. From AI to Cloud Storage and Database to Serverless Workers, Puter has you covered. Puter also helps you get users! Once you build your app, you can publish it on our App Store to reach and monetize users.

<br/>

Getting Started

💻 Local Development

git clone https://github.com/HeyPuter/puter
cd puter
npm install
npm start

→ This should launch Puter at http://puter.localhost:4100

<br/>

🚀 Self-Hosting

Linux/macOS

curl -fsSL https://puter.com/selfhost | sh

Windows

irm https://puter.com/selfhost?os=windows | iex

→ For more details, see Self-Hosting Puter.

<br/>

☁️ Puter.com

Puter is available as a hosted service at puter.com.

<br/>

Support

Connect with the maintainers and community through these channels:

Bug report or feature request? Please open an issue.
Discord: discord.com/invite/PQcx7Teh8u
X (Twitter): x.com/HeyPuter
Reddit: reddit.com/r/puter/
Mastodon: mastodon.social/@puter
Security issues or abuse reports? security@puter.com
Email maintainers at hi@puter.com

We are always happy to help you with any questions you may have. Don't hesitate to ask!

<br/>

License

This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise. Third-party libraries included in this repository may be subject to their own licenses.

<br/>

Translations

View repository →