Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Microcks

microcks.io

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • Browser extension
  • API
  • Self-hosted
8.1 Club score Visit microcks.io

What Microcks is

Microcks is a free, open-source tool for mocking and testing APIs and microservices. It supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL and SOAP. Mock responses can reuse examples, generate realistic examples or transform data and 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 Pipelines. Its containerized architecture supports deployment on-premises, in the cloud or on developer laptops. The Uber distribution is designed for laptop and unit-test use, with in-memory MongoDB for temporary usage. Microcks Hub provides a free community marketplace for API mocks and test suites. The public demo is read-only and 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.

Who it suits

Microcks suits API owners, developers, quality assurance teams and platform engineers who need mock services or contract checks in development and CI/CD. Teams can choose a laptop, cloud or on-premises deployment, but should distinguish the discovery-oriented all-managed Kubernetes setup from a production deployment.

Good to know, and what to watch

  • Supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL and SOAP.
  • Checks provider and consumer contracts against live implementations.
  • Integrates with four listed CI/CD systems.
  • Can run on-premises, in the cloud or on laptops.
  • Includes a free community marketplace for API mocks.
  • Public demo is read-only.
  • All-managed Kubernetes setup is not recommended for production.
  • Python Testcontainers support is community-maintained.

Microcks (open-source distribution)

Free

Free plan

Getting started

  1. Open the Microcks website
  2. Choose a self-hosted, cloud, on-premises, or laptop deployment approach
  3. Install the CLI on Linux, macOS, or Windows, or use its container image
  4. Use the Uber distribution for laptop and unit-test scenarios
  5. Connect supported API specifications and configure automation integrations

Limits to check

The public demo permits viewing only; it cannot import new APIs or change artifacts. Documentation says the all-managed Kubernetes setup is not recommended for production because its single Keycloak and MongoDB instances are not tuned for scalability or security best practices.

The Club's review

Microcks is an open-source platform for mocking APIs and microservices and checking provider and consumer contracts. It suits API owners, developers, QA teams and platform engineers who need one workflow across specifications, test data and delivery pipelines. Its strongest case is a self-hosted, specification-driven test service; teams wanting a managed, production-ready Kubernetes stack or an editable public sandbox should look elsewhere.

Overview

Microcks is a 100% open-source, community-driven CNCF Incubating project. It works with OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL schemas and SOAP, so it can span synchronous APIs, event-oriented contracts and established enterprise services. The homepage announces version 1.15.0.

Microcks Hub is enabled by default and provides a free community marketplace for API mocks and test suites. The public demonstration instance is read-only, which makes it useful for browsing examples but not for importing an API or changing an artifact. Teams that need to build and manage their own mocks must run their own instance.

Key features

Mocking and contract testing

Mocks can reuse supplied examples, generate realistic examples, or transform request and response data dynamically. That flexibility helps developers work before an implementation is complete and lets testers exercise controlled variations without rewriting a service. Contract testing checks both provider and consumer behavior against live implementations and against specification versions, making it useful for catching drift on either side of an integration.

Automation and integrations

Microcks automates checks in CI/CD and generates code snippets for integration work. Official automation integrations cover GitHub Actions, Jenkins, GitLab CI and Tekton Pipelines. A Backstage provider discovers APIs from Microcks instances and synchronizes them into the Backstage Software Catalog, which is valuable for platform teams maintaining a service catalogue.

Test data and developer tooling

Official Testcontainers modules support Java, NodeJS/TypeScript, Golang and .NET; Python support is community-maintained. CLI binaries are available for Linux, macOS and Windows, and the CLI is also distributed as a container image. Microcks Hub adds a shared source of mocks and suites, while the documented AI Copilot supports OpenAI-compatible APIs and, in the Docker Desktop Extension setup, requires an OpenAI API key.

Security and access

Authentication is delegated to Keycloak through the OpenID Connect Authorization Code Flow. Only Microcks administrators can manage credentials for Git repositories, API endpoints and event brokers. Default documented roles are user, manager and admin, with permissions covering repository management and instance administration. This is a sensible separation for teams sharing an installation, but it leaves identity and credential operations tied to the surrounding Keycloak setup.

Pricing

Microcks (open-source distribution): free. The plan is a 100% open-source, community-driven initiative with self-hosted deployment options. There are no published seat, request or time limits, but operating the infrastructure and its supporting services remains the customer's responsibility. The free distribution is therefore best for teams able to run and maintain their own environment, rather than buyers seeking vendor-managed support or a hosted quota.

Platforms

Microcks supports API, extension, Linux, macOS, self-hosted, web and Windows use. Its containerized architecture can run on-premises, in the cloud or on developer laptops. The Uber distribution targets laptop and unit-test use and uses in-memory MongoDB for ephemeral operation. The all-managed Kubernetes setup is convenient for discovery, but its single-instance Keycloak and MongoDB are not tuned for scalability or security best practices, so it is not recommended for production.

Who it's for

Choose Microcks when API owners, developers, QA and platform engineers need specification-based mocks plus contract checks in the same self-hosted workflow. It is particularly well suited to organizations standardizing CI/CD checks across several API protocols, or to teams that want to keep test data and service virtualization close to their own infrastructure.

It is a weaker fit for a small team that wants a hosted mock endpoint with a simple commercial quota, or for an organization unwilling to operate Keycloak, MongoDB and the surrounding container platform. The read-only demo also cannot substitute for a working evaluation environment.

Pros and cons

Pros

  • Broad specification coverage: OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL and SOAP support can consolidate mixed API estates.
  • One workflow for mocks and contracts: Dynamic examples and provider/consumer checks address both early development and integration validation.
  • Strong pipeline reach: GitHub Actions, Jenkins, GitLab CI and Tekton integrations reduce custom CI work.
  • Open deployment choices: Laptop, on-premises and cloud deployment suit teams with different infrastructure policies.
  • Open-source economics: The distribution costs nothing and has no published usage quota.

Cons

  • Self-hosting is part of the deal: Teams must run the platform and its dependencies rather than buying a managed service.
  • Production caveat for the managed Kubernetes setup: Single-instance Keycloak and MongoDB limit its suitability for scalable, security-sensitive production use.
  • Demo restrictions: The public instance cannot import APIs or edit artifacts, limiting evaluation from a browser.
  • Uneven language coverage: Python Testcontainers support is community-maintained rather than official.

Alternatives

For a hosted or quota-based mock service, compare Beeceptor, whose Individual plan is $10 a month with 15,000 requests per endpoint and private endpoints. WireMock suits users wanting a freemium service with a Free plan capped at 1,000 calls per month, one user and three mock APIs. The separate WireMock listing is a web and self-hosted option with the same 1,000-call Free allowance and a 10-requests-per-second limit.

Mockzilla is a freemium alternative with a Free plan limited to 1,000 requests per month, 5 requests per second, one simulation and 10 MB of transfer. Mockttp is free and focused on traffic viewing, rewriting, breakpoints and an HTTP client. For paid enterprise testing, Parasoft SOAtest offers tailored pricing. Knockout API provides a free plan with 30 images per month and metered usage beyond it. Mockfly has a free Starter plan with 500 requests per day, one project and four endpoints.

Verdict

Microcks is a strong choice for teams that want open-source, self-hosted API virtualization and contract testing across multiple specifications, with CI/CD and catalogue integrations included. Choose it for control, breadth and an uncapped free distribution; look elsewhere if you need a managed production service, a genuinely editable public trial or a simple hosted pricing model.

The verdict

Microcks covers API mocking and contract testing across several common specifications, with deployment options for development and broader use. The public demo cannot be edited, and the all-managed Kubernetes setup is described as unsuitable for production.

Questions people ask

Is Microcks free?

Yes. The Microcks open-source distribution costs nothing and is 100% open source.

Which API formats does Microcks support?

It supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL schemas, and SOAP.

Where can Microcks run?

Its containerized architecture supports on-premises, cloud, and developer-laptop deployment. CLI binaries are available for Linux, macOS, and Windows.

Which CI/CD systems integrate officially?

Official integrations include GitHub Actions, Jenkins, GitLab CI, and Tekton Pipelines.

Does Microcks provide a marketplace?

Microcks Hub is a free community marketplace for API mocks and test suites, enabled by default.

How is access managed?

Authentication is delegated to Keycloak through OpenID Connect Authorization Code Flow, and only administrators can manage repository, endpoint, and event-broker credentials.

What the maker publishes

Access roles
The documented default roles are user, manager, and admin, with permissions for repository management and instance administration. source
AI feature limit
The AI Copilot guide says the feature supports OpenAI-compatible APIs at the time of writing and requires an OpenAI API key in the documented Docker Desktop Extension setup. source
Audience
The project describes use cases for API owners, developers, quality assurance teams, and platform engineers. source
Backstage
The Backstage provider discovers APIs from Microcks instances and synchronizes them into the Backstage Software Catalog. source
CI/CD
It provides integrations for GitHub Actions, Jenkins, GitLab CI, and Tekton pipelines. source
CI/CD automation
It automates checks in CI/CD pipelines and provides auto-generated code snippets for integration. source
CLI platforms
Microcks CLI binaries are available for Linux, macOS and Windows, and the CLI is also distributed as a container image. source
Contract testing
Microcks performs provider and consumer contract testing against live implementations and specification versions. source
Contract testing
It performs provider and consumer contract tests against live implementations and different specification versions. source
Current release
The homepage announces Microcks version 1.15.0 as released. source
Demo limitation
The public demo is read-only and cannot import new APIs or modify existing artifacts. source
Deployment
Its containerized architecture supports deployment on-premises, in the cloud, or on developer laptops. source
Deployment
Microcks can be installed using Docker Desktop Extension, Docker or Podman Compose, Helm, or a Kubernetes Operator. source
Dynamic mocking
Mocking can reuse examples, generate realistic examples, or transform mock data and responses. source
Integrations
Official automation integrations include GitHub Actions, Jenkins, GitLab CI and Tekton Pipelines. source
Local use
The Uber distribution is designed for laptop and unit-test use and uses in-memory MongoDB for ephemeral usage. source
Marketplace
Microcks Hub is described as a free community marketplace for API mocks and test suites, and is enabled by default in Microcks. source
Mocking
It can reuse examples, generate realistic examples, and transform mock data and responses on the fly. source
Open source
Microcks is a 100% open source, community-driven CNCF Incubating project. source
Production deployment limit
The documentation says the all-managed Kubernetes setup is convenient for discovery but is not recommended for production because its Keycloak and MongoDB instances are single instances not tuned for scalability or security best practices. source
Project status
Microcks is a CNCF incubating project and a 100% open-source, community-driven initiative. source
Protocols
It supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL and SOAP. source
Purpose
Microcks is a tool for mocking and testing APIs and microservices. source
Purpose
Microcks is a tool for mocking and testing APIs and microservices. source

Checked against the maker's pages on 2 Oct 2026.