{
  "$type": "site.standard.document",
  "bskyPostRef": {
    "cid": "bafyreiaqrxew43gwqfbu5x6xi7zxokjloht7mpzyeprjzulvns43ljtyie",
    "uri": "at://did:plc:25rdn5elo5izoxrmtis34zuk/app.bsky.feed.post/3moigr7plxyz2"
  },
  "coverImage": {
    "$type": "blob",
    "ref": {
      "$link": "bafkreicj37d2hlqk2s577umhnngbepjue5ryltlraus2p4px323udbjawm"
    },
    "mimeType": "image/webp",
    "size": 73402
  },
  "path": "/gatling/how-to-use-the-gatling-mcp-server-for-ai-powered-performance-testing-b1j",
  "publishedAt": "2026-06-17T13:19:46.000Z",
  "site": "https://dev.to",
  "tags": [
    "mcp",
    "gatling",
    "testing",
    "Gatling MCP Server",
    "a standard donated to the Linux Foundation",
    "Gatling Enterprise API",
    "AI Skills",
    "97 million SDK downloads per month",
    "API token settings",
    "@media",
    "load generator locations",
    "live metrics",
    "performance testing metrics",
    "Configuration as Code",
    "Maven, Gradle, npm, and sbt",
    "Request a demo"
  ],
  "textContent": "Running load tests from your AI coding agent sounds futuristic until you realize it's already possible. The Gatling MCP Server connects your Gatling Enterprise account to Claude Code, Cursor, VS Code, and other MCP-compatible clients. You can deploy tests, query results, and manage infrastructure without leaving your IDE.\n\nThis guide covers installation, configuration for each supported client, and how to deploy your first load test using natural language commands.\n\n##  What Is the Gatling MCP server\n\nThe Gatling MCP Server is a local server that runs on your machine and exposes your Gatling Enterprise Edition account to any MCP-compatible AI client. No UI required—you interact entirely through your coding agent.\n\nMCP stands for Model Context Protocol, a standard donated to the Linux Foundation that allows AI coding agents to communicate with external tools and services. Think of it as a shared language between your AI assistant and the software it connects to.\n\nOnce the Gatling MCP server is running, your AI agent can query your Gatling Enterprise account and trigger load tests. Results pull directly into your development environment.\n\nHere's what the MCP server provides:\n\n  * **Local execution:** The server runs on your machine, so your credentials stay with you\n  * **Direct connection:** Links your Gatling Enterprise account to AI clients like Claude Code, Cursor, or VS Code\n  * **Conversational interface:** Ask questions and issue commands in plain English instead of navigating dashboards\n\n\n\n##  How the MCP server works\n\nWhen you type a request into your AI agent like \"show me my recent test results,\" the MCP server translates it into Gatling Enterprise API calls. It authenticates using your API token, fetches the data, and sends it back to your agent.\n\nThe flow breaks down into three steps:\n\n  * **You ask:** Your AI agent receives a natural language command\n  * **Server translates:** The MCP server converts your request into Gatling Enterprise API calls\n  * **Results return:** Data comes back to your agent for display or further action\n\n\n\nEverything happens locally. The MCP server acts as a translator between your AI agent and Gatling Enterprise, nothing more.\n\n##  MCP server vs AI skills\n\nGatling offers two AI components, and they serve different purposes. The MCP server handles real-time queries and commands like checking infrastructure status, triggering simulations, pulling reports.\n\nAI Skills, on the other hand, are reusable prompt templates that guide your agent through Gatling-specific workflows like writing tests or setting up build tools.\n\nMCP Server vs AI Skills AI • GATLING\n\nFeature | MCP Server | AI Skills\n---|---|---\nPurpose | Query and control Gatling Enterprise | Guide test creation and deployment\nInteraction | Real-time data access | Prompt-based workflows\nUse case | Monitoring and triggering tests | Writing tests and configuration as code\n\nYou'll often use both together. The MCP server gives your agent access to your Gatling Enterprise account, while AI Skills teach your agent how to work with Gatling effectively.\n\n###  MCP server\n\nThe MCP server enables querying infrastructure, triggering simulations, and retrieving reports directly from your AI client. It's your live connection to Gatling Enterprise—ask about available load generators, start a test run, or pull historical metrics without opening a browser.\n\n###  AI skills\n\nAI Skills are prompt templates that teach your agent Gatling-specific patterns. They cover topics like configuration as code (defining test parameters in version-controlled files) and build tool integration (Maven, Gradle, npm, sbt). When your agent encounters a Gatling-related task, these skills provide the context it needs to help you effectively.\n\n##  Supported AI coding clients\n\nAny MCP-compatible client works with the Gatling MCP server. The protocol is open, so new clients appear regularly. That said, a few have become particularly popular among developers.\n\n###  Claude Code\n\nClaude Code offers native MCP support, making it a natural fit for terminal-based workflows. Configuration takes just a few lines in a JSON file, and the integration feels seamless once set up.\n\n###  Claude Desktop\n\nIf you prefer a graphical interface over the terminal, Claude Desktop provides the same MCP capabilities in a desktop application. Same functionality, different presentation.\n\n###  Cursor\n\nCursor has emerged as a popular AI-powered IDE with built-in MCP integration. Many developers already use it for code generation, so adding Gatling to the mix feels like a natural extension of existing workflows.\n\n###  VS Code\n\nVS Code works via MCP extensions available in the marketplace. If you're already comfortable in VS Code, you can add Gatling MCP support without switching to a new environment.\n\n###  Other MCP-compatible clients\n\nWindsurf and various custom tooling also support MCP. Because the protocol is standardized, with 97 million SDK downloads per month according to Anthropic, any client that implements MCP can connect to the Gatling server.\n\n##  How to install the Gatling MCP server\n\nInstallation takes about five minutes. You'll clone a repository, generate an API token, and add the server to your client's configuration file.\n\n###  1. Clone the Gatling AI extensions repository\n\nOpen your terminal and run:\n\n`git clone https://github.com/gatling/gatling-ai-extensions`\n\nThis repository contains both the MCP server and the AI Skills collection. Once cloned, you'll have everything you need locally.\n\n###  2. Generate your Gatling Enterprise API token\n\nLog into your Gatling Enterprise account and navigate to your API token settings. Create a new token with permissions for the resources you want your AI agent to access—typically simulations, reports, and infrastructure.\n\n**Tip:** Store your API token securely. You'll reference it in your client configuration, but avoid committing it to version control or sharing it in plain text.\n\n###  3. Add the MCP server to your client configuration\n\nEach AI client stores MCP server configurations in a JSON file. You'll add an entry that points to the Gatling MCP server and includes your API token. The exact location of this file varies by client, which we'll cover in the next section.\n\n##  How to configure the MCP server for each client\n\nConfiguration varies slightly by client, though the pattern stays consistent: point to the server, provide your token, and you're ready to go.\n\n###  Claude Code configuration\n\nAdd the following to your `mcp.json` file:\n\n`{ \"servers\": { \"gatling\": { \"command\": \"node\", \"args\": [\"path/to/gatling-ai-extensions/mcp-server/index.js\"], \"env\": { \"GATLING_API_TOKEN\": \"your-api-token-here\" } } } }`\n\nReplace `path/to/gatling-ai-extensions` with the actual path where you cloned the repository, and substitute your real API token.\n\n###  Cursor configuration\n\nCursor stores MCP settings in its own configuration directory. The structure mirrors Claude Code. You specify the command, arguments, and environment variables. Check Cursor's documentation for the exact file path on your operating system.\n\n###  VS Code configuration\n\nFirst, install an MCP extension from the VS Code marketplace. Then add the Gatling server to your `settings.json` file. The extension documentation provides the exact format, which typically follows the same pattern as other clients.\n\n.arcade-responsive { width: 100%; max-width: 1100px; margin: 32px auto; border-radius: 16px; overflow: hidden; background: #000; box-shadow: 0 12px 30px rgba(0,0,0,0.2); } .arcade-responsive iframe { width: 100%; aspect-ratio: 16 / 9; min-height: 360px; border: 0; display: block; } @media (max-width: 768px) { .arcade-responsive iframe { min-height: 460px; } } @media (max-width: 480px) { .arcade-responsive iframe { min-height: 380px; } }\n\n##  What your AI agent can access\n\nOnce connected, your AI agent can query a wide range of Gatling Enterprise resources. Here's what becomes available.\n\n###  Teams and organizations\n\nView team members, roles, and organization structure. Useful when you're trying to understand who has access to specific tests or environments.\n\n###  Packages and simulations\n\nList available test packages and simulation configurations. Your agent can help you find the right test to run or check what's already been set up.\n\n###  Load generators and private locations\n\nQuery public and private load generator locations and check their availability. Before launching a large-scale test, you can verify that the infrastructure you want is ready.\n\n###  Reports and test results\n\nRetrieve historical test reports, metrics, and performance trends. This is often the most valuable capability, getting insights without leaving your IDE or switching to a dashboard.\n\n##  How to deploy your first load test\n\nWith the MCP server running, deploying a load test becomes conversational. Here's how to walk through your first deployment.\n\n###  1. Open your project in your AI coding client\n\nMake sure your Gatling project is loaded and the MCP server is active. When you first interact with your agent about Gatling, it will confirm the connection is working.\n\n###  2. Write or generate a Gatling test script\n\nUse your AI agent to help write a basic simulation, or work with an existing script. The agent can suggest improvements based on Gatling's DSL patterns and best practices—especially if you've enabled the AI Skills.\n\n###  3. Ask your agent to deploy the test to Gatling Enterprise\n\nTry a prompt like: \"Deploy my simulation to Gatling Enterprise using the default load generators.\" The MCP server handles authentication and API calls behind the scenes, so you don't have to construct requests manually.\n\n###  4. Monitor results in real time\n\nYour agent can fetch live metrics as the test runs. Ask for key performance testing metrics like throughput, response times, or error rates—all without switching windows or opening a separate dashboard.\n\nRequest a demo to see how Gatling Enterprise scales load testing for your team.\n\n##  Using Gatling AI skills for production workflows\n\nAI Skills extend what the MCP server can do by providing structured guidance for common tasks. They're especially helpful when you're setting up tests for the first time or integrating Gatling into existing pipelines.\n\n###  Configuration as Code Skill\n\nConfiguration as Code means defining your test parameters—load profiles, thresholds, environments—in version-controlled files rather than a UI. This skill helps your agent generate those definitions automatically, so your test configurations live alongside your application code and go through the same review process.\n\n###  Build tools skill\n\nThis skill covers Maven, Gradle, npm, and sbt integration. Your agent can scaffold build configurations so your Gatling tests run as part of your existing build process. Instead of manually writing plugin configurations, you describe what you want and the skill guides your agent through the setup.\n\n##  Requirements and prerequisites for the Gatling MCP server\n\nBefore you start, confirm you have the following:\n\n  * Gatling Enterprise Edition account (trial or full)\n  * API token with appropriate permissions\n  * MCP-compatible AI client (Claude Code, Cursor, VS Code, or another)\n  * Node.js\n  * Git\n\n\n\n##  Start deploying load tests from your AI coding agent today\n\nThe Gatling MCP server brings load testing into your AI-assisted workflow. Write tests, deploy them, and analyze results, all from your coding agent. No context switching, no manual API calls, no dashboard hopping.\n\nRequest a demo to explore how Gatling Enterprise fits into your performance testing strategy.",
  "title": "¿How to use the Gatling MCP server for AI-powered performance testing"
}