❯ runner & cli

Run simulations closer to your code — and your AI

WireMock Runner brings API simulation deeper into your workflow. Now you and your agents can manage pre-production environments from the CLI or IDE, record APIs in your local network, and promote mocks through CI/CD pipelines.

Get a demo Read the docs

The testing foundation for your AI SDLC

Run WireMock as code

Your mock APIs are versioned files that can be pulled, committed, and code-reviewed like anything else. Agents can record and spin up a simulation through simple CLI commands, or using the WireMock MCP.

An editor showing a .wiremock directory of versioned simulation files, with an openapi.yaml OpenAPI spec open.

Mock anything, even off the public web

Point the CLI at any endpoint, including internal services behind your firewall, and record it into an editable simulation. Traffic never has to leave your network; your agents get to build against the private APIs they'd otherwise never reach in a bounded cleanroom that you control.

A coding agent crawling the PayPal invoicing API sandbox into a WireMock mock API — looking up the crawling docs over MCP, then starting a recording session.

Enable local-first development

Bring the entire simulated environment up on a laptop in seconds. No shared staging to queue for, no flaky remote dependencies to blame. Claude Code, Cursor, or any agent gets a fast, deterministic sandbox to write and verify code against, then tear down when the task is done.

A terminal running wiremock run, listing local simulated services and their HTTP ports.

Kick off with some examples

# install the CLI (Node 18+)
❯ npm install --global @wiremock/cli
✓ installed @wiremock/cli

# sign in to WireMock Cloud
❯ wiremock login
✓ authenticated as dan@acme.dev

❯ wiremock whoami
dan@acme.dev · acme (team plan)

# bring every mock API in .wiremock up on its own port
❯ wiremock run

✓ loaded 3 mock APIs from .wiremock

  MOCK API            PORT    URL
  ───────────────────────────────────────────────
  payments-sandbox    8080    http://localhost:8080
  identity-api        8081    http://localhost:8081
  shipping-api        8082    http://localhost:8082

running — press Ctrl+C to stop

# capture a real (even private) API into an editable simulation
❯ wiremock record https://api.internal.acme.dev --to=cloud:33eye3l9

✓ reverse proxy on :8000 — send your traffic through it
  › POST /v1/payments          201   captured
  › GET  /v1/payments/{id}     200   captured
  › GET  /v1/customers/{id}    200   captured
✓ 18 interactions saved to payments-sandbox

# .github/workflows/integration.yml
- name: Start simulations
  run: |
    npm install --global @wiremock/cli
    wiremock run &          # background the runner

- name: Integration tests
  run: npm test            # hits http://localhost:8080

# give your coding agent every WireMock capability
❯ claude mcp add wiremock -- wiremock mcp
✓ added stdio MCP server wiremock

❯ claude mcp list
wiremock: wiremock mcp — ✓ connected

# same server works in Cursor, Copilot & any MCP client

Explore the full CLI reference in the docs

One command away from running everywhere

Install the CLI and bring your first simulation up locally in under a minute — or get the guided tour.