> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loadforge.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LoadForge REST API Reference

> Complete API documentation for LoadForge load testing — manage hosts, tests, runs, and results programmatically.

## Overview

LoadForge provides a comprehensive REST-based API service that enables you to automate your load testing workflows and analyze results programmatically. This documentation covers all available endpoints and their usage.

> [!NOTE]
>
> All API requests require authentication using a Bearer token. Create your token in the [User Menu - API](https://app.loadforge.com/user/api-tokens) section.

## Base URL

All API requests should be made to:

```text theme={null}
https://app.loadforge.com/api/v2
```

## Authentication

```bash Authorization Header theme={null}
Authorization: Bearer YOUR_TOKEN_HERE
```

```json OpenAPI Security Schema theme={null}
{
  "security": [
    {
      "bearerAuth": []
    }
  ]
}
```

## Core Endpoints

> [card] Hosts API
>
> Manage test targets by creating, listing, and deleting host configurations

> [card] Tests API
>
> Handle test configurations including creation, updates, and deletion

> [card] Results API
>
> Access detailed test results and performance metrics

> [card] Run API
>
> Control test execution with start and cancel operations

## Model Context Protocol (MCP) Integration

### Overview

LoadForge now supports the **Model Context Protocol (MCP)**, enabling seamless integration with other MCP-compatible services for enhanced automation and workflow management.

> [!TIP]
>
> MCP integration allows you to automate test execution, streamline workflows, and enable cross-platform compatibility with other tools in your stack.

### Getting Started with MCP

To add LoadForge as an MCP service:

```bash theme={null}
npx @mintlify/mcp@latest add loadforge
```

### Key Benefits

> [accordion] Automated Load Testing
>
> * Trigger tests from CI/CD pipelines
> * Schedule performance monitoring
> * Set up threshold-based testing

> [accordion] Unified Service Management
>
> * Centralized configuration management
> * Simplified test scheduling
> * Consolidated logging and reporting

> [accordion] Enhanced Scalability
>
> * Dynamic test scaling
> * Multi-location test execution
> * Integration with monitoring tools

### Example MCP Workflow

Here's a sample workflow that demonstrates how to trigger LoadForge tests using MCP:

```json theme={null}
{
  "name": "LoadForge Test Workflow",
  "steps": [
    {
      "service": "loadforge",
      "action": "runTest",
      "parameters": {
        "testId": "123456",
        "schedule": "@hourly"
      }
    }
  ]
}
```

### Implementation Steps

**1. Install MCP Integration**

Run `npx mcp add loadforge` to set up the integration

**2. Configure Workflows**

Create automated workflows that trigger load tests based on your requirements

**3. Monitor and Optimize**

Track test results and adjust performance parameters as needed

> [!NOTE]
>
> By integrating LoadForge with MCP, you can create powerful automated testing workflows that enhance your performance testing strategy.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.