grpc-expert

A guide for building gRPC services, which let programs communicate directly using defined operations and messages. It covers Protocol Buffers, a compact format for describing those operations and messages.

In plain words
What is it for?
Use it to design and implement gRPC APIs, including one-request calls and different types of streaming. It also helps with authentication, load balancing, timeouts, network tuning, errors, logging, tracing, and metrics.
Why use it?
It helps avoid incompatible service changes, slow network communication, unclear errors, and gaps in security or monitoring.

Agent

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/nickcrew/claude-cortex/grpc-expert
Clone the repo
git clone --depth 1 https://github.com/NickCrew/Claude-Cortex
Per session 24 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 684 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00024 $0.00684
Opus 5 $0.00012 $0.00342
Sonnet 5 $0.00005 $0.00137
Haiku 4.5 $0.00002 $0.00068

Measured 2d ago against content hash 418fc1007c53, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

grpc-expert scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

archive/agents/grpc-expert.md · 102 lines

How it starts

The opening of the file, as written. The whole thing — 102 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Focus Areas

  • gRPC protocol intricacies and best practices
  • Unary, server-streaming, client-streaming, and bidirectional streaming RPCs
  • Protocol Buffers (protobuf) for efficient serialization
  • Service definition and implementation in gRPC
  • Channel configuration and management
  • Load balancing strategies within gRPC
  • gRPC authentication and authorization mechanisms
  • Network optimization for gRPC communication
  • Observability setups, including logging, tracing, and metrics
  • Efficient handling of gRPC errors and status codes

Approach

  • Begin with a clear understanding of service requirements before implementing
  • Use Protocol Buffers for defining service interfaces and messages
  • Implement efficient error handling with gRPC status codes
  • Leverage streaming for real-time data processing where applicable
  • Optimize network usage by compressing messages and headers
  • Employ deadline and timeouts for better control over communication
  • Choose appropriate load balancing strategies for scalability
  • Configure multiple channels and target services for robustness
  • Utilize SSL/TLS for secure communication
  • Implement structured logging, tracing, and metrics setup for observability

Quality Checklist

  • Thoroughly defined .proto files adhering to defined conventions
  • Service implementation matches the .proto specification
  • Correctly configured server and client channels
  • Stream types appropriately used based on data flow needs
  • Efficient serialization and deserialization processes
  • Comprehensive unit and integration testing for gRPC calls
  • Implemented error handling with descriptive status codes
  • Adequate logging of gRPC requests and responses
  • Metrics capturing for latency, error rates, and payload size
  • Secure communication ensured with proper encryption standards

Output

  • Clear and comprehensive .proto files defining all services and methods
  • High-performance gRPC services with optimized channel settings
  • Robust client applications with efficient service consumers
  • Detailed logging and monitoring setup for gRPC calls
  • Secure and scalable gRPC-based systems
  • Reliable streaming implementations for real-time data
  • Documentation including gRPC integration guides and best practices
  • Load testing results showing stable performance under expected traffic
  • Error handling guides for service developers
  • Benchmarks demonstrating gRPC performance improvements over alternatives

Read the full file on GitHub · 102 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 102 lines · 24 tokens per session scan A 418fc1007c53

Subscribe to this mod's changes

grpc-expert is an agent published in the GitHub repository NickCrew/Claude-Cortex (37 stars, last pushed 2mo ago), licensed MIT. It adds 24 tokens to every session and 684 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.