# Gatling MCP for AI Agents AI Agent Connect

> Gatling connects your AI agent to Gatling Enterprise. Use it to trigger load tests, monitor live simulations, and audit your generator pools without leaving your chat interface. It turns your performance testing into a conversation.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_f1mjnAhJFdhCLHf3npA2HLKXXMLgR80q7ymxxmFF/ai-agent-connect
- **Tags:** load-testing, performance-testing, simulation, stress-testing, automation, ci-cd-integration

## Description

The Gatling MCP connects your Gatling Enterprise account to any AI agent so you can manage performance testing through natural conversation. Imagine you're in the middle of a high-stakes deployment and need to see how your system handles 50,000 concurrent users. Usually, this means jumping into a dashboard, filtering by team, finding the right simulation, and then staring at a graph to see if the error rate is climbing. With this connection, you just ask your agent to start the test and tell you the status. It handles the heavy lifting of navigating the Gatling Enterprise infrastructure for you. You can check your team's remaining credits, see which load generator pools are active in specific regions, or immediately kill a runaway test that's eating up resources. It's about moving from manual clicks to direct commands. By adding this to your toolkit through Vinkius, you get a way to manage complex performance scenarios as easily as sending a message. You get real-time stats on request counts and response times without the friction of switching tabs. It makes performance testing feel like a part of your normal dev workflow instead of a separate, chore-filled task.

## Tools

### abort_simulation
Stop a running test immediately to save on resources or costs. This is your emergency brake for runaway tests.

### list_runs
View the history of all previous runs for a specific simulation. Use this to find past data for comparison.

### get_run
Get a full breakdown of a specific test run's performance data. Use it to see request stats and error counts.

### list_packages
Check the versions and timestamps of all uploaded test artifacts. Use this to verify that your latest code is live.

### list_tokens
Check the API tokens currently active on your Gatling Enterprise account. This helps with security and access management.

### list_simulations
See all available load scenarios and their associated team info. This helps you find the right test to run quickly.

### get_simulation
Pull every detail for a specific performance test definition. Use this to check configuration details before starting.

### start_simulation
Launch a new test run and get back a unique run ID. It makes triggering tests a one-step command.

### list_teams
See all teams registered within your Gatling Enterprise environment. This is useful for managing large organizations.

### list_pools
See the load generator pools available to you and their regional counts. It helps you verify scaling capacity.

## Prompt Examples

**Prompt:** 
```
Can you start the stress test for the login API?
```

**Response:** 
```
I've started the 'Login-API-Stress' simulation for you. Your run ID is **run_99283**. I'll keep an eye on it and let you know when it finishes.
```

**Prompt:** 
```
How is the current load test doing?
```

**Response:** 
```
The test is currently running. Here's the latest status:

| Metric | Value |
| :--- | :--- |
| **Virtual Users** | 4,200 |
| **Status** | In Progress |
| **Error Rate** | 0.02% |

It looks like the system is handling the load well.
```

**Prompt:** 
```
Show me the stats for run_99283.
```

**Response:** 
```
Here are the final results for run_99283:

*   **Peak VUs**: 5,000
*   **Total Requests**: 120,400
*   **Avg Response Time**: 145ms
*   **Error Count**: 12

Would you like me to look into the error logs or check the next simulation?
```

## Capabilities

### Trigger load tests immediately
Start a new performance test run and get the run ID back instantly.

### Monitor live virtual user counts
Track the progress and peak VU counts of ongoing simulations in real time.

### View request statistics and error rates
Get a detailed breakdown of request counts and error percentages for any run.

### Manage team quotas and credits
Audit team member counts and remaining credit quotas across your account.

### Audit load generator pool capacity
Check the list of active load generator pools and their regional instance counts.

### Stop runaway simulations instantly
Kill all load generators for a running simulation to prevent resource overruns.

## Use Cases

### Quickly checking API stress limits
A developer asks their agent to start a specific stress test and report back the peak virtual user count to see if the new endpoint holds up.

### Auditing team credit usage
An SRE notices a spike in costs and asks the agent to list all teams and their current quotas to identify who is using the most resources.

### Verifying test package deployment
A QA engineer needs to confirm the latest test script is live. They ask the agent to list all packages and check the most recent upload timestamp.

### Checking regional capacity
A performance lead needs to see if there's enough capacity in a specific region. They ask the agent to list the generator pools and count the instances.

## Benefits

- Stop wasting time searching for run IDs by using start_simulation to trigger tests and get the ID back instantly.
- Keep your costs in check by using abort_simulation to kill runaway tests the moment they exceed your limits.
- Get a bird's eye view of your infrastructure with list_pools to see exactly where your load generators are running.
- Stay on top of your budget by using list_teams to monitor credit quotas through natural conversation.
- Verify your deployment history by checking uploaded test packages with list_packages.
- Analyze performance trends quickly by pulling full request stats with get_run.

## How It Works

The bottom line is you get a voice-controlled interface for your entire performance testing suite.

1. Subscribe to the Gatling MCP on Vinkius.
2. Enter your Gatling Enterprise API Token in the configuration settings.
3. Ask your AI client to start, monitor, or audit your performance tests.

## Frequently Asked Questions

**What can I do with the Gatling MCP?**
You can manage your Gatling Enterprise account using natural language. This includes starting load tests, monitoring live progress, viewing performance stats, and auditing your generator pools.

**Does the Gatling MCP work with my existing simulations?**
Yes, it connects directly to your Gatling Enterprise account. It allows your AI agent to see and interact with all the simulations you've already defined.

**Can I use the Gatling MCP to stop a test that's running too long?**
Absolutely. You can tell your agent to stop a simulation immediately, which will abort the run and help you manage your resource usage and costs.

**How do I see my team's credit limits with the Gatling MCP?**
You can simply ask your agent to check your team quotas. It will pull the latest data from Gatling Enterprise so you can see how many credits are left.

**Is the Gatling MCP good for SREs?**
It's great for SREs because it simplifies infrastructure auditing. You can quickly check generator pool capacity and regional instance counts without logging into a separate console.

**Can the Gatling MCP show me request stats?**
Yes, it can pull full run details including request statistics, error counts, and injection times, giving you a clear picture of your test results.

**Can my agent start a Gatling simulation run via chat?**
Yes. Use the 'start_simulation' tool with the specific Simulation ID. The agent will command the Gatling Enterprise infrastructure to begin the load test and return a unique run ID for tracking.

**How do I check the request statistics for a completed test run via chat?**
Use the 'get_run' tool. Provide the Run ID. Your agent will fetch the full details of the execution, including request stats, error counts, and the virtual user peak reached during the test.

**Can I see my credit quotas and team member counts through the agent?**
Absolutely. Use the 'list_teams' tool. Your agent will enumerate the teams registered in your Gatling Enterprise account and monitor their member counts and available credit quotas natively.