stuntman / get started

Up in one prompt.

Paste one line into your coding agent. It starts Stuntman, finds every provider your project calls, points your local configuration at it, proves nothing leaks and hands you every link. It shows you each change before making it.

The fastest way: paste this into your coding agent

Set up Stuntman for this project: read https://edivanteixeira.github.io/stuntman/agent-setup.md and follow it step by step.

It asks which language you prefer, starts Stuntman, finds every provider your project calls, shows you each change before making it and ends with every link ready.

The agent follows agent-setup.md, an open guide you can read first.

Or do it yourself.

1Run it

One container serves the web UI, the HTTP API and MCP. Data lives in one volume.

docker run -d --name stuntman -p 127.0.0.1:8025:8025 \
  -p 127.0.0.1:2525:2525 -p 127.0.0.1:8028:8028 \
  -v stuntman-data:/data edivanteixeira/stuntman

# web UI, /api and /mcp on http://localhost:8025

2Point your app at it

Change base URLs only. Your app keeps its code and every other setting.

WhatsApp (Graph)   http://localhost:8025/whatsapp
SendGrid           http://localhost:8025/sendgrid
SMTP               localhost:2525
HTTP API plugins   http://localhost:8028/<service>
Azure Blob         http://127.0.0.1:10000/<account>
Amazon S3          http://127.0.0.1:9000
OpenTelemetry      http://localhost:4318
OpenAI SDK         http://localhost:8025/openai/v1
Kafka              localhost:9092

3Connect your agent

Claude Code, Codex, Gemini CLI, OpenCode, Cursor or GitHub Copilot over MCP; anything else over HTTP.

claude mcp add --transport http stuntman \
  http://localhost:8025/mcp

4Ask for the hard case

Not the happy path. The agent sets up, provokes, reads and checks, then reports back.

“Make contract uploads fail twice with a 503,
  then tell me whether acme-api recovers.”
No sign-in yet.Anyone who reaches the port can read every message and change every rule. Keep Stuntman on a private network or a VPN, or behind a proxy that authenticates.

More ports, Docker Compose and every setting: getting started and configuration.