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

GripMock

gripmock.org

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • API
  • Self-hosted
8.0 Club score Visit gripmock.org

What GripMock is

GripMock is a mock server for gRPC services that returns responses defined in YAML or JSON, without a backend. It can load .proto files or compiled .pb descriptors, including descriptors sent to a running server without restarting it. Stub rules can match request inputs and headers using exact, partial, regex, glob, and other conditions, while priority rules help determine which stub applies. Dynamic templates can build responses from payloads, headers, and stream position. GripMock handles unary, server-streaming, client-streaming, and bidirectional calls; stubs can also return gRPC errors or delays for timeout checks. A web dashboard lists loaded and matched stubs and allows editing while the server runs. Installation options include Docker, release binaries, Homebrew, shell scripts, and Go; an embedded Go SDK runs GripMock inside a test process. Other capabilities include gRPC-Web, server reflection, native TLS, optional mutual TLS, OTLP traces, a metrics endpoint, and MCP endpoints for AI agents and automation. GripMock is free and MIT-licensed, with documentation pointing users to GitHub issues for questions and bug reports.

Who it suits

GripMock suits developers who need gRPC test responses without a backend, including for local development, CI, or containerized test environments. Its embedded Go SDK is an option for Go tests that should run it in-process.

Good to know, and what to watch

  • Supports all four gRPC call patterns
  • Dashboard edits stubs without restarting
  • Can load descriptors while running
  • Offers Docker, Homebrew, binaries, and Go installation
  • Includes an embedded Go SDK
  • Requires defining mock responses in YAML or JSON
  • Questions and bug reports are directed to GitHub issues

The verdict

GripMock covers request matching, streaming calls, and in-process or standalone use for gRPC mocking. Its dashboard and descriptor-loading options are useful when stubs need changes during a running test setup.

What the maker publishes

AI tooling
GripMock provides Model Context Protocol endpoints for AI agents and tool-driven automation. source
Deployment
The project documents installation through Docker, release binaries, Homebrew, shell script, and Go install. source
Descriptors
GripMock can load compiled .pb descriptors, including from a running server without restarting it. source
Dynamic responses
Dynamic templates can build responses from request payloads, headers, and stream position. source
Embedded SDK
A Go SDK runs GripMock inside the test process, without starting a container or external binary. source
Failure testing
Stubs can return gRPC status errors or delay responses to exercise client timeouts. source
Integrations
The documentation describes installing through Docker, Homebrew, release binaries, or Go, and includes an official GitHub Actions guide. source
Integrations
The documentation lists a Model Context Protocol API, an official GitHub Actions integration, and OpenTelemetry trace export over OTLP. source
Intended use
The project describes Docker use for local development, CI, and containerized test environments. source
License
The project is released under the MIT License. source
Matching
Stub matching supports exact, partial, regex, glob, and header matching, with priority rules. source
Metrics
GripMock exposes a `/metrics` endpoint for Prometheus scraping. source
Observability
It can export traces over OTLP and exposes a /metrics endpoint for scraping. source
Protocol files
It can load `.proto` files or compiled `.pb` descriptors, including descriptors pushed to a running server without restarting it. source
Purpose
GripMock is a mock server for gRPC services that serves responses defined in YAML or JSON without a backend. source
Runtime dashboard
The dashboard at `http://localhost:4771/` lists loaded and matched stubs and allows editing without restarting the server. source
Runtime editing
The web dashboard can create, edit, and delete stubs, and show used and unused stubs. source
Schema registry
GripMock can start from a Buf Schema Registry module reference. source
Security
GripMock supports native TLS for gRPC and optional mutual TLS client-certificate authentication. source
Streaming
It supports unary, server-streaming, client-streaming, and bidirectional gRPC calls. source
Stub matching
Stubs can match requests by input and headers using equals, contains, matches, anyOf, and glob rules. source
Support
The documentation directs bug reports and questions to GitHub issues. source
What it does
GripMock is a mock server for gRPC services that serves responses defined in YAML or JSON without requiring a backend. source

Checked against the maker's pages on 30 Sept 2026.