Protocols

Stashy serves all protocols from a single endpoint using Vanguard transcoding. No separate ports or gateways needed.

Supported Protocols

Protocol	Transport	Use case
REST	HTTP/1.1 or HTTP/2	curl, any HTTP client
gRPC	HTTP/2 (h2c)	Go, Java, Python gRPC clients
Connect	HTTP/1.1 or HTTP/2	connectrpc clients (Go, TypeScript)
gRPC-Web	HTTP/1.1 or HTTP/2	Browser clients

The same port also serves MCP at /mcp for AI assistants.

Standard HTTP — works with curl, fetch, or any HTTP library:

curl -H "Authorization: Bearer $API_KEY" \
  -X POST http://localhost:8080/v1/files \
  -H "Content-Type: image/png" \
  --data-binary @photo.png

Connect using any gRPC client with h2c (plaintext HTTP/2):

conn, _ := grpc.Dial("localhost:8080", grpc.WithTransportCredentials(insecure.NewCredentials()))
client := stashyv1.NewFileServiceClient(conn)

client := stashyv1connect.NewFileServiceClient(
    http.DefaultClient,
    "http://localhost:8080",
)

The service is defined in proto/stashy/v1/stashy.proto. Regenerate with:

just generate