Agentic Workflows (MCP)

USER> start a visual regression job for https://staging.myapp.com against stored baselines

AGENT> I'll trigger a visual regression job using the RegressionBot MCP.

TOOL> [run_regression_job]
  testOrigin: "https://staging.myapp.com"
  project:    "myapp"
  devices:    ["Desktop Chrome", "iPhone 12"]

TOOL RESULT> {
    "message": "Job started",
    "jobId": "6ee84bac-40de-44cc-8dca-4760ab108153"
  }

TOOL> [get_job_status] jobId: "6ee84bac-40de-44cc-8dca-4760ab108153", waitSeconds: 25

# The call held open for 25s and the job is still going. Call again —
# no sleep needed in between.
TOOL RESULT> {
    "jobId": "6ee84bac-40de-44cc-8dca-4760ab108153",
    "status": "COMPLETED",
    "readyForSummary": false,
    "isComplete": true,
    "summaryStatus": "PROCESSING",
    "progress": { "total": 6, "completed": 6, "percent": "100.00" },
    "executionTime": 41
  }

TOOL> [get_job_status] jobId: "6ee84bac-40de-44cc-8dca-4760ab108153", waitSeconds: 25

# Returned as soon as the summaries landed, without using the full 25s.
TOOL RESULT> {
    "jobId": "6ee84bac-40de-44cc-8dca-4760ab108153",
    "status": "COMPLETED",
    "readyForSummary": true,
    "isComplete": true,
    "summaryStatus": "COMPLETE",
    "progress": { "total": 6, "completed": 6, "percent": "100.00" },
    "executionTime": 48
  }

TOOL> [get_job_summary] jobId: "6ee84bac-40de-44cc-8dca-4760ab108153", regressionsOnly: true

TOOL RESULT> {
    "regressionCount": 2,
    "matchCount": 4,
    "newBaselineCount": 0,
    "regressions": [
      {
        "url": "https://staging.myapp.com/pricing",
        "variantName": "Desktop Chrome",
        "status": "SUCCESS",
        "diffPercentage": 3.64,
        "visualMatchScore": 96.36,
        "changed": true,
        "isNewBaseline": false,
        "regressionbotSummary": [
          {"label":"","text":"The Pro tier card gets a highlighted border and a blue call-to-action button."},
          {"label":"A","text":"background-color: rgb(156, 163, 175) → rgb(37, 99, 235)"}
        ],
        "diffUrl": "https://screenshots.regressionbot.com/r/token"
      },
      {
        "url": "https://staging.myapp.com/pricing",
        "variantName": "iPhone 12",
        "status": "SUCCESS",
        "diffPercentage": 5.12,
        "visualMatchScore": 94.88,
        "changed": true,
        "isNewBaseline": false,
        "regressionbotSummary": [
          {"label":"","text":"The Pro tier card gets a highlighted border and a blue call-to-action button."},
          {"label":"A","text":"background-color: rgb(156, 163, 175) → rgb(37, 99, 235)"}
        ],
        "diffUrl": "https://screenshots.regressionbot.com/r/token"
      }
    ]
  }

AGENT> The job completed in 48 seconds. I found 2 regressions:

• /pricing [Desktop Chrome] — 3.64% of the page
  The Pro tier card's button background changed from grey (rgb(156, 163, 175))
  to blue (rgb(37, 99, 235)), and the card gained a highlighted border.

• /pricing [iPhone 12] — 5.12% of the page
  The same button colour and card border change as on desktop.

AGENT> The other 4 pages matched their baselines exactly.
AGENT> Would you like me to fetch the regression images and review them before approving?

USER> yes, look at the pricing regression and tell me if the changes look intentional

AGENT> [reading changes for /pricing Desktop Chrome, fetching currentUrl and cropping each box...]
AGENT> I can see both changed regions.
AGENT> The regressions are clearly intentional:
- The Pro plan card now has a visible border and background highlight
- The "Get started" button changed from grey to blue
- No layout shifts, broken text, or clipped elements

AGENT> This looks like a deliberate design update. Safe to approve.

USER> approve it

TOOL> [approve_job] jobId: "6ee84bac-40de-44cc-8dca-4760ab108153"

TOOL RESULT> {
    "message": "Job approved",
    "approvedCount": 2,
    "failedCount": 0
  }

AGENT> Done. The 2 updated screenshots have been promoted to new baselines.
AGENT> Future jobs will compare against the new design.

USER> Check the UI for regressions. The PR updates the header background to blue.

AGENT> I'll run the regression job and pass the developer's intent via runContext so the AI can automatically classify the change.

TOOL> [run_regression_job]
  project:    "myapp"
  runContext: { "prDescription": "The PR updates the header background to blue." }

TOOL RESULT> { "message": "Job started", "jobId": "a1b2c3d4-..." }

AGENT> [get_job_status with waitSeconds: 25 until readyForSummary is true...]
AGENT> The summaries are ready. I'll read the verdict.

TOOL> [get_job_summary] jobId: "a1b2c3d4-...", regressionsOnly: true

TOOL RESULT> {
    "regressionCount": 1,
    "intentAssessment": {
      "decision": "pass",
      "intentProvided": true,
      "bugCount": 0,
      "intentionalCount": 1,
      "noiseCount": 0,
      "needsReviewCount": 0,
      "allAccountedFor": true,
      "summary": "All 1 regression(s) match the stated intent. Safe to approve."
    },
    "regressions": [
      {
        "url": "https://staging.myapp.com/",
        "variantName": "Desktop Chrome",
        "verdict": {
          "decision": "intentional",
          "minConfidence": 0.94,
          "basis": "measured",
          "reasoning": "The header background-color changed from #ffffff to #1d4ed8 and nothing else moved.",
          "coveredBy": "updates the header background to blue"
        }
      }
    ]
  }

AGENT> intentAssessment.decision is "pass": the one changed page has a verdict of
AGENT> "intentional" that quotes your intent back. Nothing sits at bug or needs_review.
AGENT> I can approve the job, or you can open the inspect view first.

USER> test the PR preview against baselines on desktop, mobile, and tablet

AGENT> I'll start 3 parallel jobs — one per device — then poll all of them.

TOOL> [run_regression_job] project: "myapp", devices: ["Desktop Chrome"]
TOOL RESULT> { "jobId": "31c66aa4-5bd7-4df1-a8e3-1394d77a33f9" }

TOOL> [run_regression_job] project: "myapp", devices: ["iPhone 12"]
TOOL RESULT> { "jobId": "1a597938-b08e-4417-9802-cbb457870c96" }

TOOL> [run_regression_job] project: "myapp", devices: ["iPad Mini"]
TOOL RESULT> { "jobId": "d5452cb0-6b7a-4186-a0b1-0e23204a31e3" }

TOOL> [get_job_status] jobId: "31c66aa4-5bd7-4df1-a8e3-1394d77a33f9"
TOOL RESULT> { "status": "PROCESSING", "isComplete": false, "progress": { "total": 3, "completed": 1, "percent": "33.33" } }
TOOL> [get_job_status] jobId: "1a597938-b08e-4417-9802-cbb457870c96"
TOOL RESULT> { "status": "PROCESSING", "isComplete": false, "progress": { "total": 3, "completed": 2, "percent": "66.67" } }
TOOL> [get_job_status] jobId: "d5452cb0-6b7a-4186-a0b1-0e23204a31e3"
TOOL RESULT> { "status": "PROCESSING", "isComplete": false, "progress": { "total": 3, "completed": 0, "percent": "0.00" } }
...
TOOL> [get_job_status] jobId: "31c66aa4-5bd7-4df1-a8e3-1394d77a33f9"
TOOL RESULT> { "status": "COMPLETED", "isComplete": true, "progress": { "total": 3, "completed": 3, "percent": "100.00" } }
TOOL> [get_job_status] jobId: "1a597938-b08e-4417-9802-cbb457870c96"
TOOL RESULT> { "status": "COMPLETED", "isComplete": true, "progress": { "total": 3, "completed": 3, "percent": "100.00" } }
TOOL> [get_job_status] jobId: "d5452cb0-6b7a-4186-a0b1-0e23204a31e3"
TOOL RESULT> { "status": "COMPLETED", "isComplete": true, "progress": { "total": 3, "completed": 3, "percent": "100.00" } }

TOOL> [get_job_summary] jobId: "31c66aa4-5bd7-4df1-a8e3-1394d77a33f9", regressionsOnly: true
TOOL RESULT> {
    "regressionCount": 1,
    "regressions": [{ "url": "https://staging.myapp.com/about", "variantName": "Desktop Chrome", "diffPercentage": 1.8, "regressionbotSummary": [{ "label": "A", "text": "\"Meet the team\" → \"Meet our team\"" }] }]
  }
TOOL> [get_job_summary] jobId: "1a597938-b08e-4417-9802-cbb457870c96", regressionsOnly: true
TOOL RESULT> {
    "regressionCount": 1,
    "regressions": [{ "url": "https://staging.myapp.com/about", "variantName": "iPhone 12", "diffPercentage": 2.4, "regressionbotSummary": [{ "label": "A", "text": "\"Meet the team\" → \"Meet our team\"" }] }]
  }
TOOL> [get_job_summary] jobId: "d5452cb0-6b7a-4186-a0b1-0e23204a31e3", regressionsOnly: true
TOOL RESULT> { "regressionCount": 0, "regressions": [] }

AGENT> Results across all devices:

• /about  [Desktop Chrome]  — 1.8% of the page
  Heading text changed: "Meet the team" → "Meet our team"

• /about  [iPhone 12]          — 2.4% of the page
  The same heading edit as on desktop.

AGENT> • All tablet pages matched baselines.

USER> what was the result of the last job for the myapp project?

TOOL> [list_jobs] project: "myapp", limit: 10

TOOL RESULT> {
    "jobs": [
      {
        "jobId": "6ee84bac-40de-44cc-8dca-4760ab108153",
        "project": "myapp",
        "status": "APPROVED",
        "totalUrls": 6,
        "completedCount": 6,
        "createdAt": "2026-05-19T10:53:26.000Z",
        "finishedAt": "2026-05-19T10:54:14.000Z"
      },
      {
        "jobId": "e69062bb-f140-40e7-a3e8-40f84deadcdb",
        "project": "myapp",
        "status": "COMPLETED",
        "totalUrls": 6,
        "completedCount": 6,
        "createdAt": "2026-05-17T13:22:01.000Z",
        "finishedAt": "2026-05-17T13:22:06.000Z"
      }
    ]
  }

AGENT> Most recent: job 6ee84bac — APPROVED, 6 pages tested, finished ~1 hour ago.
AGENT> The job before that is COMPLETED but not yet approved (2 regressions pending).

USER> start a regression job for myapp

AGENT> I'll create the project on the initial job and capture baselines.

TOOL> [run_regression_job]
  project:    "myapp"
  testOrigin: "https://www.myapp.com"
  devices:    ["Desktop Chrome", "iPhone 12"]
  paths:      [{"path":"/"}, {"path":"/pricing"}, {"path":"/docs"}]
  autoApprove: true

TOOL RESULT> { "message": "Job started", "jobId": "a1b2c3d4-..." }

AGENT> Baselines are being captured for 3 pages on desktop and mobile.
AGENT> The configuration is now saved as project "myapp". Future jobs are locked to these parameters.

---

USER> start a regression job for myapp

TOOL> [run_from_project] name: "myapp"

TOOL RESULT> { "message": "Job started", "jobId": "e5f6a7b8-...", "project": "myapp" }

AGENT> Job started using stored config — testOrigin myapp.com, Desktop Chrome + iPhone 12, 3 paths.

---

USER> what projects do I have?

TOOL> [list_projects]

TOOL RESULT> {
  "projects": [
    {
      "name": "myapp",
      "testOrigin": "https://www.myapp.com",
      "devices": ["Desktop Chrome", "iPhone 12"],
      "lastRunAt": "2026-06-02T10:15:00.000Z",
      "lastJobId": "e5f6a7b8-..."
    }
  ]
}