mockoon-mcp
Allows GitHub Copilot to create and manage Mockoon mock APIs through natural language.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mockoon-mcp create a new environment for a pet store API"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mockoon-mcp
An MCP server that lets AI assistants (Claude, GitHub Copilot, Cursor, etc.) create and manage Mockoon mock APIs through natural language.
Requirements
Node.js 18+
Mockoon Desktop — for managing environment files via the UI
Mockoon CLI (optional) — required only if you want to use the
start_server/stop_servertools to start mock servers programmatically (npm install -g @mockoon/cli)
Related MCP server: RequestBin MCP Server
Configuration
No installation needed. Configure your AI client using npx:
VS Code / GitHub Copilot
Create .vscode/mcp.json in your workspace:
{
"servers": {
"mockoon": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mockoon": {
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:
{
"mcpServers": {
"mockoon": {
"command": "npx",
"args": ["-y", "mockoon-mcp@latest"]
}
}
}Environment variables
Variable | Description |
| Override the primary storage directory (default: Mockoon Desktop's storage folder) |
| Semicolon-separated list of additional directories to search for environment files |
Default storage path:
Windows:
%APPDATA%\mockoon\storagemacOS/Linux:
~/.config/mockoon/storage
Example:
"env": {
"MOCKOON_DATA_DIRS": "/path/to/dir1;/path/to/dir2"
}Available Tools
Environments
Tool | Description |
| List all environments with file path and port |
| Create a new environment |
| Permanently delete an environment file |
Routes
Tool | Description |
| List all routes in an environment (UUID, method, endpoint, response count) |
| Inspect a single route with all responses, rules, headers and body |
| Create a route with a single default response |
| Create a route + N responses (default + conditionals) in one call |
| Create N routes in one call — ideal for scaffolding an entire API |
| Update method, endpoint, documentation and/or default response fields |
| Clone a route (all responses included) with new UUIDs |
| Delete a route and all its responses |
| Add a conditional/alternative response to an existing route |
| Change which response is marked as default |
| Return the current default response (quick inspect) |
Databuckets (Templates)
Tool | Description |
| List all databuckets in an environment |
| Create a new databucket |
| Update the content of a databucket |
| Delete a databucket |
Server
Tool | Description |
| Start a mock server for an environment |
| Stop a running mock server |
| List all currently running mock servers |
Note:
start_serverandstop_serverrequire Mockoon CLI to be installed globally (npm install -g @mockoon/cli). If you only use Mockoon Desktop, these tools will not work — but all other tools (environments, routes, databuckets) work without CLI.
Example Prompts
Here are some example phrases you can say to your AI assistant to interact with Mockoon via this MCP server:
Exploring environments and routes
"List all available Mockoon environments."
"Show me all the routes in the Taccuino environment."
"Get the full detail of route
GET /users/:id, including all responses and rules."
Creating routes
"Create a
GET /productsroute in the Demo API environment that returns a JSON array of 3 products with status 200.""Add a
POST /auth/loginroute with two responses: 200 with a token body and 401 Unauthorized.""Scaffold a full CRUD API for a
Taskresource under/tasksin the Demo environment."
Updating and managing routes
"Change the default response of
GET /usersto return status 204 with an empty body.""Duplicate the
GET /ordersroute.""Delete the
DELETE /legacy/endpointroute from the environment.""Add a conditional 403 response to
POST /documentsthat triggers when theX-Roleheader equalsguest."
Databuckets
"Create a databucket called
UserListin the Demo API with a JSON array of 5 fake users.""Update the
ProductCatalogdatabucket with a new list of items."
Server management
"Start the mock server for the Taccuino environment."
"Stop all running mock servers."
"Which Mockoon environments are currently running?"
How It Works
The server communicates via stdio (JSON-RPC 2.0). It reads and writes Mockoon's environment JSON files directly, no REST API involved.
Changes made by the MCP server are reflected in Mockoon Desktop automatically if the Environment file watcher is enabled. Go to Application → Settings and set it to Auto for silent reloads.
License
MIT — see LICENSE.
Available Tools
21 toolsadd_route_responseB
Add a new conditional or alternative response to an existing route. Use rules to define when this response is activated.
Inputs: environmentId (required), routeId (required), statusCode, body, +6 more.
bulk_create_routesA
Create multiple routes at once. Each item in the array follows the same structure as create_route_with_responses. Ideal for scaffolding an entire API in one call.
Inputs: environmentId (required), routes (required).
create_environmentB
Create a new Mockoon environment
Inputs: name (required), port (required).
create_routeA
Create a new HTTP route with a single default response. Use create_route_with_responses to add multiple responses in one call.
Inputs: environmentId (required), method (required), endpoint (required), documentation, +4 more.
create_route_with_responsesB
Create a new HTTP route together with all its responses (default + conditionals) in a single call. The first response in the list is treated as the default unless one has isDefault=true.
Inputs: environmentId (required), method (required), endpoint (required), responses (required), +1 more.
create_templateC
Create a new databucket (data template) in a Mockoon environment
Inputs: environmentId (required), name (required), value (required).
delete_environmentA
Delete a Mockoon environment by UUID. The environment file will be permanently removed from disk.
Inputs: environmentId (required).
delete_routeA
Delete a route and all its responses from a Mockoon environment.
Inputs: environmentId (required), routeId (required).
delete_templateB
Delete a databucket from a Mockoon environment
Inputs: environmentId (required), templateId (required).
duplicate_routeA
Clone an existing route (with all its responses) into the same environment. All UUIDs are regenerated. The copy gets '(copy)' appended to its documentation.
Inputs: environmentId (required), routeId (required).
get_default_responseA
Return the current default response of a route (status code, headers, body). Use get_route for full details including all responses.
Inputs: environmentId (required), routeId (required).
get_routeA
Return full details of a single route including all responses (status codes, labels, rules, headers, body).
Inputs: environmentId (required), routeId (required).
list_environmentsA
List all local Mockoon environment files. Returns the file path for each environment, which can be passed to start_mock. Searches the default storage directory and any extra directories set via MOCKOON_DATA_DIRS.
Inputs: no named parameters.
list_routesA
List all routes in a Mockoon environment with their UUIDs, method, endpoint and number of responses.
Inputs: environmentId (required).
list_running_serversA
List the UUIDs of all Mockoon environments currently running as mock servers.
Inputs: no named parameters.
list_templatesB
List all databuckets (data templates) in a Mockoon environment
Inputs: environmentId (required).
set_default_responseA
Set an existing response as the default for a route (demotes all other responses). Use get_route to list response UUIDs.
Inputs: environmentId (required), routeId (required), responseId (required).
start_serverA
Start a Mockoon mock server from a local environment JSON file. Use list_environments to find available file paths. Returns immediately with an error if the server is already running.
Inputs: environmentId (required), port.
stop_serverA
Stop a running Mockoon mock server. Returns an error message if no server is running for the given environment.
Inputs: environmentId (required).
update_routeB
Update a route's method, endpoint, documentation and/or its default response (body, status code, headers). Only provided fields are changed.
Inputs: environmentId (required), routeId (required), method, endpoint, +4 more.
update_templateD
Update the content of an existing databucket
Inputs: environmentId (required), templateId (required), value (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Each tool targets a specific operation on a distinct resource (environments, routes, responses, templates, servers). Tools like get_route and get_default_response are clearly differentiated by scope. No two tools have overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create_environment, list_routes, set_default_response). No mixed conventions or irregular names.
21 tools is well-scoped for an API mocking server. It covers environment, route, response, template, and server lifecycle without excess. Each tool serves a clear purpose.
The tool set covers CRUD for routes, environments, and templates, plus server start/stop and response management. A notable gap is the lack of an update_environment tool, but overall the surface is comprehensive for typical mocking workflows.
Maintenance
Related MCP Connectors
AI-native mock API server with MCP. Create REST/SOAP mocks from Claude, Cursor, or Windsurf.
AI-callable tools for API mocking, testing, monitoring, security, and automation.
Build, debug and break hosted mock APIs from Claude: endpoints, stateful CRUD data, OpenAPI import, response variants and fault injection.
Build, validate, and manage API simulations in WireMock Cloud from MCP-compatible AI agents.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables AI assistants to configure and manage session-based REST and WebSocket mock servers for application development and testing. It allows for dynamic endpoint setup, request history inspection, and real-time WebSocket communication through natural language commands.8MIT

RequestBin MCP Serverofficial
AlicenseAqualityDmaintenanceEnables AI coding agents to create webhook bins, inspect and replay HTTP requests, and stand up mock API endpoints directly from the editor.1313 npmMIT- AlicenseNot gradedqualityDmaintenanceEnables instant creation of mock API servers from OpenAPI specs or natural language descriptions, with built-in fake data generation, CRUD endpoints, and configurable delays/errors for testing.MIT
- AlicenseBqualityDmaintenanceEnables AI to manage whistle mock rules, values, and inspect network sessions, facilitating API mocking and debugging through natural language.178 npm1MIT