Skip to main content
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

Install the WireMock CLI and configure your AI tool:
  1. Install the CLI: npm i -g @wiremock/cli
  2. Log in: wiremock login
  3. Configure MCP integration
View Full Installation Guide →

Supported Tools

WireMock integrates with AI development environments via the Model Context Protocol:
CursorCursor
VS CodeVS Code
C
Claude
GitHubCopilot
Compatible with: Cursor, VS Code, Claude Code, Claude Desktop, GitHub Copilot, Augment, Windsurf, and other MCP-compatible tools. View All Available Tools →

Server Configuration Options

The MCP server is started with the wiremock mcp command (see the installation guide). 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:
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 page (for example delete_mock_api, make_http_request). If the option is omitted or given an empty value, all tools are available.
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.

Disabling HTTP authentication injection

By default, the make_http_request tool automatically attaches configured credentials for matching hosts (see HTTP Request Authentication). Use --no-http-auth-injection to turn this off:
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.
Both options can be combined, for example wiremock mcp --disabled-tools=delete_mock_api,clear_mock_api --no-http-auth-injection.

Use Cases

Creating Stateful Mock APIs

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.

📺 Watch: Converting Static APIs to Dynamic

API Discovery and Documentation

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.

📺 Watch: AI-Powered API Exploration

Mock Drift Detection

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.

📺 Watch: Resolving Mock Drift

GraphQL API Behavior Definition

Prototype a GraphQL API schema, instantly simulate it then refine its data and improve realism.

📺 Watch: GraphQL API with AI

API Dependency Isolation

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.

📺 Watch: Swapping APIs for Mocks

AI-Driven API Prototyping

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.

📺 Watch: API Prototyping with AI

Authenticated HTTP Requests

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.

🔐 Learn: HTTP Request Authentication

Webinars