# Hoverfly

This MCP server lets an AI assistant control Hoverfly mocks. Use it to test API integrations when an external service is unavailable.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: kapishmalik
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kapishmalik/hoverfly-mcp-server
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hoverfly

## What it does

The assistant can start or stop Hoverfly, check its status, inspect active mocks, and add a mock from a JSON request-response pair. Other tools provide Hoverfly documentation, matcher suggestions, endpoint details, and recent logs. This gives the assistant a way to manage simulated API responses during development and testing.

Run the server in Docker. Port `8500` handles the proxy, while `8888` serves the admin API. To keep simulations across container restarts, mount a writable host directory at `/opt/hoverfly-mcp/simulation-data`; this is the supported location for persistent data. Simulations are saved there when `download_hoverfly_simulation` is called, and startup can load the latest saved file. Building from source requires Java 17 and Maven 3.6+.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- mock an external API response during development
- create an API mock from a JSON request-response pair
- inspect active Hoverfly mocks
- keep simulation data across container restarts
- retrieve Hoverfly logs while debugging

## Example prompts
- Start Hoverfly in simulation mode and check its status.
- Add an API mock from this JSON request-response pair.
- Save the current Hoverfly simulation to its data directory.

## Similar
- [wiremock-standalone-docker](https://affpapa.org/en/nevibecode/skills/wiremock-standalone-docker.md) — skill · 3600 installs
- [vercel-labs-emulate](https://affpapa.org/en/nevibecode/skills/vercel-labs-emulate.md) — skill · 925 installs
- [emulate](https://affpapa.org/en/nevibecode/skills/emulate.md) — skill · 568 installs
- [msw](https://affpapa.org/en/nevibecode/skills/msw.md) — skill · 912 installs
- [api-testing-observability](https://affpapa.org/en/nevibecode/plugins/api-testing-observability.md) — plugin · ★ 42780 repo stars
- [11-mcp-integration](https://affpapa.org/en/nevibecode/prompts/11-mcp-integration.md) — prompt · ★ 3444 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
