From 51b1e7fffd99c25b116c7e28e2b6791ebe4c5a92 Mon Sep 17 00:00:00 2001
From: KaifAhmad1 <kaifahmad087@gmail.com>
Date: Sat, 23 May 2026 13:17:36 +0530
Subject: [PATCH] docs: add 'What You Get' sections to explorer, llms, and
 mcp_server

---
 docs/reference/explorer.md   | 8 ++++++++
 docs/reference/llms.md       | 9 +++++++++
 docs/reference/mcp_server.md | 8 ++++++++
 3 files changed, 25 insertions(+)

diff --git a/docs/reference/explorer.md b/docs/reference/explorer.md
index f387659f..c9d5311e 100644
--- a/docs/reference/explorer.md
+++ b/docs/reference/explorer.md
@@ -6,6 +6,14 @@ icon: "map"
 
 `semantica.explorer` is a browser-based dashboard for exploring knowledge graphs, managing ontologies, and running visual analyses — no code required after launch.
 
+## What You Get
+
+- **Graph Explorer** — interactive node/edge search, filtering, path highlighting, and neighborhood views
+- **Ontology Hub** (v0.5.0) — browse class hierarchies, infer types, run SHACL validation, align ontologies
+- **Distance Intelligence** (v0.5.0) — semantic similarity search, ego-mode neighborhood views, distance heatmaps
+- **REST API** — 15+ endpoints for graph data, path finding, embeddings, and semantic search
+- **CLI launcher** — `semantica-explorer` command for quick local startup
+
 ## Installation
 
 ```bash
diff --git a/docs/reference/llms.md b/docs/reference/llms.md
index eff097ed..7c70a3d0 100644
--- a/docs/reference/llms.md
+++ b/docs/reference/llms.md
@@ -6,6 +6,15 @@ icon: "microchip"
 
 `semantica.llms` provides a single consistent API across 8+ LLM providers. Every provider is a drop-in replacement for the `llm_provider=` parameter in extractors, reasoning engines, and agents.
 
+## What You Get
+
+- **8+ provider integrations** — Groq, OpenAI, Anthropic, Gemini, Ollama, DeepSeek, Novita AI, LiteLLM, HuggingFace
+- **Unified `LLMProvider` interface** — swap providers with a one-line change, no application changes needed
+- **`ProviderFactory`** — instantiate any provider by name from a config dict
+- **Local models** — Ollama and HuggingFace run fully on-premise with no API key
+- **Streaming** — token-by-token output for low-latency UX
+- **Custom gateways** — point any OpenAI-compatible endpoint via `base_url`
+
 ## Providers
 
 <CodeGroup>
diff --git a/docs/reference/mcp_server.md b/docs/reference/mcp_server.md
index 929b4fe3..19357b5f 100644
--- a/docs/reference/mcp_server.md
+++ b/docs/reference/mcp_server.md
@@ -8,6 +8,14 @@ icon: "plug"
 
 Compatible with **Claude Desktop**, **Windsurf**, **Cline**, **Continue**, **VS Code**, **Roo Code**, **Cursor**, and any MCP-aware client.
 
+## What You Get
+
+- **12 MCP tools** — extract entities, build graphs, run SPARQL, find paths, get recommendations, embed, cluster, and more
+- **3 readable resources** — live graph JSON, entity list, and relationship list
+- **Zero infrastructure** — runs over stdio, no server or port needed
+- **Claude Desktop ready** — one config block to add to `claude_desktop_config.json`
+- **REST alternative** — the Explorer module offers a full HTTP API if you prefer
+
 ## Installation
 
 ```bash