← Graph

Self-Documenting REST + MCP with step

talk 5 connections

wroclove.rb 2026 lightning talk following the speaker's earlier event-sourcing talk. Starts with a buggy demo of a small app the speaker built for drawing command/event/read-model diagrams in a mermaid-like text-based syntax, with DSL for test scenarios. Pivots to the real subject: the app's backend is a Rack-mounted REST API with an OpenAPI spec, built on a new Ruby gem called step. Walks through step's design (service metadata + endpoints with query/payload schemas, railway-oriented step pipelines, sub-pipelines, schemas-as-steps that can validate before/after authentication, content negotiation, authentication schemes from the OpenAPI spec). Shows generating an OpenAPI JSON description and rendering it with Swagger. Closes with the punchline: a single additional line decorates the same REST service as an MCP endpoint, turning every REST endpoint into an MCP tool. Demo: Claude reads the domain model conversationally and can even implement it based on the MCP description.

type
lightning-talk
talk Self-Documenting REST + MCP with step
about
step gem tool
Demoes and explains the speaker's step gem
talk Self-Documenting REST + MCP with step
about
Shows one-line MCP-decoration of the REST service
talk Self-Documenting REST + MCP with step
about
Demoed letting Claude read the domain model and implement against it via the MCP endpoint
from_talk
Self-Documenting REST + MCP with step talk
Punchline of the talk
talk Self-Documenting REST + MCP with step
presented_at
Lightning talk at wroclove.rb 2026

Provenance

Created in
wroclove.rb 2026 Lightning Talks 2026-04-22 08:41