How do I install the hoverfly mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

SSyncDev

Start a project

Hoverfly MCP Server

A **Spring Boot**-based **Model Context Protocol (MCP)** server that exposes [Hoverfly](https://hoverfly.io/) as a programmable tool for AI

Local serverstdio

What is the Hoverfly MCP Server?

A Spring Boot-based Model Context Protocol (MCP) server that exposes Hoverfly as a programmable tool for AI assistants like

Configuration

Java 17 - Maven 3.6+

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
get_hoverfly_status	Checks if Hoverfly is running
start_hoverfly_web_server	Starts Hoverfly in simulate mode as a web server. By default, it will auto-load the most recent simulation from /opt/hoverfly-mcp/simulation-data if available, unless auto-load is disabled.
stop_hoverfly_server	Stops Hoverfly and clears mocks
fetch_hoverfly_version	Returns Hoverfly version
list_hoverfly_mocks	Lists all active mock APIs (request-response pairs)
add_hoverfly_mock	Adds a mock API using a JSON RequestResponsePair definition
clear_hoverfly_mocks	Removes all existing mock APIs
show_hoverfly_endpoints_info	Returns key Hoverfly endpoints and example usage
get_hoverfly_documentation	Returns Hoverfly documentation for a specific topic
suggest_hoverfly_matchers	Suggests matcher options for a given request-response pair JSON
get_hoverfly_debug_logs	Fetches recent Hoverfly logs for debugging (limit is optional)
download_hoverfly_simulation	Downloads current simulation to /opt/hoverfly-mcp/simulation-data (persistent simulation directory)

How to install the Hoverfly MCP Server

{
  "mcpServers": {
    "hoverfly-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-p 8500:8500",
        "-p 8888:8888",
        "-v /path/to/your/data:/opt/hoverfly-mcp/simulation-data",
        "docker.io/kapish88/hoverfly-mcp-server"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Java 17 - Maven 3.6+

Example prompts to try

“Use Hoverfly to get hoverfly status.”
“Use Hoverfly to start hoverfly web server.”
“Use Hoverfly to stop hoverfly server.”

Frequently asked questions

A **Spring Boot**-based **Model Context Protocol (MCP)** server that exposes [Hoverfly](https://hoverfly.io/) as a programmable tool for AI assistants like Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.