livekit_examples_server

This Ruby-powered Model Context Protocol (MCP) service exposes the LiveKit Agent example catalog. Use it to explore prompts, tools, and resources programmatically or pipe it into your Codex-compatible clients.

Quick Start

Initialize a session with POST /mcp (Content-Type: application/json).
Grab the Mcp-Session-Id header from the response.
Open an SSE stream at GET /mcp/stream (or /sse) with that session id.
Send subsequent MCP JSON-RPC calls to POST /mcp or /messages.

curl -i https://shayne.app/mcp \
  --json '{"jsonrpc":"2.0","method":"initialize","id":1,
    "params":{"protocolVersion":"2024-11-05","capabilities":{},
    "clientInfo":{"name":"demo","version":"0.1"}}}'

Tools Available

The MCP server ships with utilities for browsing the LiveKit examples:

ReadExampleIndexFile – fetch the catalog index.
ReadExampleFile – read a specific example's source.
ListExampleCategories – discover available example categories.
SearchExamples – search metadata across the collection.

Need Streaming?

The StreamableHTTPTransport keeps responses flowing over Server-Sent Events. The legacy endpoints /sse and /messages remain wired up for existing clients, so your current workflows keep working while you migrate to the new Ruby stack.