# Puppetflow

Controls remote Puppetflow browser routines directly from AI chat sessions. Helps trigger JavaScript flows, inspect execution logs, and retrieve screenshots.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: puppetflow
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/puppetflow/puppetflow
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/puppetflow

## What it does

Puppetflow connects AI agents to a self-hosted browser automation platform. All automation steps execute on your dedicated instance, so your local machine stays completely unburdened. Your agent searches existing JavaScript routines, initiates new runs, and tracks execution status through streamable HTTP endpoints.

The integration exposes tools to inspect run histories, review full console logs, and download captured session artifacts. Whenever a flow requires human intervention, you can watch the session live and take manual control. Without an active self-hosted instance and an issue-specific access token, the client cannot communicate with the API. Configuration works via Bearer token authentication or remote OAuth with PKCE.

## Requirements
- Needs: Docker
- Remote server: `https://{instance_host}/api/workspaces/{workspace}/mcp-server/http`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add puppetflow --url https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "puppetflow": {
            "url": "https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "puppetflow": {
            "type": "http",
            "url": "https://{instance_host}/api/workspaces/{workspace}/mcp-server/http"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http puppetflow https://{instance_host}/api/workspaces/{workspace}/mcp-server/http
```

## When to use it
- trigger automated browser flows from assistant chat
- retrieve error logs and execution artifacts after a failed run
- download session recordings and captured screenshots
- pass custom parameters into JavaScript workflows

## Example prompts
- Run the onboarding check flow and return the final screenshot
- Inspect the latest workflow run and report any logged failures
- List available browser automations in my workspace and execute the report fetcher

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89899
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32260
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13181
- [apify-mcp-server](https://affpapa.org/en/nevibecode/mcp/apify-mcp-server.md) — MCP server · ★ 13345

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md