GripMock API Schema (3.18.4)

REST control plane for GripMock, a gRPC mock server.

Use it to load stubs, ask which stub a request would match, read call history and assert call counts — all while the server keeps running.

Base URL. Every path below is relative to /api, served on the HTTP port (4771 by default). The gRPC port (4770) and the ConnectRPC/gRPC-web gateway (4769) are separate.

Sessions. Send X-Gripmock-Session: <id> to scope a request to one session. Stubs created within a session are visible only there, and call history is kept apart. Without the header the request works against the global scope. The header is the only thing that decides scope here: a session field inside a posted stub is ignored, so no caller can place stubs into someone else's session. Stub files loaded from disk keep their own session field.

Not in this document. POST /api/mcp speaks the Model Context Protocol for agent tooling, and GET /metrics — outside /api — serves Prometheus metrics.