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

gRPC Swagger

github.com

  • Free plan
  • Web
  • API
  • Self-hosted
7.6 Club score Visit github.com

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

Open source

Free

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.