Overview

Microcks is an open-source API and microservice mocking and contract-testing platform for teams that need to work from API specifications. It suits API owners, developers, QA teams and platform engineers who want mocks and contract checks in the same workflow. Its broad protocol support and self-hosted options are compelling; production deployment takes more operational care than the quick-start setup suggests.

Key features

Mocks and contract checks

Microcks supports OpenAPI, AsyncAPI, gRPC/Protobuf, GraphQL schemas and SOAP. Mocks can reuse examples, generate realistic examples, or transform data and responses dynamically. That flexibility helps teams exercise integrations before a service is complete and control responses during testing. Provider and consumer contracts can be checked against live implementations and specification versions, making Microcks more than a mock server for teams that need to verify both sides of an API relationship.

Automation and ecosystem

CI/CD automation covers GitHub Actions, Jenkins, GitLab CI and Tekton Pipelines, with generated code snippets to help integrate checks. The Backstage provider discovers APIs from Microcks instances and syncs them to the Backstage Software Catalog. Official Testcontainers modules support Java, NodeJS/TypeScript, Golang and .NET; Python support is community-maintained, so teams relying on that language should expect a less direct path.

Microcks Hub, enabled by default, is a free community marketplace for API mocks and test suites. The public demo is read-only: it cannot import APIs or modify existing artifacts, so it is useful for viewing but not for trying a team’s own definitions.

Security and deployment

Authentication delegates to Keycloak through OpenID Connect Authorization Code Flow. Only administrators can manage credentials for Git repositories, API endpoints and event brokers. Default roles are user, manager and admin, with permissions covering repository management and instance administration.

The containerized architecture can run on-premises, in the cloud or on developer laptops. The Uber distribution targets laptop and unit-test use, with in-memory MongoDB for ephemeral use. By contrast, the all-managed Kubernetes setup is intended for discovery rather than production: its Keycloak and MongoDB are single instances not tuned for scalability or security best practices. Production users should plan a more deliberate deployment rather than treating that setup as a turnkey operational baseline.

The project is a 100% open-source, community-driven CNCF Incubating project. The homepage announces version 1.15.0. An AI Copilot guide covers OpenAI-compatible APIs and, in its Docker Desktop Extension setup, requires an OpenAI API key.

Pricing

Microcks (open-source distribution) costs 0.00 USD per free. It is a free, fully open-source distribution with self-hosted deployment options; there are no paid tiers or seat and usage caps in the stated plan. That makes it a strong fit for teams able to operate their own deployment and wanting to avoid a subscription. The trade-off is that teams must own deployment and operational decisions, particularly for production, where the all-managed Kubernetes setup carries a clear caveat.

Platforms

Microcks spans API, extension, Linux, macOS, self-hosted, web and Windows. Its CLI binaries are available for Linux, macOS and Windows, and the CLI is also distributed as a container image. Deployment can be self-hosted or cloud-based, while the Uber distribution supports local laptop use. The project supports Java, NodeJS/TypeScript, Golang and .NET through official Testcontainers modules, with Python modules maintained by the community.

Who it's for

Choose Microcks when API owners, developers and QA engineers need specification-based mocks alongside provider and consumer contract checks, especially when those checks should run in CI/CD. Platform engineers can also use its Backstage integration to keep discovered APIs in the software catalog. It is less suited to teams seeking a managed, production-ready Kubernetes deployment without additional operational work, or to visitors who expect the public demo to accept their own APIs.

Pros and cons

Pros: One free, open-source distribution combines mocking and provider/consumer contract testing across five specification families.
Pros: Official integrations cover four CI/CD systems, and Backstage synchronization supports catalog workflows.
Pros: Self-hosted, cloud and laptop deployment options accommodate both shared environments and ephemeral unit tests.
Cons: The all-managed Kubernetes setup is not recommended for production because its Keycloak and MongoDB instances are not tuned for scale or security best practices.
Cons: The public demo cannot import or edit APIs, limiting its usefulness for evaluating custom definitions.
Cons: Python Testcontainers support is community-maintained rather than official.

Alternatives

For a cloud-oriented mock service with explicit request and rate caps, compare Mockzilla: its free plan allows 1K requests per month, 5 requests per second, one simulation and 10 MB of data transfer, while Hobby costs 10.00 USD per month. Consider Parasoft SOAtest when tailored paid pricing and a free trial suit a paid evaluation; its price is custom pricing. WireMock is another freemium option, with a free tier capped at 1,000 calls per month, one user, three mock APIs and 10 requests per second.

Mockoon is an additional freemium alternative. MockServer offers a free, open-source self-hosted option without a SaaS account. The separate WireMock entry has a free-forever tier capped at 1,000 calls per month, one user, three mock APIs and 10 requests per second. Mockfly offers a free Starter plan at 0.00 EUR per month with 500 requests per day, one project, four endpoints and two responses per endpoint. Choose Hoverfly if a paid product with a free trial fits better; its underlying open-source framework has no GUI and is typically used locally or within a user’s own infrastructure.

Browse API Mocking Tools, Service Virtualization Software, Integration Testing Tools, Contract Testing Tools and API Design Tools for related categories.

Verdict

Microcks is the right choice for teams that want free, self-hosted API mocks and contract checks across multiple specification formats, with integrations for pipeline and catalog workflows. Its breadth is a meaningful advantage over a mock-only setup. Look elsewhere if you need a public demo that accepts your APIs or a managed Kubernetes configuration suitable for production without further operational work.

	json-server	Microcks
Free plan	Yes	Yes
Free trial	No	No
Paid from	Free	Free
Open source	No	No
Platforms	api, self-hosted	api, extension, Linux, macOS, self-hosted, Web, Windows
Dynamic responses	Yes	—
Mock data generation	Yes	—
Local deployment	Yes	—
Supported protocols	REST	—
Free plan	—	Yes

json-server vs Microcks

json-server

Microcks