Use the Leapwork Play plugin to create, run, and troubleshoot tests from Google Antigravity. The plugin connects your agent to Play through the Model Context Protocol (MCP), using your Play account and its permissions.
Before you begin
You need:
-
A Leapwork Play account with access to the work you want to perform.
-
Google Antigravity with the
agycommand-line interface available. -
Network access to
https://mcp.leapwork.ai/mcp.
The plugin connects to a remote MCP server. Its supplied configuration does not require you to enter an API key.
Install the plugin
-
Open a terminal.
-
Install the plugin from Leapwork’s GitHub repository:
Bashagy plugin install https://github.com/leapwork/play-antigravity-plugin -
List your installed plugins:
Bashagy plugin list -
Find
leapwork-playand check that it is enabled. If it is disabled, run:Bashagy plugin enable leapwork-play
Connect your Play account
-
Open an Antigravity conversation.
-
Ask the agent to list the capabilities available through Leapwork Play.
-
Complete the browser sign-in when Antigravity prompts you.
-
Return to Antigravity and check that the agent can retrieve Play’s available capabilities.
Antigravity handles the sign-in flow. Calls to Play use your account’s permissions. Signing in does not grant access to work that your account cannot access.
The plugin already supplies this MCP configuration:
{
"mcpServers": {
"play": {
"serverUrl": "https://mcp.leapwork.ai/mcp"
}
}
}
You do not need to add a second server entry when using the plugin.
Work with Play
Describe the task in the Antigravity conversation. Include the relevant test case, runlist, application, or expected result.
For example:
-
Create: “Create a Leapwork Play test case for the password reset bug described above.”
-
Record: “Record a test that opens our test site, searches for a product, and checks the results.”
-
Run: “Run test case TC-28 and summarize the result.”
-
Troubleshoot: “Explain the failure in the latest run of TC-28.”
-
Update: “Update TC-28 for the revised login page.”
-
Run a suite: “Run the smoke-test runlist and summarize any failures.”
Replace sample names and identifiers with items in your Play account. Review the target before asking the agent to change a test or start a run.
Play supports test creation, cloud-browser recording, test and runlist execution, debugging, and agent creation. Its MCP tools also let the agent check pending requests, relay answers to questions or approvals, cancel workflows, and retrieve run screenshots or videos.
Handle questions and interrupted work
If Play requests information or approval, answer in the Antigravity conversation.
If the conversation loses its connection during a task, ask the agent to check the pending Play request before starting the task again. This helps you establish whether the earlier request is still running or has already finished.
Troubleshoot the connection
The plugin is missing or disabled
Run agy plugin list. If leapwork-play is listed but disabled, enable it with agy plugin enable leapwork-play.
If installation fails, keep the error message and check the Google plugin documentation for the installation method supported by your Antigravity version.
Play requests another sign-in
Complete the sign-in prompt, then ask the agent to check any pending task before retrying it.
Known issue: A Play connection can require another sign-in after approximately 1 hour, interrupting longer agent sessions.
Antigravity cannot reach Play
Check that your network permits access to https://mcp.leapwork.ai/mcp. If you are inspecting a configuration, check that the URL includes /mcp.
If the problem continues, record the error text, time of failure, Antigravity version, and plugin version for your support request. Do not include passwords or authentication tokens.
A requested operation is unavailable
Ask the agent to list the available Play capabilities. Check that your Play account can access the target item. Use a supported capability or perform the task directly in Play.
Protect your account and test data
-
Complete authentication in the browser sign-in flow. Do not paste passwords or access tokens into prompts or configuration files.
-
Use a test environment and test data appropriate for the requested task.
-
Review questions and approval requests before continuing.
-
Check screenshots, videos, and error details for sensitive data before sharing them.
The plugin uses your Play permissions. Treat requests to create, update, or run tests as actions in your Play account.