Puter MCP Server: Setup for Claude Code, Cursor and Other Apps

• Shows which Puter account you are signed in as

  Returns your username, account id and home folder. The assistant uses it to build correct file paths.

  Try: “Which Puter account am I connected as?”

  Network · whoami

• Lists what is inside a Puter folder

  Lists the files and folders inside a directory in your Puter storage.

  Try: “List everything in my Puter Desktop folder.”

  Network · fs_readdir

• Reads a file from your Puter storage

  Reads a file as text or as base64. You can read just a slice of a large file.

  Try: “Read ~/notes/todo.txt and summarize it.”

  Network · fs_read_file

• Shows size, type and dates for a file or folder

  Returns details about one file or folder without reading its content.

  Try: “How big is ~/backups/site.zip and when did it change?”

  Network · fs_stat

• Creates or overwrites a file with text you give it

  Writes the content you pass in to a file, replacing it if it exists. Content travels inside the chat, so it suits small files.

  Try: “Create ~/site/index.html with a simple landing page.”

  Write · fs_write_file

• Starts an upload of a big local file

  Returns a one-time upload link and a command for sending a file from your computer straight to Puter, so the file never passes through the chat.

  Try: “Upload ./build.zip from this machine to ~/uploads/build.zip.”

  Write · fs_start_upload

• Finishes an upload you started

  Completes the upload and creates the file in Puter. The file does not exist until this step succeeds.

  Try: “The upload command finished, so complete the upload.”

  Write · fs_complete_upload

• Cancels an upload that failed

  Releases an upload session without creating a file.

  Try: “The upload failed, so cancel it.”

  Write · fs_abort_upload

• Creates a folder

  Creates a directory and, if you ask, any missing parent folders.

  Try: “Create ~/projects/demo/assets.”

  Write · fs_mkdir

• Copies a file or folder

  Copies a file or folder to another place in your Puter storage.

  Try: “Copy ~/site to ~/site-backup.”

  Write · fs_copy

• Moves a file or folder

  Moves a file or folder to a new location. It also renames.

  Try: “Move ~/drafts/post.md into ~/blog.”

  Write · fs_move

• Renames a file or folder in place

  Gives a file or folder a new name without moving it.

  Try: “Rename ~/notes/old.txt to ~/notes/plan.txt.”

  Write · fs_rename

• Deletes a file or a whole folder

  Deletes a file or folder. Folders are deleted with everything inside by default.

  Try: “Delete ~/tmp and everything in it.”

  Delete · fs_delete

• Lists your published websites

  Lists the websites you have published on Puter subdomains.

  Try: “Which websites have I published on Puter?”

  Network · hosting_list

• Shows one published website

  Returns the details of a website by its subdomain, including which folder it serves.

  Try: “Which folder does my "demo" site serve?”

  Network · hosting_get

• Publishes a folder as a website

  Creates a subdomain that serves a folder from your Puter storage as a static website.

  Try: “Publish ~/site at the subdomain "my-demo".”

  Write · hosting_create

• Points a website at a different folder

  Changes which folder a published website serves.

  Try: “Switch "my-demo" to serve ~/site-v2.”

  Write · hosting_update

• Takes a website offline

  Removes the subdomain. The files in your storage stay where they are.

  Try: “Unpublish the "my-demo" site.”

  Delete · hosting_delete

• Lists your serverless workers

  Lists the workers you have deployed.

  Try: “List my deployed Puter workers.”

  Network · workers_list

• Shows one worker

  Returns a worker's name, public address and source file.

  Try: “Show me the details of the "api" worker.”

  Network · workers_get

• Deploys a worker from a JavaScript file

  Deploys a serverless function from a file in your storage and returns its public address.

  Try: “Deploy ~/workers/api.js as a worker called "api".”

  Write · workers_create

• Calls a worker as you

  Sends an HTTP request to one of your workers, signed in as your account.

  Try: “Call the "api" worker at /hello and show the reply.”

  Network · workers_exec

• Takes a worker offline

  Removes a deployed worker. Its source file stays in your storage.

  Try: “Undeploy the "api" worker.”

  Delete · workers_delete

• Lists the apps you own

  Lists the apps registered in your account with their address, icon and usage numbers.

  Try: “List my Puter apps and how many people opened each.”

  Network · apps_list

• Shows one app

  Returns an app by name. You can ask for detailed open and user counts over a time window.

  Try: “How many users opened "notes-app" last month?”

  Network · apps_get

• Checks if an app name is free

  Tells you whether an app name is available before you create the app.

  Try: “Is the name "pixel-pad" available for a new app?”

  Network · apps_check_name

• Registers a new app

  Creates an app entry with a name and the address Puter should load when the app opens.

  Try: “Register an app called "pixel-pad" that opens my published site.”

  Write · apps_create

• Changes an app

  Updates only the fields you pass, and can rename the app.

  Try: “Rename the app "pixel-pad" to "pixel-studio".”

  Write · apps_update

• Deletes an app

  Removes the app from your account. The site or worker it pointed to stays.

  Try: “Delete the app "pixel-pad".”

  Delete · apps_delete

• Reads a saved value

  Reads one key from your Puter key-value store. A missing key comes back empty.

  Try: “What is stored under the key "settings"?”

  Network · kv_get

• Lists saved keys

  Lists keys, or key and value pairs, that match a pattern, one page at a time.

  Try: “List all keys that start with "user:".”

  Network · kv_list

• Saves a value

  Creates or overwrites a key. You can give it an expiry time.

  Try: “Save {"theme":"dark"} under "settings".”

  Write · kv_set

• Deletes a saved value

  Deletes one key from the store.

  Try: “Delete the key "settings".”

  Delete · kv_del

• Adds to a number

  Increases a stored number, or numbers at given paths inside an object.

  Try: “Add 1 to the counter "visits".”

  Write · kv_incr

• Subtracts from a number

  Decreases a stored number, or numbers at given paths inside an object.

  Try: “Subtract 1 from the counter "stock".”

  Write · kv_decr

• Adds to a stored value

  Adds to what is stored: numbers are summed and lists get new items.

  Try: “Append "blue" to the list under "colors".”

  Write · kv_add

• Changes parts of a stored object

  Sets specific fields inside a stored object and leaves the rest alone.

  Try: “Set profile.bio to "Maker" in the "user" record.”

  Write · kv_update

• Removes fields from a stored object

  Removes chosen fields from a stored object.

  Try: “Remove profile.bio from the "user" record.”

  Delete · kv_remove

• Makes a key expire after some seconds

  Sets a key to disappear after a number of seconds.

  Try: “Make "session" expire in 10 minutes.”

  Write · kv_expire

• Makes a key expire at a set time

  Sets a key to disappear at a specific time.

  Try: “Make "promo" expire at midnight on December 31.”

  Write · kv_expire_at

• Used by the assistant behind the scenes

  Lists the Puter developer docs

  Loads the index of Puter's developer documentation so the assistant can pick a topic.

  Try: “What topics does the Puter developer documentation cover?”

  Network · puter_docs_index

• Opens one Puter docs page

  Fetches a documentation page as Markdown by its topic path.

  Try: “Show me the Puter docs page about worker routers.”

  Network · puter_docs_get

Watch out for

• It can delete files, sites, workers and apps

  fs_delete removes folders with everything inside by default. Ask the assistant to list what it will remove and approve each delete. github.com

• No read-only mode is documented

  You cannot connect with read access only. Use a separate Puter account for experiments if you want a safe test space. github.com

• A pasted token acts like your password

  The bearer token route gives full access to your account. The README says to treat it like a password; the sign-in route avoids copying it. github.com

• Workers run code the assistant writes

  Deploying a worker publishes JavaScript that runs on Puter and can use your account. Read the file before you let it deploy. github.com

• Deleting a site or app leaves the files

  Unpublishing a website, undeploying a worker or deleting an app keeps the source files in your storage. github.com

Security advisories