Pond MCP server

pond-mcp is a Model Context Protocol server that exposes pond control-plane operations as tools. Claude Code, Cursor, and other MCP clients can call them directly so an agent can list deploys, edit source, rebuild, tail logs, and manage env vars without shelling out.

Install

pond-mcp ships in the pondsh package as a second bin entry.

npm i -g pondsh   # or: npx -p pondsh pond-mcp

Auth

The server reuses the credentials your local pond CLI already stored at ~/.pond/credentials.json (created by pond login). By default it talks to https://pond.run. Override either piece:

POND_MCP_API=https://my-host.example.com
POND_MCP_TOKEN=<bearer> (bypasses the credentials file)

Wire it into Claude Code

claude mcp add pond pond-mcp

Or, in ~/.claude.json:

{
  "mcpServers": {
    "pond": {
      "command": "pond-mcp"
    }
  }
}

Tools

Tool	Description
`list_deploys`	List deploys owned by the current user (id, url, status, createdAt).
`deploy_files`	List files in a deploy's source tree.
`read_file`	Read a source file (e.g. `server/index.ts`).
`write_file`	Overwrite a source file. Pair with `build_deploy` to apply.
`build_deploy`	Rebuild the bundle from current source. Returns hash + size.
`tail_logs`	Return the last N log entries (default 100).
`env_list`	List env keys (masked values).
`env_set`	Set / update an env var. Triggers a host-side rebuild + restart.

Reference impl

See src/mcp/server.ts.

#Pond MCP server

#Install

#Auth

#Wire it into Claude Code