MCP

Appearance

Sample Session ​

The following is an example of a real conversation with an AI assistant that has the QualiBooth MCP server connected. It shows the natural language prompts a user might type, the tools the AI calls behind the scenes, and the kind of results returned.

Auditing a site for accessibility issues ​

User

Which organisations do I have access to?

AI calls: get_organizations

Result:

json
[
  { "uuid": "a1b2c3d4-0001-0001-0001-000000000001", "name": "Acme Corp", "role": "Admin", "isDemo": false },
  { "uuid": "a1b2c3d4-0002-0002-0002-000000000002", "name": "Demo Organisation", "role": "Admin", "isDemo": true }
]

AI responds:

You have access to two organisations: Acme Corp (Admin) and a demo organisation. Which one would you like to work with?

User

Acme Corp. Show me the projects — I'm looking for the main marketing site.

AI calls: get_projects with orgUuid: "a1b2c3d4-0001-0001-0001-000000000001", search: "marketing"

Result:

json
[
  {
    "uuid": "b2c3d4e5-0001-0001-0001-000000000001",
    "name": "Marketing Site",
    "score": 74,
    "hasScheduledScans": true
  }
]

AI responds:

Found one match: Marketing Site, current score 74/100. It has scheduled scans active. Want me to pull up its scan configurations?

User

Yes, and show me the most recent run.

AI calls: list_scan_configs with projUuid: "b2c3d4e5-0001-0001-0001-000000000001"

Result:

json
[
  {
    "uuid": "c3d4e5f6-0001-0001-0001-000000000001",
    "name": "Daily Scan",
    "frequency": "DAILY",
    "status": "ACTIVE",
    "details": { "score": 74, "lastRun": "2026-05-27T03:00:00Z", "urls": 86 }
  },
  {
    "uuid": "c3d4e5f6-0002-0002-0002-000000000002",
    "name": "On Demand",
    "frequency": "ON_DEMAND",
    "status": "ACTIVE",
    "details": { "score": 71, "lastRun": "2026-05-20T10:14:00Z", "urls": 86 }
  }
]

AI calls: list_scan_runs with scanConfigUuid: "c3d4e5f6-0001-0001-0001-000000000001"

Result:

json
[
  {
    "uuid": "d4e5f6a7-0001-0001-0001-000000000001",
    "createdAt": "2026-05-27T03:00:00Z",
    "finishedAt": "2026-05-27T03:18:42Z",
    "running": false,
    "scannedUrls": 86,
    "details": {
      "desktopScore": 74,
      "mobileScore": 71,
      "desktopCriticalViolations": 3,
      "desktopHighViolations": 47,
      "mobileCriticalViolations": 5,
      "mobileHighViolations": 52
    }
  }
]

AI responds:

The latest Daily Scan ran on 27 May 2026 and covered 86 URLs in about 18 minutes.

DesktopMobile
Score7471
Critical violations35
High violations4752

Mobile is slightly worse. Want me to find the pages with the most high-severity issues?

User

Yes, show me the worst 5 pages.

AI calls: list_urls_in_run with scanRunUuid: "d4e5f6a7-0001-0001-0001-000000000001", count: 5, sort: ["high,DESC"]

Result:

json
[
  { "uuid": "e5f6a7b8-0001", "url": "https://www.example.com/products", "score": 41, "critical": 1, "high": 12, "medium": 6, "low": 3 },
  { "uuid": "e5f6a7b8-0002", "url": "https://www.example.com/about", "score": 55, "critical": 0, "high": 9, "medium": 4, "low": 2 },
  { "uuid": "e5f6a7b8-0003", "url": "https://www.example.com/contact", "score": 58, "critical": 1, "high": 8, "medium": 3, "low": 1 },
  { "uuid": "e5f6a7b8-0004", "url": "https://www.example.com/blog", "score": 62, "critical": 0, "high": 7, "medium": 5, "low": 4 },
  { "uuid": "e5f6a7b8-0005", "url": "https://www.example.com/careers", "score": 63, "critical": 0, "high": 6, "medium": 2, "low": 1 }
]

AI responds:

Here are the 5 worst pages by high-severity violations:

PageScoreCriticalHigh
/products41112
/about5509
/contact5818
/blog6207
/careers6306

The /products page is the most problematic — score of 41 with a critical violation. Want me to drill into the specific rules that are failing there?

User

Yes, dig into /products.

AI calls: get_scanned_url_details with scannedUrlUuid: "e5f6a7b8-0001"

Result (excerpt):

json
{
  "mobile": {
    "violations": [
      {
        "id": "color-contrast",
        "impact": "critical",
        "description": "Elements must meet minimum color contrast ratio thresholds",
        "nodes": 8
      },
      {
        "id": "image-alt",
        "impact": "high",
        "description": "Images must have alternate text",
        "nodes": 5
      },
      {
        "id": "label",
        "impact": "high",
        "description": "Form elements must have labels",
        "nodes": 3
      }
    ]
  },
  "desktop": {
    "violations": [
      {
        "id": "color-contrast",
        "impact": "critical",
        "description": "Elements must meet minimum color contrast ratio thresholds",
        "nodes": 6
      },
      {
        "id": "image-alt",
        "impact": "high",
        "description": "Images must have alternate text",
        "nodes": 5
      }
    ]
  }
}

AI responds:

The /products page has three distinct accessibility issues:

  • Color contrast (critical) — 8 elements on mobile, 6 on desktop fail minimum contrast thresholds. This is the most impactful fix.
  • Missing image alt text (high) — 5 images have no alternative text on both mobile and desktop.
  • Unlabelled form elements (high, mobile only) — 3 form fields are missing labels.

Fixing color contrast alone would likely push this page from 41 to above 60. Want me to check another page or export these results?

Copyright © 2025 QualiBooth