Installing WireMock Cloud AI

This guide walks you through configuring the MCP (Model Context Protocol) server necessary to natively use WireMock Cloud from an MCP-compatible AI tool such as Cursor or Claude Desktop. This enables automatic API discovery, mocking and test abstraction from any codebase as part of prompt-driven development with your chosen AI tool. Additionally, it enables you to skip the complexity of building out new services early on - which can hamper the rapid development by introducing more failure points - and instead use simulated APIs on WireMock to prototype new capabilities with less system overhead. Note that while this article documents use with Cursor, Claude Desktop and VSCode specifically, WireMock Cloud’s MCP server will work with any AI-powered tool that supports MCP.

Prerequisites

Node.js 18+ (to install the CLI)
An existing WireMock Cloud account (if you don’t have one, you can sign up during the login step)

Step 1: Install the WireMock CLI

Install the CLI globally using npm:

npm i -g @wiremock/cli

Step 2: Log in to WireMock Cloud

If you already have a WireMock Cloud account, simply log in. Otherwise, the login process will guide you through creating an account:

wiremock login

Step 3: Configure your AI tool

Cursor
VSCode + GitHub Copilot
Claude Code
Claude Desktop
Windsurf

Click this button to install with Cursor:

Or, follow these instructions:

Open Settings->Cursor settings.
Navigate to MCP.
Click Add new MCP server.
In the dialog, configure your server to run this command:

wiremock mcp

Verify Installation by looking for the green status dot next to the MCP server and the list of tool names.

If you have an existing real API integration, you can replace it with a WireMock stub. Generate the mock from documentation, source code, or other external description formats. This enables you to test your app in isolation without depending on live services.

Step 6: Confirm Your Setup

To confirm everything is working correctly, check that you’re logged in to WireMock Cloud by running the following prompt:

Am I logged into WireMock Cloud?

If logged in, you’ll see your account details rather than being prompted to sign in.

In VSCode, open the settings.json file via Settings…->Settings then clicking the Open Settings (JSON) link in the top right.

Add the mcp element to the settings JSON:

{
  "mcp": {
          "servers": {
              "WireMock": {
                  "type": "stdio",
                  "command": "wiremock",
                  "args": [
                      "mcp"
                  ]
              }
          }
      }
}

Restart VSCode

Step 6: Confirm Your Setup

Open the Copilot chat window and confirm that the tools icon is present with a number above zero:

To confirm everything is working correctly, check that you’re logged in to WireMock Cloud by running the following prompt:

Who am I logged into WireMock Cloud as?

If logged in, you’ll see your account details rather than being prompted to sign in.

Open your terminal or command prompt.
Add the WireMock MCP server using the Claude CLI:

claude mcp add wiremock -- wiremock mcp

Verify the server was added successfully:

claude mcp list

You should see “wiremock” in the list of configured MCP servers.

Step 6: Confirm Your Setup

To confirm everything is working correctly, check that you’re logged in to WireMock Cloud by running the following prompt in Claude Code:

Am I logged into WireMock Cloud?

If logged in, you’ll see your account details:

Open Settings->Developer.
Click Edit Config and open the config file in your preferred editor.
Add the WireMock MCP server to the file. The whole file will look like this if this is the first MCP server installed:

{
    "mcpServers": {
    "wiremock": {
    "command": "wiremock",
    "args": [
    "mcp"
    ]
}
}
}

Restart Claude Desktop.

Step 6: Confirm Your Setup

To confirm everything is working correctly, check that you’re logged in to WireMock Cloud by running the following prompt:

Am I logged into WireMock Cloud?

After confirming it is OK for Claude to use the tool, if logged in, you’ll see your account details rather than being prompted to sign in.

Navigate to Windsurf Settings > Cascade > Plugins.
Click Manage plugins to access the raw configuration.
Click View raw config to edit the mcp_config.json file (located at ~/.codeium/windsurf/mcp_config.json) and add:
```
{
  "mcpServers": {
    "wiremock": {
      "command": "wiremock",
      "args": ["mcp"]
    }
  }
}
```
- Save the configuration and press the refresh button in the Plugin Store.
Step 6: Confirm Your Setup
To confirm everything is working correctly, check that you’re logged in to WireMock Cloud by running the following prompt in Cascade:
```
Am I logged into WireMock Cloud?
```
If logged in, you’ll see your account details rather than being prompted to sign in.

Next Steps

With WireMock MCP successfully installed, you can begin creating and using mocks in your development workflow:

Generate a new feature and mock a new API

Develop a new feature in your application that calls a fresh API. Quickly generate a WireMock stub for this API, and then wire it up to your app while in development mode.

Swap an existing API connection for a mock

If you have an existing real API integration, you can replace it with a WireMock Cloud mock. Generate the mock from documentation, source code, or other external description formats. This enables you to test your app in isolation without depending on live services.

Concepts

Tutorials

How-to Guides

Reference

Installing WireMock Cloud AI

Prerequisites

Step 1: Install the WireMock CLI

Step 2: Log in to WireMock Cloud

Step 3: Configure your AI tool

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Next Steps

Generate a new feature and mock a new API

Swap an existing API connection for a mock

Concepts

Tutorials

How-to Guides

Reference

Documentation Index

​Prerequisites

​Step 1: Install the WireMock CLI

​Step 2: Log in to WireMock Cloud

​Step 3: Configure your AI tool

​Step 6: Confirm Your Setup

​Step 6: Confirm Your Setup

​Step 6: Confirm Your Setup

​Step 6: Confirm Your Setup

​Step 6: Confirm Your Setup

​Next Steps

​Generate a new feature and mock a new API

​Swap an existing API connection for a mock

Prerequisites

Step 1: Install the WireMock CLI

Step 2: Log in to WireMock Cloud

Step 3: Configure your AI tool

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Step 6: Confirm Your Setup

Next Steps

Generate a new feature and mock a new API

Swap an existing API connection for a mock