Microcks

Microcks is a free, open-source tool for mocking and testing APIs and microservices. It supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL, and SOAP. Mocks can draw on examples, generate sample data, or transform responses dynamically. Contract testing checks provider and consumer behavior against live implementations and specification versions. Microcks can automate checks in CI/CD pipelines, with integrations for GitHub Actions, Jenkins, GitLab CI, and Tekton. Its containerized architecture can run on-premises, in the cloud, or on developer laptops. The Uber distribution is intended for laptop and unit-test use and uses temporary in-memory storage. A free community marketplace for API mocks and test suites is also available. The public demo is read-only, so it cannot import APIs or modify existing artifacts. Documentation cautions against using the all-managed Kubernetes setup in production: its single Keycloak and MongoDB instances are not tuned for scalability or security best practices.

Microcks combines API mocking, contract testing, and CI/CD automation in a free, open-source project. Note the read-only demo and the documented production limitation for the all-managed Kubernetes setup.

Microcks suits API owners, developers, quality assurance teams, and platform engineers who need to mock or test APIs and microservices. Its containerized deployment options support both laptop use and larger environments.

Overview

Microcks is an open-source platform for mocking and testing APIs and microservices. It suits API owners, developers, QA teams, and platform engineers who want mocks and contract checks in development and delivery pipelines. Its breadth across protocols and deployment options is a strong fit for teams standardizing API tests; production deployment takes more care than its laptop-oriented setup.

It supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL schemas, and SOAP. Teams can reuse examples, generate realistic ones, or transform mock data and responses dynamically. Provider and consumer contracts can be checked against live implementations and specification versions. Microcks Hub adds a free community marketplace for API mocks and test suites, enabled by default.

The project is community-driven, 100% open source, and a CNCF incubating project. The homepage announces version 1.15.0 as released. The public demo is read-only: it cannot import APIs or modify existing artifacts, so it is useful for viewing rather than trying a workflow with your own services.

Key features

Mocking and contract testing

Using examples, generated data, or transformed responses gives teams ways to model API behavior without relying on a complete implementation. Contract checks cover both consumers and providers, and can compare live behavior with specification versions. That combination is useful when teams need to catch mismatches across service boundaries, rather than only verify one endpoint in isolation.

CI/CD and ecosystem integrations

Microcks automates checks in CI/CD and provides generated code snippets for integration. Official automation integrations cover GitHub Actions, Jenkins, GitLab CI, and Tekton Pipelines. Its Backstage provider discovers APIs from Microcks instances and synchronizes them into the Backstage Software Catalog, a practical fit for teams already using that catalog.

Official Testcontainers modules support Java, NodeJS/TypeScript, Golang, and .NET; Python support is community-maintained. The CLI is distributed as binaries for Linux, macOS, and Windows, as well as a container image. These options help teams place API checks in local and automated workflows, though Python users rely on community rather than official module maintenance.

Deployment and access controls

The containerized architecture supports on-premises, cloud, and developer-laptop deployment. The Uber distribution targets laptop and unit-test use and uses in-memory MongoDB for ephemeral usage. For authentication, Microcks delegates to Keycloak using OpenID Connect Authorization Code Flow. Only administrators can manage credentials for Git repositories, API endpoints, and event brokers; documented roles are user, manager, and admin, with permissions covering repository management and instance administration.

The all-managed Kubernetes setup is convenient for discovery but is not recommended for production: its Keycloak and MongoDB instances are single instances and are not tuned for scalability or security best practices. Teams choosing a production deployment should account for that limitation rather than treating the discovery setup as production-ready.

Pricing

Microcks (open-source distribution): free. The free plan is a 100% open-source, community-driven initiative with self-hosted deployment options. No seat or usage caps are stated. It is best suited to teams able to deploy and operate the software themselves; it does not present a paid tier or managed-service option in this plan.

Microcks Hub is a free community marketplace for API mocks and test suites and is enabled by default. The AI Copilot guide supports OpenAI-compatible APIs and, in the documented Docker Desktop Extension setup, requires an OpenAI API key.

Platforms

Microcks covers API, extension, Linux, macOS, self-hosted, web, and Windows platforms. Its deployment model supports both local and hosted environments, with container-based deployment on-premises, in the cloud, or on developer laptops.

Who it's for

Microcks is a strong match for API owners and development or QA teams that need reusable mocks and consumer/provider contract checks, especially when those checks should run in CI/CD. Platform engineers can use its deployment flexibility, role model, automation integrations, and Backstage synchronization. It is less suitable for teams seeking a hands-off production Kubernetes installation or a writable public demo.

Pros and cons

• Broad protocol coverage: OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL, and SOAP support can consolidate mocking and testing across varied API styles.
• Useful contract-test scope: Checking providers and consumers against live implementations and specification versions helps address mismatches at either side of an integration.
• Pipeline and local workflow support: Official CI integrations and Testcontainers modules for four language ecosystems give teams several paths to automate checks.
• Free, self-hosted open source: There is no stated subscription price, but teams must take responsibility for deployment and operation.
• Production caveat for managed Kubernetes: The documented all-managed setup relies on single Keycloak and MongoDB instances not tuned for production scalability or security practice.
• Limited public demo: Read-only access prevents users from importing APIs or editing artifacts to evaluate their own scenarios.

Alternatives

WireMock is worth considering for teams that prefer a freemium option with a defined free allowance: its free plan includes 1,000 calls per month, one user, three mock APIs, and a 10-requests-per-second limit. Microcks instead emphasizes open-source self-hosting and contract testing across multiple specifications.

MockServer is another free, self-hosted option with no SaaS account, making it a straightforward alternative for readers who want that model.

Cavisson NetOcean may suit organizations seeking enterprise-ready backend simulation delivered as an appliance or virtual machine; it is paid and offers a free trial.

LocalStack fits readers focused on emulating AWS services: its free Hobby plan includes 30+ emulated services and one personal sandbox, with non-commercial use and basic support.

OpenText Service Virtualization offers an Express edition with three virtual services and 10 transactions per second, or an Enterprise edition with unlimited virtual services and 10 transactions per second.

Traffic Parrot is a paid option with a free trial, with pricing dependent on floating licence count and selected features, protocols, and technologies.

Azurite is a free, open-source local Azure Storage emulator for readers focused on that use case. Wilma is free GPLv3.0 software for readers considering that alternative.

Browse more options in Service Virtualization Software, Integration Testing Tools, Contract Testing Tools, API Mocking Tools, and API Design Tools.

Verdict

Choose Microcks if your team wants free, open-source API mocking and provider/consumer contract testing that can run locally and in CI/CD across multiple protocols. Its integrations and flexible deployment make it a capable shared workflow for development and platform teams. Look elsewhere if you need a production-ready all-managed Kubernetes deployment or an editable public demo; the documented managed setup is explicitly not recommended for production.