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

# WireMock Cloud AI

> API simulation tools for AI-assisted development workflows

WireMock Cloud provides API simulation capabilities that integrate with AI development tools through the Model Context Protocol (MCP). This enables AI assistants to create, manage, and test against mock APIs directly within your development environment.

## Key Capabilities

**API Simulation**\
Create mock APIs from existing code, OpenAPI specifications, or natural language descriptions using AI assistance.

**Codebase Integration**\
Generate mocks that reflect your existing API patterns and data structures by analyzing your codebase.

**Testing with AI Agents**\
Allow AI coding assistants to validate generated code by testing against realistic mock responses.

**Independent Development**\
Work on features that depend on APIs still in development by creating temporary mock implementations.

## Installation

The recommended way to get started is the [WireMock Cloud agent skills plugin](/ai-mcp/agent-skills) - it gives your coding agent both expert WireMock Cloud workflows and a ready-configured connection to the hosted MCP server, with no separate setup step.

[**View the plugin installation guide →**](/ai-mcp/installation)

If you'd rather connect an AI tool directly to the MCP server without the skills plugin, see the [MCP server installation guide](/ai-mcp/mcp-installation), which covers both the remote, hosted server and a local, CLI-based alternative.

## Supported Tools

WireMock integrates with AI development environments via the Model Context Protocol:

<div style={{display: 'flex', gap: '16px', alignItems: 'center', margin: '15px 0', flexWrap: 'wrap'}}>
  <div style={{display: 'flex', alignItems: 'center', gap: '6px'}}>
    <img src="https://cursor.com/brand/icon.svg" alt="Cursor" style={{width: '16px', height: '16px', objectFit: 'contain', pointerEvents: 'none'}} />

    <span style={{fontSize: '14px'}}>Cursor</span>
  </div>

  <div style={{display: 'flex', alignItems: 'center', gap: '6px'}}>
    <img src="https://code.visualstudio.com/assets/images/code-stable.png" alt="VS Code" style={{width: '16px', height: '16px', objectFit: 'contain', pointerEvents: 'none'}} />

    <span style={{fontSize: '14px'}}>VS Code</span>
  </div>

  <div style={{display: 'flex', alignItems: 'center', gap: '6px'}}>
    <div style={{width: '16px', height: '16px', backgroundColor: '#D97706', borderRadius: '50%', display: 'flex', alignItems: 'center', justifyContent: 'center', color: 'white', fontWeight: 'bold', fontSize: '10px', flexShrink: 0}}>C</div>
    <span style={{fontSize: '14px'}}>Claude</span>
  </div>

  <div style={{display: 'flex', alignItems: 'center', gap: '6px'}}>
    <img src="https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png" alt="GitHub" style={{width: '16px', height: '16px', objectFit: 'contain', pointerEvents: 'none'}} />

    <span style={{fontSize: '14px'}}>Copilot</span>
  </div>
</div>

Compatible with: Cursor, VS Code, Claude Code, Claude Desktop, GitHub Copilot, Augment, Windsurf, and other MCP-compatible tools.

[**View All Available Tools →**](/ai-mcp/mcp-tools)

## Server Configuration Options

<Note>
  These options apply to the **local** MCP server only, since they're flags passed to the `wiremock mcp` command. The remote, hosted server does not currently support per-connection tool restrictions.
</Note>

The local MCP server is started with the `wiremock mcp` command (see the [MCP server installation guide](/ai-mcp/mcp-installation)). Append the following options to that command to control the surface the server exposes to your AI tool.

### Restricting available tools

Use `--disabled-tools` to exclude specific tools from the server — for example, to stop an agent from deleting or clearing mock APIs. It takes a comma-separated list of tool names:

```bash theme={null}
wiremock mcp --disabled-tools=delete_mock_api,clear_mock_api
```

The named tools are removed before the server starts, so they never appear in the tool list and cannot be called. Tool names are the identifiers listed on the [Available Tools](/ai-mcp/mcp-tools) page (for example `delete_mock_api`, `make_http_request`). If the option is omitted or given an empty value, all tools are available.

<Warning>
  Startup **fails** if any name does not match a registered tool. This is deliberate: a typo can never silently leave a tool you meant to disable exposed. The error lists the available tool names so you can correct the mistake.
</Warning>

### Disabling HTTP authentication injection

By default, the `make_http_request` tool automatically attaches configured credentials for matching hosts (see [HTTP Request Authentication](/ai-mcp/http-request-authentication)). Use `--no-http-auth-injection` to turn this off:

```bash theme={null}
wiremock mcp --no-http-auth-injection
```

With this flag set, no stored credential is ever attached to outbound requests, even when a matching authenticator is configured. The `make_http_request` tool itself remains available for fetching public URLs.

<Note>
  Both options can be combined, for example `wiremock mcp --disabled-tools=delete_mock_api,clear_mock_api --no-http-auth-injection`.
</Note>

## Use Cases

<div style={{display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))', gap: '24px', margin: '20px 0'}}>
  <div>
    <h3>Creating Stateful Mock APIs</h3>
    <p>Transform static mock APIs into dynamic, stateful versions that maintain state between requests. AI assists in validating mock behavior as it evolves, enabling realistic simulation of complex API interactions and multi-step workflows.</p>
    <p><a href="https://www.youtube.com/watch?v=lS7Ytj2GkUo" target="_blank" rel="noopener noreferrer">📺 Watch: Converting Static APIs to Dynamic</a></p>
  </div>

  <div>
    <h3>API Discovery and Documentation</h3>
    <p>Use AI to explore and document undocumented APIs by automatically discovering endpoints, analyzing responses, and generating comprehensive documentation. This is especially valuable when working with legacy systems or third-party APIs.</p>
    <p><a href="https://www.youtube.com/watch?v=ogK6_7FYxv0" target="_blank" rel="noopener noreferrer">📺 Watch: AI-Powered API Exploration</a></p>
  </div>

  <div>
    <h3>Mock Drift Detection</h3>
    <p>Detect and resolve discrepancies between mock APIs and their OpenAPI specifications using AI assistance. Automatically identify when mocks drift from intended behavior and update them to maintain consistency with API contracts.</p>
    <p><a href="https://www.youtube.com/watch?v=kvDyXbKBJDE" target="_blank" rel="noopener noreferrer">📺 Watch: Resolving Mock Drift</a></p>
  </div>

  <div>
    <h3>GraphQL API Behavior Definition</h3>
    <p>Prototype a GraphQL API schema, instantly simulate it then refine its data and improve realism.</p>
    <p><a href="https://www.youtube.com/watch?v=e8fI4ZjYwVM" target="_blank" rel="noopener noreferrer">📺 Watch: GraphQL API with AI</a></p>
  </div>

  <div>
    <h3>API Dependency Isolation</h3>
    <p>Generate mock endpoints for your application's API dependencies and swap real APIs for mocks during development and testing. This enables isolated development without external service dependencies, improving reliability and reducing development costs.</p>
    <p><a href="https://www.youtube.com/watch?v=JHcbFhFbBCY" target="_blank" rel="noopener noreferrer">📺 Watch: Swapping APIs for Mocks</a></p>
  </div>

  <div>
    <h3>AI-Driven API Prototyping</h3>
    <p>Leverage AI agents to prototype APIs that don't yet exist, allowing teams to develop against future services before backend implementation. Create realistic endpoint behaviors and response patterns to unblock frontend development and testing workflows.</p>
    <p><a href="https://www.youtube.com/watch?v=usBZNA4Zc7c" target="_blank" rel="noopener noreferrer">📺 Watch: API Prototyping with AI</a></p>
  </div>

  <div>
    <h3>Authenticated HTTP Requests</h3>
    <p>Configure automatic authentication for AI-driven HTTP requests without exposing credentials to the language model. Set up domain-based authentication with OAuth, API keys, or custom headers to enable secure API exploration and testing workflows.</p>
    <p><a href="/ai-mcp/http-request-authentication">🔐 Learn: HTTP Request Authentication</a></p>
  </div>
</div>

## Webinars

<div style={{display: 'grid', gridTemplateColumns: 'repeat(auto-fit, minmax(300px, 1fr))', gap: '20px', margin: '20px 0'}}>
  <div>
    <iframe width="100%" height="200" src="https://www.youtube.com/embed/W8nrLA7RXK4" title="WireMock AI Webinar" style={{border: 'none'}} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </div>

  <div>
    <iframe width="100%" height="200" src="https://www.youtube.com/embed/3gK1yi7SeGM" title="WireMock AI Deep Dive" style={{border: 'none'}} allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />
  </div>
</div>