gRPC Swagger
github.com
- Free plan
- Web
- API
- Self-hosted
What gRPC Swagger is
gRPC Swagger is a free, MIT-licensed debugging tool that discovers gRPC services through reflection and presents their methods in Swagger UI. Register an endpoint by entering its host and port; the tool scans for available services and displays method definitions and parameters. Swagger UI’s “Try it out” control calls methods using request data and headers supplied as JSON, with headers passed to the gRPC server as metadata. Reflection must be enabled on the service, although the setup does not require changing proto files or related implementations. The project can run from a released JAR or from source, using port 8080 by default. Settings control service listing and expiration of inactive registrations. Its documented API covers registration, service listing, method calls, and Swagger UI documentation. It supports API, web, and self-hosted deployment.
Who it suits
It suits developers who need a browser interface for inspecting and calling reflected gRPC services. It is intended for self-hosted debugging and API work.
Good to know, and what to watch
- Discovers methods through gRPC reflection
- Swagger UI supports direct method calls
- Accepts JSON requests and metadata headers
- Runs from JAR or source
- MIT-licensed and free
- Reflection must be enabled
- Default port is 8080
- Self-hosted setup required
Plans
Every plan and priceOpen source
Open source
The verdict
gRPC Swagger offers a focused way to inspect and call reflected gRPC endpoints through Swagger UI. Its usefulness depends on having server reflection enabled.
What the maker publishes
- API
- The documented endpoints include service registration, listing services, calling a gRPC method, and returning API documentation for Swagger UI. source
- Configuration
- A setting can enable or disable listing registered services, and another can expire an inactive registered service after a specified number of seconds. source
- Deployment
- The project can be run from a released JAR or built from source, and defaults to port 8080. source
- Deployment
- The README documents running a released JAR or building from source, with port 8080 as the default. source
- Endpoint registration
- The tool registers a gRPC endpoint by host and port, then scans for available services. source
- Integrations
- The README describes integration with swagger-ui and use of the gRPC reflection feature. source
- Latest listed release
- The releases page lists version 0.1.8 as the latest release and describes it as fixing duplicate services after registration. source
- License
- The repository provides the software under the MIT License, which grants use without charge subject to its stated conditions. source
- License
- The repository provides the software under the MIT License. source
- Metadata
- The tool accepts JSON-formatted request data and JSON-formatted headers that it passes as metadata to the gRPC server. source
- Method calls
- Users can call a gRPC method through Swagger UI’s “Try it out” button. source
- Method definitions
- Swagger UI displays gRPC method and parameter definitions. source
- Method testing
- Users can test a gRPC method with the Swagger UI “Try it out” button. source
- Notable requirement
- The gRPC service must have reflection enabled for the tool to discover its services and methods. source
- Purpose
- gRPC-swagger is a debugging tool that uses gRPC reflection to list and call gRPC methods through Swagger UI. source
- Purpose
- gRPC Swagger is a debugging tool that uses gRPC reflection and Swagger UI to list and call gRPC methods. source
- Request format
- The request data and headers passed to the gRPC server are supplied in JSON format. source
- Service definitions
- Swagger UI displays definitions of gRPC methods and their parameters. source
- Service expiration
- A configurable expiration interval can remove a registered service after a period without access. source
- Service listing
- A command-line parameter can enable listing registered services through the listServices API. source
- Service registration
- Users register a gRPC endpoint by providing its host and port. source
- Setup
- It requires enabling reflection on the gRPC service and says proto files and related implementations do not need modification. source
- Setup
- The README says users can enable reflection when starting their service without modifying proto files or related implementations. source
- Support
- The README invites users to open an issue or pull request to contribute. source
Checked against the maker's pages on 7 Oct 2026.