Skip to content

Commit 7673f5b

Browse files
committed
Update README
1 parent 07f4f11 commit 7673f5b

File tree

1 file changed

+184
-0
lines changed

1 file changed

+184
-0
lines changed

README.md

Lines changed: 184 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -136,6 +136,190 @@ Generate test cases from PRDs, convert manual tests to low-code automation, and
136136
```
137137
138138
139+
140+
141+
142+
### 💡 List of BrowserStack MCP Tools
143+
144+
As of now we support 20 tools.
145+
146+
147+
---
148+
149+
## 🧾 Test Management
150+
151+
* `createProjectOrFolder` — Create a Test Management project and/or folders to organize test cases.
152+
**Prompt example**
153+
154+
```text
155+
Create a new Test Management project named 'Shopping App' with two folders - Login and Checkout
156+
```
157+
Returns with Folder ID, Project ID and Test Management Link to access the TM Project Dashboard.
158+
159+
* `createTestCase` — Add a manual test case under a specific project/folder (uses project identifier like PR-xxxxx and a folder ID).
160+
**Prompt example**
161+
162+
```text
163+
Add a test case named 'Invalid Login Scenario' to the Login folder in the 'Shopping App' project with PR-53617, Folder ID: 117869
164+
```
165+
166+
* `listTestCases` — List test cases for a project (supports filters like priority, status, tags).
167+
**Prompt example**
168+
169+
```text
170+
List all high-priority test cases in the 'Shopping App' project with project_identifier: PR-59457
171+
```
172+
173+
* `createTestRun` — Create a test run (suite) for selected test cases in a project.
174+
**Prompt example**
175+
176+
```text
177+
Create a test run for the Login folder in the 'Shopping App' project and name it 'Release v1.0 Login Flow'
178+
```
179+
180+
* `listTestRuns` — List test runs for a project (filter by dates, assignee, state).
181+
**Prompt example**
182+
183+
```text
184+
List all test runs from the 'Shopping App' project that were executed last week and are currently marked in-progress
185+
```
186+
187+
* `updateTestRun` — Partially update a test run (status, tags, notes, associated test cases).
188+
**Prompt example**
189+
190+
```text
191+
Update test run ID 1043 in the 'Shopping App' project and mark it as complete with the note 'Regression cycle done'
192+
```
193+
194+
* `addTestResult` — Add a manual execution result (passed/failed/blocked/skipped) for a test case within a run.
195+
**Prompt example**
196+
197+
```text
198+
Mark the test case 'Invalid Login Scenario' as passed in test run ID 1043 of the 'Shopping App' project
199+
```
200+
201+
* `createTestCasesFromFile` — Bulk-create test cases from an uploaded file (e.g., PDF).
202+
**Prompt example**
203+
204+
```text
205+
Upload test cases from '/Users/pushkar/testcases.pdf' to the 'Shopping App' project in Test Management
206+
```
207+
208+
---
209+
210+
## ⚙️ BrowserStack SDK Setup / Automate Test
211+
212+
* `setupBrowserStackAutomateTests` — Integrate BrowserStack SDK and run web tests on BrowserStack (optionally enable Percy).
213+
**Prompt example**
214+
215+
```text
216+
Run my Selenium-JUnit5 tests written in Java on Chrome and Firefox. Enable Percy for visual testing.
217+
```
218+
219+
* `fetchAutomationScreenshots` — Fetch screenshots from a given Automate/App Automate session.
220+
**Prompt example**
221+
222+
```text
223+
Get screenshots from Automate session ID abc123xyz for my desktop test run
224+
```
225+
226+
---
227+
228+
## 🔍 Observability
229+
230+
* `getFailureLogs` — Retrieve error logs for Automate/App Automate sessions (optionally by Build ID for App Automate).
231+
**Prompt example**
232+
233+
```text
234+
Get the error logs from the session ID: 21a864032a7459f1e7634222249b316759d6827f, Build ID: dt7ung4wmjittzff8kksrjadjax9gzvbscoyf9qn of App Automate test session
235+
```
236+
237+
---
238+
239+
## 📱 App Live
240+
241+
* `runAppLiveSession` — Start a manual app testing session on a real device in the cloud.
242+
**Prompt example**
243+
244+
```text
245+
Open my app on iPhone 15 Pro Max with iOS 17. App path is /Users/pushkar/app.ipa
246+
```
247+
248+
---
249+
250+
## 💻 Live
251+
252+
* `runBrowserLiveSession` — Start a Live session for website testing on desktop or mobile browsers.
253+
**Prompt example**
254+
255+
```text
256+
Open www.google.com on the latest version of Microsoft Edge on Windows 11
257+
```
258+
259+
---
260+
261+
## 📲 App Automate
262+
263+
* `takeAppScreenshot` — Launch the app on a specified device and capture a quick verification screenshot.
264+
**Prompt example**
265+
266+
```text
267+
Take a screenshot of my app on Google Pixel 6 with Android 14 while testing on App Automate. App file path: /Users/pushkar/app-debug.apk
268+
```
269+
270+
* `runAppTestsOnBrowserStack` — Run automated mobile tests (Espresso/XCUITest, etc.) on real devices.
271+
**Prompt example**
272+
273+
```text
274+
Run Espresso tests from /tests/checkout.zip on Galaxy S21 and Pixel 6 with Android 14. App path is /apps/beta-release.apk under project 'Checkout Flow'
275+
```
276+
277+
---
278+
279+
## ♿ Accessibility
280+
281+
* `accessibilityExpert` — Ask A11y Expert (WCAG 2.0/2.1/2.2, mobile/web usability, best practices).
282+
**Prompt example**
283+
284+
```text
285+
What WCAG guidelines apply to form field error messages on mobile web?
286+
```
287+
288+
* `startAccessibilityScan` — Start a web accessibility scan and return the result link.
289+
**Prompt example**
290+
291+
```text
292+
Run accessibility scan named 'HomePage Audit' for www.example.com
293+
```
294+
295+
---
296+
297+
## 🤖 BrowserStack AI Agents
298+
299+
* `fetchSelfHealedSelectors` — Retrieve AI self-healed selectors to fix flaky tests due to DOM changes.
300+
**Prompt example**
301+
302+
```text
303+
Fetch and fix flaky test selectors in Automate session ID session_9482 using MCP
304+
```
305+
306+
* `createLCASteps` — Generate Low Code Automation steps from a manual test case in Test Management.
307+
**Prompt example**
308+
309+
```text
310+
Convert the manual test case 'Add to Cart' in the 'Shopping App' project into LCA steps
311+
```
312+
313+
* `uploadProductRequirementFile` — Upload a PRD/screenshot/PDF and get a file mapping ID (used with `createTestCasesFromFile`).
314+
**Prompt example**
315+
316+
```text
317+
Upload PRD from /Users/pushkar/Desktop/login-flow.pdf and use BrowserStack AI to generate test cases
318+
```
319+
320+
321+
322+
139323
## 🛠️ Installation
140324
141325
### **One Click MCP Setup**

0 commit comments

Comments
 (0)