GripMock
gripmock.org
- Free plan
- Windows
- macOS
- Linux
- Web
- API
- Self-hosted
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.