Puter MCP

What Puter MCP does

Puter MCP gives AI tools an MCP connection to Puter. The exposed scope includes file management, website management, and serverless worker management, with additional Puter functionality described broadly as available through the connection.

Puter itself is an open-source internet computer designed to be self-hosted or used through Puter.com. Its wider platform includes cloud storage, a key-value database, AI features, web applications, games, and an app store. The MCP server is relevant when an agent needs to operate on resources belonging to that platform rather than interact only with a local filesystem.

How it works

The MCP layer lets a compatible AI tool interact with Puter through agent-accessible tools. Those tools are intended for actions such as handling files, working with websites, and managing workers. Puter can be used as a hosted service at puter.com or operated from a local or self-hosted deployment.

The underlying Puter project is a JavaScript application that can be started from a local checkout with npm. A local development instance is available at http://puter.localhost:4100 after installation and startup. Docker is also supported for running a locally built checkout, and separate shell commands are provided for Linux, macOS, and Windows self-hosting.

Setup and configuration

For local development, clone the Puter repository, enter the project directory, install its npm dependencies, and start the application:

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

The project also supports Docker-based builds. Self-hosting can be initiated on Linux or macOS with:

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

On Windows, use:

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

These commands establish a Puter deployment. Configure the AI client’s MCP connection according to the client and server setup you use.

Tools and capabilities

• Manage files stored in Puter.
• Work with websites through Puter.
• Manage Puter serverless workers.
• Use the broader Puter platform, which includes cloud storage, a key-value database, AI services, and web apps.
• Connect to either a self-hosted Puter deployment or the hosted Puter.com service.

Limitations and notes

The repository is licensed under AGPL-3.0 unless a component explicitly uses another license. Third-party libraries may have separate licenses. Puter offers both hosted and self-hosted operation, so deployment and data-location decisions remain part of the integration design. The listed MCP scope names files, websites, and workers, but does not enumerate individual tool names or parameters.