mcp-server · heyputer — Claude Code MCP server: Puter access
Connects your AI agent to Puter for files, websites and workers. Useful when the project already lives in Puter's cloud.
claude mcp add --transport http mcp-server https://mcp.puter.com/What mcp-server does
mcp-server is an MCP server from HeyPuter that lets AI tools talk to Puter. The agent manages files, websites and workers from the chat instead of you clicking through the dashboard.
It is a remote HTTP server at https://mcp.puter.com/, so there is nothing to install locally. Claude takes one command; Cursor and GitHub Copilot take a JSON block in their MCP config. Codex, Cline, Zed and Windsurf connect the same way.
The repository is AGPL-3.0. That matters if you fork Puter itself rather than just pointing a client at the hosted endpoint. For plain use through https://mcp.puter.com/ the license does not get in the way.
What it helps with
- upload a file to Puter storage from the agent chat
- publish a site and confirm it loads
- start a worker and check its status
- list what is inside a remote folder
- wire an AI agent to cloud storage without manual exports
Example prompts for the agent
- List the files in my Puter folder
- Publish this site through Puter and give me the link
- Start the worker and tell me if it fails
How to install mcp-server
Platform CLI: remote server
claude mcp add --transport http mcp-server https://mcp.puter.com/Platform CLI: remote server
codex mcp add mcp-server --url https://mcp.puter.com/Config file
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.puter.com/"
}
}
}Config file
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.puter.com/"
}
}
}Platform CLI: remote server
gemini mcp add -t http mcp-server https://mcp.puter.com/Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.puter.com/. The server is remote, so no extra packages are needed.
What does mcp-server do?
It gives an AI agent access to Puter: file management, websites and workers. The agent does this from the chat, without opening the web dashboard.
How do I add mcp-server to Cursor or GitHub Copilot?
Both use a JSON block in the MCP config. Cursor uses the mcpServers key, GitHub Copilot uses servers with a type field and the URL https://mcp.puter.com/.
