← Graph

step gem

tool 3 connections

Ruby gem by the speaker of a wroclove.rb 2026 lightning talk. Declarative way to build self-documenting REST API endpoints: define a service with metadata/URLs, declare endpoints with optional query/payload schemas, and compose logic as a railway-oriented pipeline of steps (with sub-pipelines for complex cases). Schemas are themselves steps in the pipeline, so you can validate before/after other steps (e.g. for authentication). Supports authentication schemes defined by the OpenAPI specification, content negotiation (send JSON, get HTML back and vice versa), file uploads. Mounted as a Rack app, it serves as a one-to-one mapping to an OpenAPI spec and generates the spec automatically (usable with Swagger UI). Additional helper decorates the same REST service definition as an MCP endpoint — one line turns a self-documenting REST API into an MCP server whose tools map to the existing endpoints, letting Claude use the API conversationally.

category
library
language
Ruby
about
step gem tool
Demoes and explains the speaker's step gem
tool step gem
uses
Rack tool
step mounts as a Rack app to serve REST
tool step gem
uses
step composes endpoints as railway-oriented pipelines of steps with sub-pipelines

Provenance

Created in
wroclove.rb 2026 Lightning Talks 2026-04-22 08:41
Read by
1 extraction