Skip to main content

gRPC Request Builder

Build gRPC requests visually from your proto definition. Get ready-to-run grpcurl commands, gRPC-Web fetch code, and Node.js snippets instantly.

✓ grpcurl command generator ✓ gRPC-Web fetch code ✓ Node.js @grpc/grpc-js snippet

Request Configuration

bash
Click "Build Request Code" to generate

Frequently Asked Questions

What is grpcurl and how does it work?▼

grpcurl is a command-line tool for interacting with gRPC servers, similar to curl for HTTP. It uses protobuf reflection or a .proto file to discover service methods and can send requests in JSON format. It's the fastest way to test gRPC endpoints without writing code.

What is the difference between gRPC and gRPC-Web?▼

gRPC uses HTTP/2 framing directly and is suited for server-to-server or native client communication. gRPC-Web is a browser-compatible protocol that works over HTTP/1.1 or HTTP/2 via a proxy (like Envoy). Browsers cannot use raw gRPC because they lack low-level HTTP/2 stream control.

How do I include metadata (headers) in a gRPC request?▼

In grpcurl, use the -H flag: `-H 'authorization: Bearer TOKEN'`. In Node.js @grpc/grpc-js, pass metadata as the second argument: `const meta = new grpc.Metadata(); meta.add('authorization', 'Bearer TOKEN'); client.Method(request, meta, callback)`.

What does the package and service name look like in a proto definition?▼

A typical proto file starts with `package myapp.v1;` and then `service UserService { rpc GetUser (GetUserRequest) returns (GetUserResponse); }`. The fully-qualified method name used by grpcurl is `myapp.v1.UserService/GetUser`.

Can I use gRPC without a .proto file?▼

Yes — if the server has reflection enabled (most dev servers do), grpcurl can introspect services at runtime without any proto files using `-proto` flag or reflection. In production, reflection is often disabled for security, so you'd need the .proto file or a generated descriptor set.

Share this tool: X / Twitter LinkedIn
✓ 60,000+ developers use DevPlaybook ★★★★★ 4.8 / 5 on Gumroad ✓ MIT licensed · Instant download ✓ No login required

Related Products

on Gumroad

You Might Also Need

More Free Tools

Enjoying this tool? Get more like it.

Weekly developer tool guides, productivity playbooks & AI tricks. Free. No spam.

DevPlaybook Pro 7 days free

Unlock AI-Powered Dev Tools

  • ⚡ AI Code Review, Doc Generator & SQL Builder
  • ⚡ All premium templates & early access
  • ⚡ Member discounts on Gumroad products
Start Free Trial →

$9/mo after trial · Cancel anytime

Want the full toolkit?

Get DevPlaybook Pro

Every template, guide, boilerplate, and automation script in one bundle. 13 premium products — grab them all at once and save big.

$79
$241 separately Save $162 (67% off)
Get DevPlaybook Pro — $79 →

MIT licensed · Instant download · No subscription

See what's included → Browse all deals →