Skip to main content
🎉 A11y Issue Detection Agent is now live! Detect accessibility issues like a WCAG expert with AI. Try now!
No Result Found
Get your setup working faster. Join our Discord for optimisation tips from elite testers. Join our DiscordJoin our Discord

BrowserStack Accessibility with the MCP server

Use natural language prompts to run accessibility scans and get accessibility guidance for web and mobile apps with the BrowserStack MCP server.

Use the BrowserStack MCP server to run accessibility scans and get accessibility guidance for web and mobile apps directly from your AI assistant, such as GitHub Copilot, Claude, or Cursor. Skip the dashboard and test accessibility with prompts.

To set up the server, see get started with the BrowserStack MCP server.

To use Accessibility tools on the BrowserStack MCP server, you need a BrowserStack Accessibility license. Contact BrowserStack support to enable a license for your account.

Streamline accessibility testing from your IDE

Use the following tools to run accessibility scans and get expert answers about WCAG, usability, and best practices, all through natural language prompts:

Run accessibility scan (startAccessibilityScan)

Use the startAccessibilityScan tool to start accessibility scans for any website or app. This is the primary tool for automated accessibility checks.

The following example shows GitHub Copilot in VS Code calling the startAccessibilityScan tool:

GitHub Copilot prompt that starts an accessibility scan and the resulting startAccessibilityScan tool call

Ask accessibility expert (accessibilityExpert)

Use the accessibilityExpert tool to get expert answers about WCAG guidelines, usability, and accessibility best practices for your web or mobile app.

The following example shows GitHub Copilot in VS Code calling the accessibilityExpert tool:

GitHub Copilot prompt asking the accessibilityExpert tool an accessibility question and its response

Tool reference

Use the startAccessibilityScan tool to run automated accessibility checks, and the accessibilityExpert tool to get expert guidance on accessibility standards and best practices.

Example prompt Description Input parameters Invoked tool
Run accessibility scan for “www.example.com” Start a web accessibility scan and get a result link for the tested website. • Website URL (required)
• Scan type (optional)
• Device or OS (optional)
startAccessibilityScan
What WCAG guidelines apply to form field error messages on mobile web? Get expert guidance on WCAG 2.0, 2.1, and 2.2, mobile and web usability, and accessibility best practices. • Question (required)
• Context (optional)
• App or website type (optional)
accessibilityExpert

Common workflows

The BrowserStack MCP server supports the following workflows for complex testing scenarios. Each workflow shows the sequence of tools and automated actions.

Ensure you have active licenses for all the BrowserStack products in your workflows, such as Accessibility, App Automate, and Automate, before running these prompts. Contact BrowserStack support to enable a license for your account.

Accessibility scans, report download, fixes, and accessibility expert

Catch accessibility issues on public or gated pages and fix them.

Tools invoked: startAccessibilityScan, createAccessibilityAuthConfig, getAccessibilityAuthConfig, accessibilityExpert

Example prompts:

  • “Run accessibility scan [scan name] for [URL] using auth [auth name].”

  • “Run an accessibility scan on [URL] and fix the errors it finds.”

  • “What WCAG rules apply for error message contrast on mobile web?”

The MCP server performs the following actions:

  1. Runs a scan using startAccessibilityScan on your specified URL.

  2. Reviews critical issues and downloads the detailed accessibility report.

  3. Fixes the issues with Copilot, using the fixes suggested in the scan report.

  4. Clarifies WCAG rules using accessibilityExpert for specific compliance questions.

For more help, see the following pages:

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked





Thank you for your valuable feedback!

Talk to an Expert
Download Copy Check Circle