Skip to main content
Enterprise Mock Orchestration

WIXY HUB

The Central Management Plane for your WireMock Fleet

A powerful, Spring Boot-based orchestrator that simplifies service virtualisation. Connect local and remote WireMock engines, manage stubs via a modern UI, and automate everything with AI-native MCP tools.

Core Capabilities

Everything you need for enterprise HTTP service virtualisation

FLEET

Engine Orchestration

Manage multiple WireMock instances from a single Hub. Register remote servers (Staging, QA, Cloud) and switch context instantly.

UI

Modern Dashboard

A sleek React-based UI for managing your fleet. Create, edit, and search stubs visually without writing a single line of code.

STUB

Full Stub CRUD

Powerful JSON editor with live validation. Manage request matching, response templates, and priority for any registered engine.

PROXY

Per-Engine Proxy

Configure unique upstream target URLs for each engine. Record live traffic and automatically transform it into replayable stubs.

AI-NATIVE

MCP Integration

Native Model Context Protocol support. Control your proxy, manage stubs, and record traffic using natural language via AI agents.

SECURE

Enterprise Security

API-key protection for administrative operations. Optimized for multi-tenant and cloud environments with zero infrastructure overhead.

Layered Architecture

Clean separation of concerns with Spring Boot lifecycle management

Layer 4 — REST Controllers
AdminController · ProxyController · RecordingController
Layer 3 — Services
StubService · ProxyService · RecordingService
Layer 2 — Configuration
WixyProperties · SecurityConfig · WireMockConfig
Layer 1 — Embedded WireMock
WireMockServer · Stub Mappings · Proxy Engine · Recorder

Built for Enterprise

Production-grade capabilities for mission-critical test environments

🏢

Fleet Orchestration

The central Hub acts as a single management plane for multiple WireMock instances across your infrastructure.

🎨

Modern Dashboard

Manage stubs, recordings, and proxy settings via a high-performance React UI with built-in JSON validation.

🔌

Dual-Mode Engine

Seamlessly switch between an embedded Local engine and remote instances using the same unified interface.

🤖

AI-Native (MCP)

Native Model Context Protocol support allows AI agents to configure your test environment using natural language.

🛡️

Multi-Tenant Ready

Per-request targeting via the X-Wixy-Target-Server header allows sharing a single Hub across multiple projects.

🔧

Zero-Config Setup

Starts automatically with a pre-configured local engine on port 9090. No external database or setup required.

🚀

Docker & Cloud Optimized

Lightweight memory footprint and profile-based configuration make it perfect for Kubernetes and CI/CD pipelines.

Technology Stack

Modern, battle-tested libraries for enterprise reliability

Java 21Latest LTS
Spring Boot 3.4Framework
WireMock 3.13Mock Engine
Gradle 9.xKotlin DSL
SpringDocOpenAPI
JaCoCoCoverage
RestAssuredTest Client
DockerContainers

Quick Start

Up and running in under a minute

# Clone the repository
git clone https://github.com/vinipx/wixy.git
cd wixy

# Start locally (requires Java 21+)
./scripts/start-local.sh

# Or with Docker
./scripts/start-docker.sh

# Create your first stub
curl -X POST http://localhost:8080/wixy/admin/mappings \
  -H "Content-Type: application/json" \
  -d '{"request":{"method":"GET","urlPath":"/api/hello"},
       "response":{"status":200,"jsonBody":{"message":"Hello!"}}}'

# Hit it
curl http://localhost:9090/api/hello