Lerian MCP Server

Your AI's gateway to Lerian documentation, guides, and learning resources!

This MCP server connects Claude, ChatGPT, and other AI assistants to comprehensive documentation for all 5 Lerian products (Midaz, Tracer, Flowker, Reporter, and more). Get instant help with integration, best practices, and code generation—all through natural conversation.

📚 Documentation-Only Mode: This server provides documentation and learning resources. It does NOT connect to Lerian backend APIs. For live API access, use Lerian SDKs in your application.

⚡ 2-Minute Setup

Step 1: Choose your AI assistant Step 2: Copy the configuration below Step 3: Restart your AI app Step 4: Ask: "What can you tell me about Lerian Midaz?"

🖥️ Claude Desktop

Location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) Location: %APPDATA%\Claude\claude_desktop_config.json (Windows)

🖥️ Cursor / Windsurf / Continue

Add to your MCP configuration:

💬 ChatGPT Desktop

Same configuration in your ChatGPT Desktop MCP settings file.

✨ What You Get

ONE powerful tool for ALL 5 Lerian products:

📦 Supported Products

• Midaz - Financial ledger system with double-entry accounting

• Tracer - Observability and distributed tracing platform

• Flowker - Workflow orchestration engine

• Reporter - Reporting and analytics platform

• All - Cross-product search and comparison

🎯 Operations

📚 Documentation (operation: "docs")

Get comprehensive documentation for any product:

🎓 Learning (operation: "learn")

Interactive tutorials adapted to your experience level:

💻 SDK Generation (operation: "sdk")

Production-ready code in 3 languages:

🔍 Search (operation: "search")

Find anything across all products:

🚀 Example Conversations

Getting Started

You: "What can you tell me about Lerian Midaz?" AI: Uses → Gets comprehensive Midaz documentation, explains core concepts

Learning Path

You: "I'm new to Tracer, how do I get started?" AI: Uses → Provides beginner-friendly tutorial with step-by-step guidance

Code Generation

You: "Show me Go code for creating a Midaz ledger" AI: Uses → Generates production-ready Go code with comments and best practices

Cross-Product Search

You: "How do the different Lerian products handle authentication?" AI: Uses → Searches across all products, provides comparison

🎯 The ONE Tool

The entire MCP server is built around a single, intelligent tool:

Why ONE tool?

• 🎯 Simple to discover and use

• 🔄 Consistent experience across all products

• 🚀 Easy for AI to understand

• 📦 Minimal context usage

• ⚡ Fast and efficient

💡 Key Features

✅ Zero Configuration

• Auto-generates required secrets on first run

• Stores in ~/.lerian/secrets.json (secure, persistent)

• Works immediately with npx - no manual setup

✅ All Products, One Interface

• Unified access to Midaz, Tracer, Flowker, Reporter

• Cross-product search and comparison

• Consistent documentation format

✅ Smart Documentation

• Auto-loads from docs.lerian.studio/llms.txt

• Always up-to-date with latest docs

• Rich formatting optimized for AI understanding

✅ Multi-Language SDK

• Go (backend services)

• TypeScript (type-safe web)

• JavaScript (Node.js/browser)

• Production-ready code with best practices

✅ Experience-Based Learning

• Beginner-friendly tutorials

• Intermediate deep-dives

• Advanced patterns and architecture

• Role-specific guidance (developer/admin/business)

🔒 Safe & Secure

• ✅ No API access - Documentation only, can't execute operations

• ✅ All local - Documentation cached on your machine

• ✅ Zero vulnerabilities - Comprehensive security audit completed

• ✅ Auto-secret generation - Cryptographic keys auto-managed

• ✅ Open source - Fully auditable code

📖 Documentation

Quick Links

• 📚 Full Documentation

• 🎓 Learning Paths

• 💻 SDK Reference

• 🐛 Troubleshooting

For Developers

• 🔧 Makefile Commands - make help for all commands

• 🧪 Testing Guide

• 📊 Architecture

• 🔐 Security

🛠️ Advanced Usage

Custom Documentation URL

Enable Logging

Logs are stored in ./logs/ directory.

🆘 Troubleshooting

Server Not Starting?

1. Check Node.js version: Requires Node.js 18+

   node --version # Should show v18 or higher

2. Test manually:

   npx -y @lerianstudio/lerian-mcp-server

3. Check secrets:

   ls -la ~/.lerian/secrets.json

Tool Not Responding?

1. Restart your AI assistant after changing configuration

2. Verify MCP is enabled in your AI assistant's settings

3. Check logs (if enabled): ./logs/error.log

Getting Help

• 🐛 GitHub Issues

• 💬 Lerian Community

• 📖 Documentation

📦 Package Information

npm Package: @lerianstudio/lerian-mcp-server Version: 4.0.0 (Documentation-Only Mode) License: Apache-2.0 Repository: GitHub

Migration from v3.x

Version 4.0.0 is a major breaking change that removes all API connectivity.

What's Removed:

• ❌ All 18 financial API tools

• ❌ Backend service connectivity

• ❌ Live data queries

What You Gain:

• ✅ Focused documentation experience

• ✅ 5 products in ONE tool

• ✅ Faster, simpler, more reliable

• ✅ Zero configuration required

Need API access? Use Lerian SDKs directly in your application.

See MIGRATION-V4.md for full migration guide.

🏗️ Architecture

The Ultimate Simplification:

• Tool Count: 1 (down from 23!)

• Products: 5 (midaz, tracer, flowker, reporter, all)

• Operations: 4 (docs, learn, sdk, search)

• Languages: 3 (Go, TypeScript, JavaScript)

• Data Source: docs.lerian.studio/llms.txt (auto-updated)

Layers:

1. Infrastructure - Config, logging, security

2. Transport - MCP stdio protocol

3. Protocol - Message handling, cursors

4. Client Adaptation - Response formatting

5. Tool - Single unified lerian tool

6. Business Logic - Documentation workflows

No API/Integration layer - Pure documentation MCP ✅

🌟 Why This MCP?

For AI Users

• 🎯 One tool, everything - No complexity, just ask

• 📚 Always current - Auto-updates from official docs

• 🎓 Learn by doing - Interactive tutorials

• 💻 Copy-paste code - Production-ready examples

For Developers

• ⚡ Zero setup - Just npx and go

• 🔒 Secure by default - No credentials needed

• 🪶 Lightweight - Minimal dependencies

• 🔧 Just works - Auto-generates secrets

For Organizations

• 📖 Single source of truth - Official Lerian documentation

• 🚀 Faster onboarding - AI-assisted learning

• ✅ Best practices - Built into examples

• 🔐 Safe - Read-only, can't modify data

Ready to explore Lerian with AI? Install now and ask your first question! 🚀