Skip to content
gurl grpc

gurl grpc

Call a gRPC method, or list a server’s services through reflection.

Synopsis

gurl grpc <host:port> --service <name> --method <name> [--data <json> | --data-file <file>] [flags]
gurl grpc <host:port> --list

The target (host:port) is required. --service and --method are required for calls.

Flags

FlagShortDefaultDescription
--service-snonegRPC service name (e.g., UserService)
--method-mnonegRPC method name (e.g., GetUser)
--data-dnoneJSON request data
--data-file-fnonePath to a file containing JSON request data
--call-type--ctunaryCall type: unary, server-streaming, client-streaming, bidirectional
--list-lfalseList available services via reflection
--metadata--mdatanoneComma-separated key:value pairs for gRPC metadata
--format--fmtautoOutput format: auto, json, table
--color-cfalseEnable syntax highlighting
--insecure-kfalseSkip TLS verification (testing only)
--cacertnoneCA certificate file
--certnoneClient certificate file
--keynoneClient key file
--server-namenoneServer name for SNI

Aliases

  • grpc

Examples

Discover services

gurl grpc localhost:50051 --list

Unary call with metadata

gurl grpc localhost:50051 -s UserService -m GetUser \
  -d '{"id":"u-123"}' --metadata 'authorization:Bearer dev-token'

Server-streaming call over mutual TLS

gurl grpc api.example.com:443 -s Events -m Subscribe --call-type server-streaming \
  --cacert ca.pem --cert client.pem --key client-key.pem

Related commands