---
title: "Example prompts"
section: "MCP & AI assistants"
description: "Example prompts for Claude and other MCP assistants working in SmartestQA, from project status to scenarios, pipelines, red-run triage, auto-heal, defects and Jira."
url: https://docs.smartestqa.ai/en/mcp-workflows.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "mcp example prompts claude ask project status modules requirements scenarios write test case dry run pipeline schedule red run triage auto-heal defects jira mailbox"
---
# MCP & AI assistants: Example prompts and workflows

Ask in plain words, in your own language. Name the project, say what you want, and give the assistant a source to work from. These examples show what works and what the assistant does with each request.

## In short

**On this page you can**

- Copy prompts that get a project from empty to running pipelines.
- Ask why a run went red and get the failed step and its cause.
- Decide auto-heal records and handle defects from the chat.
- Sync with Jira, read the test mailbox and query a test database.

**How to use it**

1. Start with the project status prompt.
2. Work through the stages in order, one module at a time.
3. Approve each diff the assistant shows.
4. Come back to the status prompt to see what is left.

## First steps

Start here

```text
Which SmartestQA projects can I access?

Where does project Web Shop stand, and what should we do first?
```

The assistant calls `smartest_context`, then `smartest_status`, and lists the open work as [work keys](https://docs.smartestqa.ai/en/mcp-tools.html#work-keys) with counts. In Claude Desktop you can also start the **Status** [prompt](https://docs.smartestqa.ai/en/mcp-tools.html#prompts) from the **+** menu.

> **Tip: Give it a source**
>
> The assistant writes better tests when it can read something real: your code (Claude Code or Cursor opened in the repository), the running app, an [analysis document](https://docs.smartestqa.ai/en/analyze-folders.html#documents) in SmartestQA, or what [Discover](https://docs.smartestqa.ai/en/discover.html) already knows. Say which one: “Use the code in `/web/src`.”

## Build a project, module by module

| Stage | Ask | The assistant |
| --- | --- | --- |
| [Environment](https://docs.smartestqa.ai/en/project-settings.html) | “Check the environment of Web Shop: language, start URL and where runs happen.” | Proposes what is missing (`level=environment`). |
| [Modules](https://docs.smartestqa.ai/en/analyze-folders.html#modules) | “Group the recorded pages of Web Shop into modules by business area.” | Proposes modules and which pages go where. |
| [Pages](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) | “List the pages without a purpose and draft one for each from the code in `/web/src/pages`.” | Proposes page purposes and roles (`level=page`). |
| [Requirements](https://docs.smartestqa.ai/en/analyze-requirements.html) | “Write the main requirements and sub-requirements of module Orders from the document Orders spec.” | Reads the document in parts and proposes a requirement tree. |
| [Scenarios](https://docs.smartestqa.ai/en/automate-test-cases.html) | “Plan scenarios for the sub-requirements of Checkout that have none, riskiest first.” | Proposes a scenario plan per sub-requirement; after you approve, writes and [dry-runs](https://docs.smartestqa.ai/en/automate-dry-run.html) each one. |
| [API](https://docs.smartestqa.ai/en/api-requests.html) | “Build the API inventory of module Orders and add a refusal scenario for every write.” | Proposes the inventory (`level=api`), then API and security scenarios. |
| [Pipelines](https://docs.smartestqa.ai/en/schedule-create.html) | “Build the pipelines of module Orders.” | Runs `smartest_module_pipelines`: functional, API and security pipelines, plus Smoke and E2E entries. |
| [Schedule](https://docs.smartestqa.ai/en/schedule-timing.html) | “Schedule the Orders functional pipeline on weekdays at 02:00, Berlin time.” | Sets the cron once the pipeline has passed once. |
| [Load tests](https://docs.smartestqa.ai/en/automate-steps-load.html) | “Propose load tests for the critical endpoints of Orders.” | Proposes a load profile (`level=perf`). |

The assistant follows this order on its own (see [The order the assistant works in](https://docs.smartestqa.ai/en/mcp.html#order-of-work)). You can also paste a command copied with [**With MCP**](https://docs.smartestqa.ai/en/mcp-tools.html#commands) from the [Setup Roadmap](https://docs.smartestqa.ai/en/quick-start-progress.html#setup-roadmap).

## Write and run one scenario

Examples

```text
Write and dry-run the planned scenario "Card is declined" on the server.

Run scenario 482 again on my agent; I fixed the test user.

The scenario "Export invoice" is BLOCKED. What are our options?
```

[Dry runs](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) on **your agent** need it online (see [Install an agent](https://docs.smartestqa.ai/en/quick-start-connect.html#install-agent)). For a [MOBILE project](https://docs.smartestqa.ai/en/quick-start-project.html#project-type) with [Android and iOS](https://docs.smartestqa.ai/en/project-settings-mobile.html), say which platform.

## Read results

Examples

```text
Why did last night's Regression pipeline go red? Group the failures by cause.

Show the failed step, its locator and the screenshot of the latest run of "Login with SSO".

Which scenarios of module Orders flip between green and red?

What is running right now, and are the runners healthy?
```

The assistant uses [`smartest_runs`](https://docs.smartestqa.ai/en/mcp-tools.html#tools-results). The **Red runs** prompt starts the same triage for the whole project.

## Heal, defects and data

Examples

```text
Which healed locators are waiting for a decision? Show me each one before you approve it.

List the open defects by priority and offer to close the ones whose scenario ran green.

Open a defect for the failure in run 9031; it is a real product bug.

Which data keys have no value, and which scenarios use them?
```

[Healed locators](https://docs.smartestqa.ai/en/maintenance-auto-heal.html#review-a-repair) are approved one by one ([preview first](https://docs.smartestqa.ai/en/mcp-safe-changes.html#propose-apply)). New [defects](https://docs.smartestqa.ai/en/tasks.html) are proposed; closing asks for the resolution. Empty [data keys](https://docs.smartestqa.ai/en/data-source-variables.html#create-key) are filled by you in SmartestQA, never in the chat.

## Jira, mailbox and database

Examples

```text
Is Jira connected for Web Shop? Test the connection, then send defect 45 to Jira.

Wait for the sign-up e-mail in the test mailbox and give me the confirmation link.

Run this read-only query on the TEST database and show the first 10 rows: SELECT …
```

These use the [integrations](https://docs.smartestqa.ai/en/integrations.html#catalogue) set up in SmartestQA ([Jira](https://docs.smartestqa.ai/en/integrations-issue-trackers.html#jira), the [test mailbox](https://docs.smartestqa.ai/en/integrations-email.html), [database connections](https://docs.smartestqa.ai/en/data-source-connections.html#add-db)). A bulk sync and a writing database statement [ask for your click](https://docs.smartestqa.ai/en/mcp-safe-changes.html#confirmations).

## Report and share

Examples

```text
Summarise the state of Web Shop for my manager in five bullet points.

Mail the report of the latest Smoke run to qa-lead@example.com.
```

[Mailing a report](https://docs.smartestqa.ai/en/report-summary.html#share-report) opens a [confirmation dialog](https://docs.smartestqa.ai/en/mcp-safe-changes.html#confirmations) with the address.

## Asking well

#### Do

- Name the project, and the module or scenario when you know it.
- Ask for one module at a time.
- Ask “show me the diff first” when you are unsure.
- Say what is out of scope: “not the admin pages”.

#### Don’t

- Ask it to “test everything” in one go.
- Paste logins or tokens; let it create empty [data keys](https://docs.smartestqa.ai/en/data-source-variables.html#create-key).
- Ask it to retry a [BLOCKED](https://docs.smartestqa.ai/en/mcp-safe-changes.html#scenario-flow) scenario unchanged.
