Skip to main content
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:Add WireMock MCP server to CursorOr, 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
Configure MCP server
  • Verify Installation by looking for the green status dot next to the MCP server and the list of tool names.
Verify the MCP server is activeIf 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.Confirm you are logged in via the CLI

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