gRPC Swagger
gRPC Swagger is a free, open-source debugging tool for discovering and calling gRPC methods through Swagger UI.
What gRPC Swagger is
gRPC Swagger is a free, open-source debugging tool for discovering and calling gRPC methods through Swagger UI. It uses gRPC reflection to scan a service registered by its host and port, then displays method definitions and parameters. The service must have reflection enabled for discovery, though setup does not require changes to proto files or related implementations. Once connected, users can test a method through Swagger UI’s “Try it out” control, supplying request data and headers in JSON format; headers are passed to the gRPC server as metadata. The project runs from a released JAR or can be built from source, and defaults to port 8080. Configuration can enable service listings and set how long an inactive registered service remains before expiration. Its documented API includes service registration, listing, method calls, and Swagger UI documentation. The project is MIT-licensed and can be self-hosted, with API and web platforms. It invites contributions through issues and pull requests.
Good
- Displays gRPC method and parameter definitions in Swagger UI.
- Tests methods using JSON request data and headers.
- Runs from a released JAR or source build.
- MIT-licensed software is available without charge.
Watch out
- The gRPC service must have reflection enabled.
- Default port is 8080.
- The project is self-hosted.
Who it suits
It suits developers who need a Swagger UI interface for discovering and trying methods on gRPC services. It requires reflection to be enabled on the service being explored.
Verdict
gRPC Swagger offers a focused way to inspect and call reflected gRPC services from Swagger UI. It is useful when reflection is available and a self-hosted debugging tool fits the setup.
Plans and prices
From gRPC Swagger's own pricing page, checked 7 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Open source | Free | MIT-licensed software |
The facts
Each one read from gRPC Swagger's own pages, with the date it was checked.
What it does
- API
- The documented endpoints include service registration, listing services, calling a gRPC method, and returning API documentation for Swagger UI.checked 4 Oct 2026
- Configuration
- A setting can enable or disable listing registered services, and another can expire an inactive registered service after a specified number of seconds.checked 4 Oct 2026
- Deployment
- The README documents running a released JAR or building from source, with port 8080 as the default.checked 7 Oct 2026
- Endpoint registration
- The tool registers a gRPC endpoint by host and port, then scans for available services.checked 4 Oct 2026
- Integrations
- The README describes integration with swagger-ui and use of the gRPC reflection feature.checked 7 Oct 2026
- Latest listed release
- The releases page lists version 0.1.8 as the latest release and describes it as fixing duplicate services after registration.checked 7 Oct 2026
- License
- The repository provides the software under the MIT License.checked 7 Oct 2026
- Metadata
- The tool accepts JSON-formatted request data and JSON-formatted headers that it passes as metadata to the gRPC server.checked 7 Oct 2026
- Method calls
- Users can call a gRPC method through Swagger UI’s “Try it out” button.checked 7 Oct 2026
- Method definitions
- Swagger UI displays gRPC method and parameter definitions.checked 7 Oct 2026
- Method testing
- Users can test a gRPC method with the Swagger UI “Try it out” button.checked 4 Oct 2026
- Notable requirement
- The gRPC service must have reflection enabled for the tool to discover its services and methods.checked 4 Oct 2026
- Purpose
- gRPC Swagger is a debugging tool that uses gRPC reflection and Swagger UI to list and call gRPC methods.checked 7 Oct 2026
- Request format
- The request data and headers passed to the gRPC server are supplied in JSON format.checked 4 Oct 2026
- Service definitions
- Swagger UI displays definitions of gRPC methods and their parameters.checked 4 Oct 2026
- Service expiration
- A configurable expiration interval can remove a registered service after a period without access.checked 7 Oct 2026
- Service listing
- A command-line parameter can enable listing registered services through the listServices API.checked 7 Oct 2026
- Service registration
- Users register a gRPC endpoint by providing its host and port.checked 7 Oct 2026
- Setup
- The README says users can enable reflection when starting their service without modifying proto files or related implementations.checked 7 Oct 2026
- Support
- The README invites users to open an issue or pull request to contribute.checked 7 Oct 2026
- Support and contributions
- The project invites users to open an issue or pull request to contribute.checked 4 Oct 2026
Alternatives to gRPC Swagger
- 1
Kreya
Free planLinuxmacOSWindows7.1Free plan - 2

Bandura
Free planLinuxmacOSSelf-hostedWindows6.7$59 one-time - 3
grpcmd
Free planLinuxmacOSWindows6.7From $9 a year - 4

FintX
Free planLinuxmacOSWindows6.6Free plan - 5
grpcui
Free planWebLinuxmacOSSelf-hosted6.6Free plan - 6
protoc-gen-doc
Free planLinuxmacOSSelf-hostedWindows6.5Free plan
