docs: add Raven (MCP server) and clean up stale Stella references

docs/build/building-with-ai.mdx

@@ -5,10 +5,106 @@ sidebar_label: Building with AI
 sidebar_position: 1
 ---
 
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+
 # Building with AI
 
 Stellar provides resources to help AI assistants and Large Language Models (LLMs) understand our documentation, making it easier for you to get accurate answers about Stellar development.
 
+## Raven (MCP server)
+
+**Raven** is a remote **Model Context Protocol (MCP)** server for AI agents, hosted at [`raven.stellar.buzz`](https://raven.stellar.buzz). It is open source at [kalepail/stellar-raven](https://github.com/kalepail/stellar-raven). This is the recommended path: connect your agent once and it gets Stellar docs plus live ecosystem data, cross-referenced into single answers on demand.
+
+Raven exposes two MCP tools:
+
+- **`search`** — find relevant Stellar docs and ecosystem information.
+- **`execute`** — run queries against live ecosystem data.
+
+Under the hood it wraps Stellar Docs (via Algolia), Lumenloop, Stellar Light, and ecosystem skills, so your agent gets one cross-referenced answer instead of several disconnected sources.
+
+Unlike the static [`llms.txt`](#using-llmstxt) file and the installable [Stellar Skills](#stellar-skills) below, Raven is a live, hosted server your agent talks to. All three are useful, and they work well together.
+
+:::tip[Try it in your browser]
+
+[raven.stellar.buzz/playground](https://raven.stellar.buzz/playground) is a hosted chat UI where you can ask Raven questions directly in the browser, no agent setup required (sign-in required).
+
+:::
+
+### Connect your agent
+
+Add the server, then sign in. Sign-in happens inside your own client (Raven uses OAuth), so the first request opens your browser to authorize. For full setup details see [raven.stellar.buzz](https://raven.stellar.buzz).
+
+<Tabs groupId="mcp-client" defaultValue="claude-code">
+<TabItem value="claude-code" label="Claude Code">
+
+```bash
+claude mcp add --transport http stellar-raven "https://raven.stellar.buzz/mcp"
+# then run /mcp -> Authenticate -> sign in in your browser
+```
+
+</TabItem>
+<TabItem value="codex" label="Codex">
+
+```bash
+codex mcp add stellar-raven --url "https://raven.stellar.buzz/mcp"
+codex mcp login stellar-raven  # opens your browser
+```
+
+</TabItem>
+<TabItem value="cursor" label="Cursor">
+
+Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` per project). Cursor runs the OAuth sign-in on first use.
+
+```json
+{
+  "mcpServers": {
+    "stellar-raven": { "url": "https://raven.stellar.buzz/mcp" }
+  }
+}
+```
+
+</TabItem>
+<TabItem value="claude-desktop" label="Claude Desktop">
+
+Go to **Settings → Connectors → Add custom connector**, paste the endpoint, and approve the browser sign-in.
+
+```text
+https://raven.stellar.buzz/mcp
+```
+
+</TabItem>
+<TabItem value="vscode" label="VS Code">
+
+```bash
+code --add-mcp '{"name":"stellar-raven","type":"http","url":"https://raven.stellar.buzz/mcp"}'
+```
+
+</TabItem>
+<TabItem value="other" label="Other clients">
+
+For clients without native remote/OAuth support, bridge with [`mcp-remote`](https://github.com/geelen/mcp-remote):
+
+```json
+{
+  "mcpServers": {
+    "stellar-raven": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "mcp-remote@latest",
+        "https://raven.stellar.buzz/mcp",
+        "--transport",
+        "http-only"
+      ]
+    }
+  }
+}
+```
+
+</TabItem>
+</Tabs>
+
 ## Stellar Skills
 
 [**skills.stellar.org**](https://skills.stellar.org/) is the home for Stellar Skills—a collection of AI agent skills that give your coding assistant the right Stellar context before it writes code. They work with any AI agent, and you can browse every skill on the website with no installation required.
@@ -88,6 +184,7 @@ Popular tools like ChatGPT, Claude, Gemini, and Cursor all support adding custom
 
 ## Additional resources
 
+- [Raven (stellar-raven)](https://github.com/kalepail/stellar-raven) - Open source remote MCP server for Stellar docs plus live ecosystem data
 - [Stellar Skills](https://skills.stellar.org/) - Browse AI agent skills for Stellar development
 - [stellar-dev-skill repository](https://github.com/stellar/stellar-dev-skill) - Source and installation for the official skills
-- [Stellar Developer Discord](https://discord.gg/stellardev) - Ask questions in #stella-help
+- [Stellar Developer Discord](https://discord.gg/stellardev) - Ask questions and get help from the community

static/llms.txt

@@ -7,6 +7,10 @@ Alternatively, send an `Accept: text/markdown` request header to any page URL to
 
 Full documentation as a single file: https://developers.stellar.org/llms-full.txt
 
+Live MCP server: connect an AI agent to Raven at https://raven.stellar.buzz/mcp
+for these docs plus live ecosystem data, cross-referenced on demand. Open source:
+https://github.com/kalepail/stellar-raven — try it: https://raven.stellar.buzz/playground
+
 
 [Build](https://developers.stellar.org/docs/build.md)