> ## 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.

# Installing the WireMock Cloud MCP server directly

> How to connect an AI tool directly to the WireMock Cloud MCP server, without the agent skills plugin

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>
  Most users should install the [WireMock Cloud agent skills plugin](/ai-mcp/installation) instead - it bundles this same MCP server connection alongside expert guidance for your agent, with no separate setup step. Use this page if you want the MCP server on its own, without the skills plugin.
</Note>

**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.

## Choosing a server

WireMock Cloud offers two ways to connect an AI tool via MCP:

* **Remote server (recommended)** - a hosted HTTP server at `https://mcp.wiremock.cloud/mcp`. No local installation is required; your AI tool authenticates with your WireMock Cloud account via an OAuth sign-in in your browser the first time it connects.
* **Local server** - a stdio server launched on your machine by the WireMock CLI (`wiremock mcp`). Choose this if you need [HTTP request authentication](/ai-mcp/http-request-authentication) with locally stored credentials, or if your network can't reach `mcp.wiremock.cloud` directly.

Both expose the same set of [MCP tools](/ai-mcp/mcp-tools). Use whichever matches your setup - you only need one.

## Option 1: Remote server (recommended)

No prerequisites beyond an existing WireMock Cloud account - if you don't have one, the OAuth step below will guide you through creating one.

<Tabs>
  <Tab title="Cursor">
    Click this button to install with Cursor:

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=WireMock&config=eyJ1cmwiOiJodHRwczovL21jcC53aXJlbW9jay5jbG91ZC9tY3AifQ==">
      <img src="https://cursor.com/deeplink/mcp-install-light.png" alt="Add WireMock MCP server to Cursor" />
    </a>

    Or, follow these instructions:

    * Open Settings->Cursor settings.
    * Navigate to Tools & Integrations.
    * Click New MCP Server. This opens `mcp.json`.
    * Add the WireMock server:

    ```json theme={null}
    {
      "mcpServers": {
        "WireMock": {
          "url": "https://mcp.wiremock.cloud/mcp"
        }
      }
    }
    ```

    * Save the file. Cursor will show a "needs authentication" indicator next to the server - click **Connect** to complete an OAuth sign-in in your browser.

    ### Step 2: 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.
  </Tab>

  <Tab title="VSCode + GitHub Copilot">
    * 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:
      ```json theme={null}
      {
        "mcp": {
                "servers": {
                    "WireMock": {
                        "type": "http",
                        "url": "https://mcp.wiremock.cloud/mcp"
                    }
                }
            }
      }
      ```
    * Restart VSCode. VS Code will open a browser window to complete an OAuth sign-in the first time it connects - approve the trust dialog and sign in when prompted.

    ### Step 2: Confirm your setup

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

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/enabled-tools-icon.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=6f0b8e00143a232a25a3b7b7651630a4" width="50" alt="Copilot tools icon" data-path="images/ai/enabled-tools-icon.png" />

    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.

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/vscode-whoami.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=fe98ecd08cfaefb62de44b1aa6cb6f04" width="550" alt="Confirm you are logged in via the CLI" data-path="images/ai/vscode-whoami.png" />
  </Tab>

  <Tab title="Claude Code">
    * Open your terminal or command prompt.
    * Add the WireMock MCP server using the Claude CLI, specifying the HTTP transport:

    ```bash theme={null}
    claude mcp add --transport http wiremock https://mcp.wiremock.cloud/mcp
    ```

    * Verify the server was added successfully:

    ```bash theme={null}
    claude mcp list
    ```

    * You should see "wiremock" in the list of configured MCP servers. If it shows "Needs authentication", run `/mcp` inside a Claude Code session (or `claude mcp login wiremock` from the shell) and complete the OAuth sign-in that opens in your browser.

    ### Step 2: 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.
  </Tab>

  <Tab title="Claude Desktop">
    * Open Settings->Connectors.
    * Click **Add custom connector**.
    * Enter the WireMock MCP server URL:

    ```
    https://mcp.wiremock.cloud/mcp
    ```

    * Click **Add**. Claude Desktop will open a browser window to complete an OAuth sign-in immediately after the connector is added.

    ### Step 2: 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.

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/claude-whoami.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=3f560a3bbb9bc08e59f3bacde97a1edb" width="550" alt="Confirm you are logged in via the CLI" data-path="images/ai/claude-whoami.png" />
  </Tab>

  <Tab title="Windsurf">
    * 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:

      ```json theme={null}
      {
        "mcpServers": {
          "WireMock": {
            "serverUrl": "https://mcp.wiremock.cloud/mcp"
          }
        }
      }
      ```

      * Save the configuration and press the refresh button in the Plugin Store. Windsurf will prompt you to sign in via OAuth in your browser on first connection.

          <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/windsurf-manage-plugins.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=fd9589396496c688c448347826048af1" alt="Windsurf Manage Plugins" width="1590" height="650" data-path="images/ai/windsurf-manage-plugins.png" />

      ### Step 2: 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.
  </Tab>
</Tabs>

## Option 2: Local server

### 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:

```bash theme={null}
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:

```bash theme={null}
wiremock login
```

### Step 3: Configure your AI tool

<Tabs>
  <Tab title="Cursor">
    Click this button to install with Cursor:

    <a href="cursor://anysphere.cursor-deeplink/mcp/install?name=WireMock&config=eyJjb21tYW5kIjoid2lyZW1vY2sgbWNwIn0=">
      <img src="https://cursor.com/deeplink/mcp-install-light.png" alt="Add WireMock MCP server to Cursor" />
    </a>

    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:

    ```bash theme={null}
    wiremock mcp
    ```

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/server-config.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=df6d4771527a298267fc9413414cab13" width="360" alt="Configure MCP server" data-path="images/ai/server-config.png" />

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

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/enabled-server.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=e01a0c1bf07faca6c29affcb5b2827b0" alt="Verify the MCP server is active" width="1232" height="258" data-path="images/ai/enabled-server.png" />

    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 4: 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.

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/logged-in.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=ff1b697ef56c5ebd4bd829c14ad3c95e" width="550" alt="Confirm you are logged in via the CLI" data-path="images/ai/logged-in.png" />
  </Tab>

  <Tab title="VSCode + GitHub Copilot">
    * 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:
      ```json theme={null}
      {
        "mcp": {
                "servers": {
                    "WireMock": {
                        "type": "stdio",
                        "command": "wiremock",
                        "args": [
                            "mcp"
                        ]
                    }
                }
            }
      }
      ```
    * Restart VSCode

    ### Step 4: Confirm your setup

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

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/enabled-tools-icon.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=6f0b8e00143a232a25a3b7b7651630a4" width="50" alt="Copilot tools icon" data-path="images/ai/enabled-tools-icon.png" />

    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.

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/vscode-whoami.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=fe98ecd08cfaefb62de44b1aa6cb6f04" width="550" alt="Confirm you are logged in via the CLI" data-path="images/ai/vscode-whoami.png" />
  </Tab>

  <Tab title="Claude Code">
    * Open your terminal or command prompt.
    * Add the WireMock MCP server using the Claude CLI:

    ```bash theme={null}
    claude mcp add wiremock -- wiremock mcp
    ```

    * Verify the server was added successfully:

    ```bash theme={null}
    claude mcp list
    ```

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/claude-code-mcp-install.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=0fb766fc40bfa3d99176a98123b81fd2" width="500" alt="Claude Code MCP install" data-path="images/ai/claude-code-mcp-install.png" />

    * You should see "wiremock" in the list of configured MCP servers.

    ### Step 4: 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:

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/claude-code-success.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=8d289f3d8441ae39fd94a8f19f8c7f28" alt="Claude Code MCP success" width="1562" height="904" data-path="images/ai/claude-code-success.png" />
  </Tab>

  <Tab title="Claude Desktop">
    * 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:

    ```json theme={null}
    {
        "mcpServers": {
        "wiremock": {
        "command": "wiremock",
        "args": [
        "mcp"
        ]
    }
    }
    }
    ```

    * Restart Claude Desktop.

    ### Step 4: 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.

    <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/claude-whoami.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=3f560a3bbb9bc08e59f3bacde97a1edb" width="550" alt="Confirm you are logged in via the CLI" data-path="images/ai/claude-whoami.png" />
  </Tab>

  <Tab title="Windsurf">
    * 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:

      ```json theme={null}
      {
        "mcpServers": {
          "wiremock": {
            "command": "wiremock",
            "args": ["mcp"]
          }
        }
      }
      ```

      * Save the configuration and press the refresh button in the Plugin Store.

          <img src="https://mintcdn.com/wiremockinc/46NqgX7QaQdjW6uv/images/ai/windsurf-manage-plugins.png?fit=max&auto=format&n=46NqgX7QaQdjW6uv&q=85&s=fd9589396496c688c448347826048af1" alt="Windsurf Manage Plugins" width="1590" height="650" data-path="images/ai/windsurf-manage-plugins.png" />

      ### Step 4: 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.
  </Tab>
</Tabs>

## 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.