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

* docs: add Raven MCP server, clean up stale Stella refs

Addresses three sub-issues of the Raven docs epic (#2588):

- #2585: Add a Raven (MCP server) section as the lead on the
  "Building with AI" page, with tabbed connect commands, a
  playground callout, and an Additional resources link.
- #2587: Remove the stale #stella-help Discord reference and
  delete the orphaned Spanish ai-bot.mdx translation.
- #2589: Add a Raven pointer to the llms.txt header preamble.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: fix prettier formatting and reword Raven comparison

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs: apply markdown nits from review

- Use new-style admonition title syntax :::tip[...]
- Remove blank lines between Tabs/TabItem tags (Docusaurus requires
  no line between tabs/tabitem boundaries; newlines around code blocks
  are kept)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: oceans404

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)