# ContextQA Documentation

ContextQA is an AI-powered test automation platform that creates, executes, and maintains browser, mobile, API, and Salesforce tests without requiring test code. The AI agent interprets natural language test steps, locates UI elements using visual AI and DOM analysis, and self-heals broken tests when an application changes.

> **ContextQA:** An AI-powered test automation platform that executes test cases written in natural language against web, mobile, API, and Salesforce applications, producing full evidence packages (screenshots, video, HAR logs, Playwright traces) for every run.

{% hint style="info" %}
**70% less human effort · 10× faster execution · Zero selector maintenance** [**Book a Demo →**](https://contextqa.com/book-a-demo/) — See ContextQA with your application in 30 minutes.
{% endhint %}

***

## What ContextQA Does

ContextQA executes every test through an AI pipeline that handles navigation, element interaction, evidence capture, and self-healing automatically. Tests run on real browsers — Chromium, Firefox, and WebKit.

**Key capabilities:**

* **AI test generation** — create test cases from a URL, Jira ticket, Figma design, OpenAPI spec, video recording, or plain-text requirements
* **Natural language execution** — steps written in plain English execute as full browser interactions
* **Self-healing** — when a UI element moves or changes, the AI finds the new location automatically
* **MCP server** — 67 tools for AI agents (Claude, Cursor, VS Code Copilot) to create, execute, and analyze tests programmatically
* **17 integrations** — Jira, Slack, GitHub Actions, Azure DevOps, Linear, Trello, Teams, and more

***

## Start by Role

{% tabs %}
{% tab title="🧪 Tester" %}
Write tests in plain English, run on real browsers, get video evidence. No code required.

[**→ ContextQA for Testers**](https://learning.contextqa.com/documentation-by-role/by-role/for-testers)
{% endtab %}

{% tab title="⚙️ SDET" %}
67 MCP tools, Playwright export, CI/CD API, full evidence access. Your automation superpowers.

[**→ ContextQA for SDETs**](https://learning.contextqa.com/documentation-by-role/by-role/for-sdets)
{% endtab %}

{% tab title="📋 QA Manager" %}
Test plans, analytics dashboard, flaky detection, shareable reports. Release confidence, quantified.

[**→ ContextQA for QA Managers**](https://learning.contextqa.com/documentation-by-role/by-role/for-qa-managers)
{% endtab %}

{% tab title="💻 Developer" %}
Generate tests from Jira tickets, PR quality gates, AI root cause in your terminal.

[**→ ContextQA for Developers**](https://learning.contextqa.com/documentation-by-role/by-role/for-developers)
{% endtab %}

{% tab title="🗺️ PM" %}
Turn your acceptance criteria into automated tests. Track feature coverage. Know before you ship.

[**→ ContextQA for Product Managers**](https://learning.contextqa.com/documentation-by-role/by-role/for-product-managers)
{% endtab %}

{% tab title="🏗️ Eng Manager" %}
Parallel CI gates, SSO, team metrics, and AI that eliminates test maintenance toil.

[**→ ContextQA for Engineering Managers**](https://learning.contextqa.com/documentation-by-role/by-role/for-engineering-managers)
{% endtab %}

{% tab title="🚀 VP/CTO" %}
The ROI, build-vs-buy analysis, and enterprise architecture for AI test automation at scale.

[**→ ContextQA for VPs & CTOs**](https://learning.contextqa.com/documentation-by-role/by-role/for-vp-engineering)
{% endtab %}
{% endtabs %}

***

## Documentation Sections

### [Getting Started](https://learning.contextqa.com/getting-started/introduction)

New to ContextQA? Start here. Covers platform overview, a 5-minute quickstart, core concepts, and the AI pipeline architecture.

* [Introduction to ContextQA](https://learning.contextqa.com/getting-started/introduction)
* [Quickstart Guide](https://learning.contextqa.com/getting-started/quickstart)
* [Core Concepts](https://learning.contextqa.com/getting-started/core-concepts)
* [Platform Architecture](https://learning.contextqa.com/getting-started/architecture-overview)

### [Web Testing](https://learning.contextqa.com/web-testing/web-testing)

Create and run automated tests for web applications. Covers test case authoring, the step editor, test suites, data management, and self-healing.

### [Mobile Testing](https://learning.contextqa.com/mobile-testing/mobile-testing)

Automate iOS and Android app testing. Covers device setup, app uploads, gesture authoring, and multi-device test plans.

### [API Testing](https://learning.contextqa.com/api-testing/api-testing)

Test REST APIs with assertions and request chaining. Covers request configuration, response validation, and multi-step API flows.

### [Salesforce Testing](https://learning.contextqa.com/salesforce-testing/salesforce-testing)

Automate Salesforce Lightning UI testing. Covers AI-assisted test generation, metadata-aware execution, and parallel test plans.

### [Execution](https://learning.contextqa.com/execution/running-tests)

Run tests manually, on a schedule, or from CI/CD. Covers parallel execution, environments, scheduling, and evidence capture.

### [Reporting](https://learning.contextqa.com/reporting/reporting)

Analyze test results and diagnose failures. Covers execution reports, the analytics dashboard, AI root cause analysis, and flaky test detection.

### [AI Features](https://learning.contextqa.com/ai-features/ai-test-generation)

The AI capabilities that power ContextQA. Covers test generation sources, the autonomous agent pipeline, knowledge bases, and custom agents.

### [Integrations](https://learning.contextqa.com/integrations/integrations)

Connect ContextQA to your existing toolchain. Covers Jira, Slack, GitHub Actions, Jenkins, GitLab CI, CircleCI, Azure DevOps, and webhooks. ContextQA supports 17 integrations across bug tracking, project management, CI/CD, and notifications.

### [MCP Server](https://learning.contextqa.com/mcp-server/overview)

Use ContextQA from AI agents via the Model Context Protocol. Covers installation, authentication, 67 tool references, and agent workflow patterns.

### [Administration](https://learning.contextqa.com/administration/administration)

Manage users, roles, SSO, and workspace settings.

### [Reference](https://learning.contextqa.com/reference/glossary)

Glossary, changelog, and keyboard shortcuts.

***

## Quick Links

| I want to…                           | Go to                                                                                                                                          |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Create my first test                 | [Quickstart Guide](https://learning.contextqa.com/getting-started/quickstart)                                                                  |
| Generate a test from a Jira ticket   | [AI Test Generation](https://learning.contextqa.com/ai-features/ai-test-generation)                                                            |
| Run tests in a CI/CD pipeline        | [GitHub Actions](https://learning.contextqa.com/integrations/github-actions) or [Jenkins](https://learning.contextqa.com/integrations/jenkins) |
| Use ContextQA from Claude or Cursor  | [MCP Server Overview](https://learning.contextqa.com/mcp-server/overview)                                                                      |
| Understand why a test failed         | [Failure Analysis](https://learning.contextqa.com/reporting/failure-analysis)                                                                  |
| Set up the platform for my team      | [Administration](https://learning.contextqa.com/administration/administration)                                                                 |
| Look up a tool in the MCP API        | [Tool Reference](https://learning.contextqa.com/mcp-server/tool-reference)                                                                     |
| Understand what "self-healing" means | [AI Self-Healing](https://learning.contextqa.com/web-testing/self-healing)                                                                     |

***

## Platform Requirements

| Requirement               | Detail                               |
| ------------------------- | ------------------------------------ |
| Supported browsers        | Chromium, Firefox, WebKit (Safari)   |
| Mobile platforms          | iOS 14+, Android (API level 21+)     |
| MCP server Python version | 3.9+                                 |
| MCP server default port   | 8080                                 |
| Deployment options        | Local (uv), Docker, Google Cloud Run |

***

## Need Help?

* Search these docs using the search bar above
* Check the [Glossary](https://learning.contextqa.com/reference/glossary) for term definitions
* Not sure where to start? [Browse by Role](https://learning.contextqa.com/documentation-by-role/by-role)

***

{% hint style="info" %}
**Want a guided tour?** [**Book a Demo →**](https://contextqa.com/book-a-demo/) — Our team will walk through ContextQA with your actual application and testing goals. Most teams are running their first tests within 24 hours of the demo.
{% endhint %}
