{
 "kind": "mcp",
 "slug": "com-puter-mcp-server",
 "path": "mcp/servers/com-puter-mcp-server/",
 "name": "Puter",
 "maker": "HeyPuter",
 "density": "full",
 "crumbs": [
  [
   "MCP servers",
   "mcp/"
  ],
  [
   "Files and documents",
   "mcp/files/"
  ]
 ],
 "lead": "your assistant manages files and sites on Puter.",
 "chips": [
  {
   "label": "Files and documents",
   "path": "mcp/files/"
  },
  {
   "label": "Official"
  },
  {
   "label": "Remote"
  }
 ],
 "primary": {
  "label": "Copy connect command",
  "copy": "claude mcp add --transport http --scope user puter https://mcp.puter.com/"
 },
 "links": [
  {
   "label": "GitHub",
   "href": "https://github.com/HeyPuter/puter"
  },
  {
   "label": "Website",
   "href": "https://puter.com"
  }
 ],
 "track": "New versions and outages of the remote endpoint on your dashboard",
 "verdicts": [
  {
   "key": "official",
   "label": "Made by",
   "value": "The service itself",
   "status": "yes",
   "sub": "Official server",
   "quote": "The Puter MCP server is hosted at mcp.puter.com.",
   "note": "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.",
   "src": "https://docs.puter.com/mcp/index.md"
  },
  {
   "key": "secrets",
   "label": "Keys",
   "value": "1 secret needed",
   "status": "info",
   "sub": "none with OAuth sign-in; optionally a Puter auth token as an",
   "quote": "Then run /mcp inside Claude Code to authenticate with Puter.",
   "note": "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.",
   "src": "https://docs.puter.com/mcp/index.md"
  },
  {
   "key": "where",
   "label": "Runs",
   "value": "Remote",
   "status": "yes",
   "sub": "Nothing runs on your machine",
   "note": "Endpoint: https://mcp.puter.com/. Checked: yes: https://mcp.puter.com/ answered an unauthenticated HEAD with HTTP 404 (JSON) on 2026-11-10; the MCP endpoint takes POST.",
   "src": "https://mcp.puter.com/"
  },
  {
   "key": "license",
   "label": "Commercial use",
   "value": "With conditions",
   "status": "cond",
   "sub": "AGPL-3.0 license",
   "quote": "This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise.",
   "note": "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.",
   "src": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/README.md"
  }
 ],
 "vfoot": "Checked against its repository at one commit, on Nov 10, 2026.",
 "blocks": [
  {
   "id": "overview",
   "nav": "Overview",
   "h2": "What Puter does",
   "parts": [
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "What people use it for"
    },
    {
     "t": "uses",
     "items": [
      {
       "title": "Put a small site online",
       "text": "Your assistant writes the pages into a folder and publishes it at a puter.site address you can share right away.",
       "idea": false
      },
      {
       "title": "A small server function with a link",
       "text": "Have the assistant turn a script into a small online function, for example a form handler, and get its public address.",
       "idea": false
      },
      {
       "title": "Move big files without the chat",
       "text": "Upload a large build or video straight from your computer to your Puter storage; the file does not pass through the conversation.",
       "idea": false
      },
      {
       "title": "Register an app in the Puter store",
       "text": "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.",
       "idea": false
      },
      {
       "title": "Keep simple app data",
       "text": "Save counters, settings or small records as key and value pairs, for example a visit counter for your site.",
       "idea": true
      },
      {
       "title": "Tidy up your Puter files",
       "text": "Ask the assistant to list, rename and sort the files in your Puter home folder into folders.",
       "idea": false
      }
     ]
    }
   ]
  },
  {
   "id": "popularity",
   "nav": "Popularity",
   "h2": "Puter popularity",
   "parts": [
    {
     "t": "stats",
     "items": [
      {
       "n": "44.2K",
       "l": "GitHub stars, HeyPuter/puter"
      },
      {
       "n": "0",
       "l": "public agent projects connect it"
      }
     ]
    }
   ]
  },
  {
   "id": "tools",
   "nav": "Tools",
   "h2": "Tools it gives your agent (42)",
   "parts": [
    {
     "t": "tools",
     "items": [
      {
       "name": "whoami",
       "text": "Returns your username, id and home folder."
      },
      {
       "name": "fs_read_file",
       "text": "Reads a file as text or base64, optionally a byte range."
      },
      {
       "name": "fs_stat",
       "text": "Shows size, type and dates of a file or folder."
      },
      {
       "name": "fs_write_file",
       "text": "Creates or overwrites a file from inline content. Writes."
      },
      {
       "name": "fs_start_upload",
       "text": "Gives a signed address to upload a local file straight to storage."
      },
      {
       "name": "fs_complete_upload",
       "text": "Finishes an upload and creates the file. Writes."
      },
      {
       "name": "fs_abort_upload",
       "text": "Cancels an upload without creating a file."
      },
      {
       "name": "fs_mkdir",
       "text": "Creates a folder (and missing parent folders). Writes."
      },
      {
       "name": "fs_delete",
       "text": "Deletes a file or folder; folders are deleted with everything in them by default. Deletes."
      },
      {
       "name": "fs_readdir",
       "text": "Lists a folder."
      },
      {
       "name": "fs_copy",
       "text": "Copies a file or folder. Writes."
      },
      {
       "name": "fs_move",
       "text": "Moves or renames a file or folder. Writes."
      },
      {
       "name": "fs_rename",
       "text": "Renames a file or folder in place. Writes."
      },
      {
       "name": "hosting_list",
       "text": "Lists your published websites."
      },
      {
       "name": "hosting_get",
       "text": "Shows one website and the folder it serves."
      },
      {
       "name": "hosting_create",
       "text": "Publishes a folder as a public website at <name>.puter.site. Publishes."
      },
      {
       "name": "hosting_update",
       "text": "Points a website at a different folder. Publishes."
      },
      {
       "name": "hosting_delete",
       "text": "Unpublishes a website (the files stay). Deletes."
      },
      {
       "name": "workers_create",
       "text": "Deploys a JavaScript file as a serverless function with a public address. Publishes."
      },
      {
       "name": "workers_list",
       "text": "Lists your deployed functions."
      },
      {
       "name": "workers_get",
       "text": "Shows one function's name, address and source file."
      },
      {
       "name": "workers_exec",
       "text": "Calls a deployed function over the web as you."
      },
      {
       "name": "workers_delete",
       "text": "Removes a deployed function (the file stays). Deletes."
      },
      {
       "name": "apps_list",
       "text": "Lists the apps you own with usage stats."
      },
      {
       "name": "apps_get",
       "text": "Shows one app and its usage over a period."
      },
      {
       "name": "apps_create",
       "text": "Registers a new Puter app pointing at an address. Writes."
      },
      {
       "name": "apps_update",
       "text": "Changes or renames an app. Writes."
      },
      {
       "name": "apps_delete",
       "text": "Deletes an app registration (its site stays). Deletes."
      },
      {
       "name": "apps_check_name",
       "text": "Checks whether an app name is free."
      },
      {
       "name": "kv_get",
       "text": "Reads a stored key."
      },
      {
       "name": "kv_set",
       "text": "Creates or overwrites a key. Writes."
      },
      {
       "name": "kv_del",
       "text": "Deletes a key. Deletes."
      },
      {
       "name": "kv_list",
       "text": "Lists keys or key and value pairs by pattern."
      },
      {
       "name": "kv_incr",
       "text": "Increases a stored number. Writes."
      },
      {
       "name": "kv_decr",
       "text": "Decreases a stored number. Writes."
      },
      {
       "name": "kv_add",
       "text": "Adds to a stored value (sums numbers or appends to lists). Writes."
      },
      {
       "name": "kv_update",
       "text": "Sets fields inside a stored object. Writes."
      },
      {
       "name": "kv_remove",
       "text": "Removes fields from a stored object. Writes."
      },
      {
       "name": "kv_expire",
       "text": "Makes a key expire after N seconds. Writes."
      },
      {
       "name": "kv_expire_at",
       "text": "Makes a key expire at a set time. Writes."
      },
      {
       "name": "puter_docs_index",
       "text": "Loads the index of the Puter.js docs."
      },
      {
       "name": "puter_docs_get",
       "text": "Fetches one Puter.js docs page as Markdown."
      }
     ]
    }
   ]
  },
  {
   "id": "data",
   "nav": "Data and license",
   "h2": "What it sends and its license",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Sends",
       "v": "File contents, site files, worker code and stored values the assistant sends, plus your Puter token",
       "sub": "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."
      },
      {
       "l": "Sends",
       "v": "Published sites and deployed functions",
       "sub": "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."
      },
      {
       "l": "Sends",
       "v": "File contents the tools read",
       "sub": "To Your AI assistant and its model provider; Each read tool call. Opt out: Keep private files out of folders the assistant reads."
      }
     ]
    },
    {
     "t": "prose",
     "text": "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."
    },
    {
     "t": "rows",
     "rows": [
      {
       "l": "In a paid app",
       "v": "With conditions",
       "status": "cond",
       "sub": "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.",
       "quote": "This repository, including all its contents, sub-projects, modules, and components, is licensed under AGPL-3.0 unless explicitly stated otherwise.",
       "src": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/README.md"
      },
      {
       "l": "Pass on its files",
       "v": "With conditions",
       "status": "cond",
       "sub": "Copies of the code stay under AGPL-3.0 with source available.",
       "quote": "GNU AFFERO GENERAL PUBLIC LICENSE",
       "src": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/LICENSE.txt"
      },
      {
       "l": "client-work",
       "v": "With conditions",
       "status": "cond",
       "sub": "Work in the client's own Puter account with their sign-in; the server always acts as the signed-in user.",
       "quote": "Two ways, both running as the caller - the Worker holds no credentials of its own",
       "src": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/README.md"
      }
     ]
    }
   ]
  },
  {
   "id": "alive",
   "nav": null,
   "spy_as": "data",
   "h2": "Is it alive",
   "parts": [
    {
     "t": "rows",
     "rows": [
      {
       "l": "Latest version",
       "v": "1.0.1 in the registry, updated Jun 13, 2026"
      },
      {
       "l": "Last release",
       "v": "Registry entry 1.0.1 (published 2026-06-13); hosted, the code at the pinned commit is from 2026-11-10"
      },
      {
       "l": "Remote endpoint",
       "v": "yes: https://mcp.puter.com/ answered an unauthenticated HEAD with HTTP 404 (JSON) on 2026-11-10; the MCP endpoint takes POST",
       "status": "yes"
      }
     ]
    }
   ]
  },
  {
   "id": "alternatives",
   "nav": "Alternatives",
   "h2": "Alternatives",
   "parts": [
    {
     "t": "alts",
     "items": [
      {
       "name": "Puter",
       "me": true,
       "facts": [
        "44.2K stars",
        "Remote"
       ]
      },
      {
       "name": "netlify",
       "why": "Pick it if you deploy full web projects with a build step",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "cloudflare-workers",
       "why": "Pick it if you need serverless code at the edge in several languages",
       "path": null,
       "facts": [
        "Local"
       ]
      },
      {
       "name": "Computer",
       "why": "Pick it if the assistant needs its own persistent machine with a shell",
       "path": "mcp/servers/io-github-pollinations-computer/",
       "facts": [
        "5,310 stars",
        "Remote"
       ]
      }
     ],
     "more": "All files and documents servers",
     "more_path": "mcp/files/"
    }
   ]
  },
  {
   "id": "start",
   "nav": "Get started",
   "h2": "Get started",
   "parts": [
    {
     "t": "prompt",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "Connect it"
    },
    {
     "t": "tabs",
     "label": "Connect by client",
     "items": [
      {
       "tab": "Claude Code",
       "code": "claude mcp add --transport http --scope user puter https://mcp.puter.com/"
      },
      {
       "tab": "Cursor",
       "code": "{\n  \"mcpServers\": {\n    \"puter\": {\n      \"url\": \"https://mcp.puter.com/\"\n    }\n  }\n}\n"
      },
      {
       "tab": "Any client (JSON)",
       "code": "{\n  \"mcpServers\": {\n    \"mcp-server\": {\n      \"url\": \"https://mcp.puter.com/\"\n    }\n  }\n}"
      }
     ]
    },
    {
     "t": "small",
     "text": "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."
    },
    {
     "t": "h3",
     "text": "Mistakes to avoid"
    },
    {
     "t": "mistakes",
     "items": [
      {
       "dont": "fs_write_file {\"path\": \"/portfolio/index.html\", ...}",
       "fix": "Call whoami, then use ~/portfolio/index.html or /<username>/portfolio/index.html",
       "why": "Every path lives under your home folder; bare root paths are rejected."
      },
      {
       "dont": "Base64-encode a large local file into fs_write_file",
       "fix": "fs_start_upload, run the returned upload_command, then fs_complete_upload",
       "why": "Inline content goes through the chat and fails past the client's message size limit."
      },
      {
       "dont": "Assume the file exists after the PUT upload finishes",
       "fix": "Call fs_complete_upload; call fs_abort_upload if the upload failed",
       "why": "The file is created only when the upload is completed."
      },
      {
       "dont": "Look for a workers_update tool to change a deployed function",
       "fix": "Write the new code to the worker's source file with fs_write_file",
       "why": "There is no separate update call."
      },
      {
       "dont": "fs_delete on a folder to remove one file inside it",
       "fix": "Pass the exact file path, or recursive false for a folder",
       "why": "Folders are deleted with everything in them by default."
      }
     ]
    }
   ]
  },
  {
   "id": "faq",
   "nav": "Questions",
   "h2": "Questions",
   "parts": [
    {
     "t": "faq",
     "items": [
      {
       "q": "Do I install anything?",
       "a": "No. The server is hosted; add its address in your assistant and sign in with Puter.",
       "evidence": {
        "url": "https://docs.puter.com/mcp/index.md",
        "quote": "There's nothing to install or run yourself."
       }
      },
      {
       "q": "Where do published sites live?",
       "a": "At an address like name.puter.site, served from a folder in your Puter files.",
       "evidence": {
        "url": "https://docs.puter.com/mcp/index.md",
        "quote": "hosting_create: Publish a static website, served at"
       }
      },
      {
       "q": "Does unpublishing a site delete my files?",
       "a": "No. hosting_delete removes the address, not the files; deleting a worker also leaves its source file.",
       "evidence": {
        "url": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/README.md",
        "quote": "Unpublish a website (deletes the subdomain, not the files)."
       }
      },
      {
       "q": "Can I run the server myself?",
       "a": "Yes. The code is in the Puter repo and deploys as a Cloudflare Worker, also against a self-hosted Puter.",
       "evidence": {
        "url": "https://github.com/HeyPuter/puter/blob/2084587885633ebe5d44484243da718ca62aaf7d/src/mcp-connector/README.md",
        "quote": "To target a self-hosted Puter instance, set puter_endpoint / puter_gui_origin (uncomment the [vars] block in wrangler.toml)."
       }
      }
     ]
    }
   ]
  }
 ],
 "glance": [
  [
   "Registry name",
   "com.puter/mcp-server"
  ],
  [
   "Category",
   "Files and documents"
  ],
  [
   "Version",
   "1.0.1"
  ],
  [
   "Remote endpoint",
   "https://mcp.puter.com/"
  ],
  [
   "License",
   "AGPL-3.0"
  ],
  [
   "GitHub",
   "HeyPuter/puter"
  ],
  [
   "In the registry since",
   "Jun 13, 2026"
  ],
  [
   "Works with",
   "Claude Code, OpenAI Codex, OpenCode, LangChain, n8n, LangGraph"
  ]
 ],
 "good": [
  "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."
 ],
 "checked_line": "Read by AgentGid from 11 pages and files at one commit, checked Nov 10, 2026; stars update daily.",
 "logo": "https://agentgid.com/media/avatars/heyputer.png"
}