Skip to content
Agents tracked: 502 Releases (7d): 762 Agent status: no reported issuesSince last limit reset: Claude 11d · Codex 9d For AI agents: Markdown Updated Nov 22, 2026

Puter

by HeyPuter

your assistant manages files and sites on Puter.

Files and documentsOfficialRemote

GitHubWebsite

1. Made by

“The Puter MCP server is hosted at mcp.puter.com.”

Puter documents the server on docs.puter.com and hosts it at mcp.puter.com; the code lives in Puter's own repo HeyPuter/puter.

docs.puter.com/mcp/index.md

Checked against its repository at one commit, on Nov 10, 2026. Tap a verdict to see its source.How we checkedReport an error

What Puter does

Puter is a free online computer with files, website hosting and small server functions. Its hosted server lets an AI assistant such as Claude Code, Codex or Cursor work in your Puter account. It can save files, publish a folder as a website, deploy a small function, and store data, acting as you.

What people use it for

Put a small site online

Your assistant writes the pages into a folder and publishes it at a puter.site address you can share right away.

A small server function with a link

Have the assistant turn a script into a small online function, for example a form handler, and get its public address.

Move big files without the chat

Upload a large build or video straight from your computer to your Puter storage; the file does not pass through the conversation.

Register an app in the Puter store

After a site is online, register it as a Puter app so it shows in your app list and can later be listed in the app store.

Keep simple app data Idea

Save counters, settings or small records as key and value pairs, for example a visit counter for your site.

Tidy up your Puter files

Ask the assistant to list, rename and sort the files in your Puter home folder into folders.

Puter popularity

44.2K
GitHub stars, HeyPuter/puter
0
public agent projects connect it
Puter: GitHub starsHeyPuter/puter 44,199

Tools it gives your agent (42)

What it sends and its license

Sends

File contents, site files, worker code and stored values the assistant sends, plus your Puter token

To mcp.puter.com and api.puter.com (Puter); Each tool call. Opt out: Remove the server, or deploy the connector yourself against a self-hosted Puter.

Sends

Published sites and deployed functions

To The public internet (puter.site addresses and worker URLs); After hosting_create or workers_create. Opt out: Use hosting_delete or workers_delete to take them down.

Sends

File contents the tools read

To Your AI assistant and its model provider; Each read tool call. Opt out: Keep private files out of folders the assistant reads.

The hosted server is free to connect with a Puter account. Puter's code, including this server, is open source under AGPL-3.0; changed copies you share or run for others must stay open.

In a paid app
With conditions

Using the hosted server for your own work is fine; shipping changed Puter code to others or as a network service triggers AGPL-3.0 source sharing.

“This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise.” source

Pass on its files
With conditions

Copies of the code stay under AGPL-3.0 with source available.

“GNU AFFERO GENERAL PUBLIC LICENSE” source

client-work
With conditions

Work in the client's own Puter account with their sign-in; the server always acts as the signed-in user.

“Two ways, both running as the caller - the Worker holds no credentials of its own” source

Is it alive

Latest version

1.0.1 in the registry, updated Jun 13, 2026

Last release

Registry entry 1.0.1 (published 2026-06-13); hosted, the code at the pinned commit is from 2026-11-10

Remote endpoint
yes: https://mcp.puter.com/ answered an unauthenticated HEAD with HTTP 404 (JSON) on 2026-11-10; the MCP endpoint takes POST

Alternatives

Puter This page

44.2K starsRemote

netlify

Pick it if you deploy full web projects with a build step

Local

cloudflare-workers

Pick it if you need serverless code at the edge in several languages

Local

Computer

Pick it if the assistant needs its own persistent machine with a shell

5,310 starsRemote

All files and documents servers

Get started

Tell your AI assistant

“Connect the Puter MCP server at https://mcp.puter.com/, call whoami first, use ~/ paths, and ask me before any delete or before publishing a site.”

Connect it

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

After adding it in Claude Code, run /mcp to sign in with Puter. The code in src/mcp-connector can also be deployed as your own Cloudflare Worker.

Mistakes to avoid

fs_write_file {"path": "/portfolio/index.html", ...}
Call whoami, then use ~/portfolio/index.html or /<username>/portfolio/index.html

Every path lives under your home folder; bare root paths are rejected.

Base64-encode a large local file into fs_write_file
fs_start_upload, run the returned upload_command, then fs_complete_upload

Inline content goes through the chat and fails past the client's message size limit.

Assume the file exists after the PUT upload finishes
Call fs_complete_upload; call fs_abort_upload if the upload failed

The file is created only when the upload is completed.

Look for a workers_update tool to change a deployed function
Write the new code to the worker's source file with fs_write_file

There is no separate update call.

fs_delete on a folder to remove one file inside it
Pass the exact file path, or recursive false for a folder

Folders are deleted with everything in them by default.

Questions

Do I install anything?

No. The server is hosted; add its address in your assistant and sign in with Puter.

Where do published sites live?

At an address like name.puter.site, served from a folder in your Puter files.

Does unpublishing a site delete my files?

No. hosting_delete removes the address, not the files; deleting a worker also leaves its source file.

Can I run the server myself?

Yes. The code is in the Puter repo and deploys as a Cloudflare Worker, also against a self-hosted Puter.