• EXECUTION
  • MONITORING
  • HISTORY
  • HUMAN

How to trigger and monitor load tests with your AI

Connect your agent to Gatling once. After that, you can run simulations and watch live metrics through your chat window.

Ask AI about this page

Short answer

How can I run Gatling tests using my AI?

You tell your agent to start a specific simulation, and it handles the execution. You can then ask for live updates on user counts or check the status of previous runs. This gives you a direct line to your performance data without leaving your chat.

Where every outcome lands.

The results of your requests

Your agent translates your natural language commands into direct Gatling actions.

EXECUTION

Active simulations

The AI triggers the exact Gatling script you need. You get immediate confirmation that the test is running.

MONITORING

Live performance data

Your agent pulls real-time user counts and progress. You stay updated on how the system handles the load.

HISTORY

Past test results

The AI looks up previous runs to compare data. You can quickly pull up old simulation details.

HUMAN

Manual script edits

The AI cannot rewrite your Gatling Scala or Java code. You still own the simulation logic and script files.

The workflow

What your AI does when a request arrives.

The agent acts as the bridge between your chat and the Gatling engine.

  1. Launch the test

    The agent identifies the simulation you want to run and kicks it off immediately.

    start_simulation

  2. Check progress

    You can ask for updates on a specific running test to see how it's performing.

    get_run

  3. Review history

    The agent pulls a list of all previous simulations to help you find specific data points.

    list_simulations

  4. Verify status

    The agent uses the same tools to confirm if a run finished successfully or failed.

    get_run

Try it

Copy these to start.

Use these prompts to interact with Gatling.

Starting points

Replace the bracketed text with your actual simulation names or run IDs.

Gatling Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_f1mjnAhJFdhCLHf3npA2HLKXXMLgR80q7ymxxmFF/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Gatling capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gatling-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_f1mjnAhJFdhCLHf3npA2HLKXXMLgR80q7ymxxmFF/mcp"
    }
  }
}
Copy into chat04

  • Start the 'api-stress-test' simulation now.

  • How is the current simulation running doing in terms of user count?

  • Show me a list of all my recent Gatling simulations.

  • Check the status of run ID 12345.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Gatling once, then ask.

One click connects your agent to the Gatling MCP. Your credentials stay encrypted and secure on our side.

Connect Gatling to your AI

FAQ

How this task behaves

  • 01

    Can the AI write new Gatling simulation scripts for me?

    No. The AI can only trigger existing simulations that are already available in your environment.

  • 02

    Can I change the load parameters during a test via chat?

    No. The AI uses the parameters defined in your existing simulation scripts.

  • 03

    Does the AI have access to my local files?

    No. The AI only interacts with Gatling through the specific tools provided by this MCP.

  • 04

    Can the AI delete my simulation history?

    No. There are no tools provided to delete or modify existing simulation records.

  • 05

    How does the AI know which simulation to run?

    You must specify the name of the simulation in your prompt so the agent can target it.

  • More questions about Gatling? The Connector page answers them. See everything the Gatling Connector can do

Connect Gatling to Claude, Cursor, ChatGPT & more