# mcp-server — MCP server card for AI agents

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

Registry name: `com.puter/mcp-server` · category: Files and documents · version 1.0.1 · updated 2026-06-13

## Connect
- Remote (Claude Code): `claude mcp add --transport http mcp-server https://mcp.puter.com/`

## Facts
- Repository: https://github.com/HeyPuter/puter (44,199 stars)
- Website: https://puter.com

Before you connect a server: read its repository, and give it only the permissions and keys it needs.

## Links
- AgentGid page: https://agentgid.com/mcp/servers/com-puter-mcp-server/


## Puter MCP: your assistant manages files and sites on Puter

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.

### Where to use it
- 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: Save counters, settings or small records as key and value pairs, for example a visit counter for your site. (idea, not from the official pages)
- Tidy up your Puter files: Ask the assistant to list, rename and sort the files in your Puter home folder into folders.

### How to start
- Add the hosted server to Claude Code.

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

- Run /mcp in Claude Code and sign in with your Puter account in the browser.
- Ask in plain words, for example to publish a folder as a website.

### License
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.

### Good to know
- The assistant can delete files and whole folders, take sites offline and remove apps. Turn on approval prompts for these tools.
- Publishing a site or deploying a function makes it public on the internet at once.
- Signing in hands your assistant your Puter sign-in token, which gives full account access. Treat it like a password.
- Paths must start with ~/ or your username; a bare path like /portfolio/index.html fails.
- Wiping a whole data store in one call is left out on purpose; keys are deleted one by one.

Checked 2026-11-10 against: https://docs.puter.com/mcp/index.md, https://docs.puter.com/llms.txt, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/README.md, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/LICENSE.txt, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/README.md, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/src/tools.js, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/src/mcp.js, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/src/oauth.js, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/wrangler.toml, https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/mcpb/manifest.json, https://mcp.puter.com/

### Mistakes to avoid
- Don't: fs_write_file {"path": "/portfolio/index.html", ...} → Do: Call whoami, then use ~/portfolio/index.html or /<username>/portfolio/index.html (Every path lives under your home folder; bare root paths are rejected.)
- Don't: Base64-encode a large local file into fs_write_file → Do: 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.)
- Don't: Assume the file exists after the PUT upload finishes → Do: Call fs_complete_upload; call fs_abort_upload if the upload failed (The file is created only when the upload is completed.)
- Don't: Look for a workers_update tool to change a deployed function → Do: Write the new code to the worker's source file with fs_write_file (There is no separate update call.)
- Don't: fs_delete on a folder to remove one file inside it → Do: 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.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
