Guides
Practical, task-oriented guides for every major feature of lauren-mcp.
Beginner
| Guide |
Description |
| Your First Server |
Step-by-step: build a server with tools, resources, and prompts; add context injection and a lifespan hook; deploy with WebSocket and Streamable HTTP |
| Your First Client |
Connect with WebSocket or Streamable HTTP, discover and call tools, handle server notifications |
| Using with Lauren |
End-to-end guide: HTTP controllers, DI injection, guards, interceptors, middleware, SSE |
Decorators and features
| Guide |
Description |
| Decorators in Depth |
Complete reference for @mcp_server, @mcp_tool, @mcp_resource, @mcp_prompt, and @mcp_lifespan; McpToolContext; ToolAnnotations; rich type schemas; BlobResource/ToolOutput |
| Multiple Servers |
Connect several MCP servers simultaneously; tool namespacing |
| Error Handling |
Timeouts, McpCallError, not-found resources, and retry patterns |
Examples
| Guide |
Description |
| Filesystem Example |
Production-quality MCP server exposing a sandboxed filesystem, plus an interactive Poolside CLI client built with Rich |
Testing
| Guide |
Description |
| Testing |
Unit tests (direct method calls), subprocess E2E, mock clients, WsTestClient |
Full API reference
| Guide |
Description |
| MCP Server API |
Complete @mcp_server, @mcp_tool, @mcp_resource, @mcp_prompt, and McpServerModule reference |
| MCP Client API |
Complete McpServer.stdio/ws/http/streamable_http and McpClientProtocol method reference |
| Agent Tools |
Wire MCP server tools into a Lauren AI AgentModule |