From 63f70b0221c4dc746f81d72ff7ffdec8d5dfd645 Mon Sep 17 00:00:00 2001 From: oceans404 Date: Tue, 14 Jul 2026 12:38:42 -0700 Subject: [PATCH 1/3] 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) --- docs/build/building-with-ai.mdx | 100 +++++++++++++++++- .../current/tools/developer-tools/ai-bot.mdx | 27 ----- static/llms.txt | 4 + 3 files changed, 103 insertions(+), 28 deletions(-) delete mode 100644 i18n/es/docusaurus-plugin-content-docs/current/tools/developer-tools/ai-bot.mdx diff --git a/docs/build/building-with-ai.mdx b/docs/build/building-with-ai.mdx index 6c5ac4d2d9..7aedad0287 100644 --- a/docs/build/building-with-ai.mdx +++ b/docs/build/building-with-ai.mdx @@ -5,10 +5,107 @@ 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; Raven is the richest. + +:::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). + + + + + +```bash +claude mcp add --transport http stellar-raven "https://raven.stellar.buzz/mcp" +# then run /mcp -> Authenticate -> sign in in your browser +``` + + + + + +```bash +codex mcp add stellar-raven --url "https://raven.stellar.buzz/mcp" +codex mcp login stellar-raven # opens your browser +``` + + + + + +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" } + } +} +``` + + + + + +Go to **Settings → Connectors → Add custom connector**, paste the endpoint, and approve the browser sign-in. + +```text +https://raven.stellar.buzz/mcp +``` + + + + + +```bash +code --add-mcp '{"name":"stellar-raven","type":"http","url":"https://raven.stellar.buzz/mcp"}' +``` + + + + + +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"] + } + } +} +``` + + + + + ## 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 +185,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 diff --git a/i18n/es/docusaurus-plugin-content-docs/current/tools/developer-tools/ai-bot.mdx b/i18n/es/docusaurus-plugin-content-docs/current/tools/developer-tools/ai-bot.mdx deleted file mode 100644 index aab0133d72..0000000000 --- a/i18n/es/docusaurus-plugin-content-docs/current/tools/developer-tools/ai-bot.mdx +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Bot de IA (Stella) -description: Stella es un bot de IA que te ayudará con todas tus preguntas sobre Stellar -sidebar_label: Bot de IA Stella -sidebar_position: 117 ---- - -# Conoce a Stella - -Tu asistente de IA para el desarrollo en Stellar. Stella es una asistente de IA para ayudar a desarrolladores y usuarios con preguntas sobre la cadena de bloques Stellar y los contratos inteligentes. - -**¡Ahora en Beta!** Estamos pilotando Stella para facilitar el desarrollo en Stellar. Tus [comentarios](#help-us-improve) nos ayudan a mejorar esta experiencia para toda la comunidad. - -Puedes chatear con Stella aquí mismo haciendo clic en el ícono amarillo al final de esta página, o unirte al canal #stella-help en el [Discord de desarrolladores de Stellar](https://discord.gg/stellardev). - -## Fuentes de conocimiento - -Stella extrae información de una base de conocimientos extensa, que incluye: - -- Stack Overflow: Soluciones reales y respuestas validadas por la comunidad -- Manual SCF: Ideas profundas sobre los procesos del Fondo Comunitario Stellar -- Contenido de YouTube: Tutoriales, demostraciones y charlas de conferencias del ecosistema Stellar -- Repositorios de GitHub: Ejemplos de código y patrones de implementación - -## Ayúdanos a mejorar - -¡Esperamos tus comentarios! Usa 👍/👎 para calificar las respuestas o haz clic en "Agregar comentario" para compartir sugerencias específicas. Cada aporte nos ayuda a mejorar a Stella para todos los desarrolladores. diff --git a/static/llms.txt b/static/llms.txt index f2ebe697fd..e43e070b33 100644 --- a/static/llms.txt +++ b/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) From 5bf05ca354cc7f451030a268fe42d85ceaf268f2 Mon Sep 17 00:00:00 2001 From: oceans404 Date: Tue, 14 Jul 2026 12:42:18 -0700 Subject: [PATCH 2/3] docs: fix prettier formatting and reword Raven comparison Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/build/building-with-ai.mdx | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/docs/build/building-with-ai.mdx b/docs/build/building-with-ai.mdx index 7aedad0287..680ab6d54e 100644 --- a/docs/build/building-with-ai.mdx +++ b/docs/build/building-with-ai.mdx @@ -23,7 +23,7 @@ Raven exposes two MCP tools: 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; Raven is the richest. +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 @@ -96,7 +96,13 @@ For clients without native remote/OAuth support, bridge with [`mcp-remote`](http "mcpServers": { "stellar-raven": { "command": "npx", - "args": ["-y", "mcp-remote@latest", "https://raven.stellar.buzz/mcp", "--transport", "http-only"] + "args": [ + "-y", + "mcp-remote@latest", + "https://raven.stellar.buzz/mcp", + "--transport", + "http-only" + ] } } } From b6ed38331fe7f950f4087a607fbd40cf01b2b232 Mon Sep 17 00:00:00 2001 From: oceans404 Date: Tue, 14 Jul 2026 14:24:11 -0700 Subject: [PATCH 3/3] 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) --- docs/build/building-with-ai.mdx | 9 +-------- 1 file changed, 1 insertion(+), 8 deletions(-) diff --git a/docs/build/building-with-ai.mdx b/docs/build/building-with-ai.mdx index 680ab6d54e..28fad16984 100644 --- a/docs/build/building-with-ai.mdx +++ b/docs/build/building-with-ai.mdx @@ -25,7 +25,7 @@ Under the hood it wraps Stellar Docs (via Algolia), Lumenloop, Stellar Light, an 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 +:::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). @@ -36,7 +36,6 @@ Unlike the static [`llms.txt`](#using-llmstxt) file and the installable [Stellar 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). - ```bash @@ -45,7 +44,6 @@ claude mcp add --transport http stellar-raven "https://raven.stellar.buzz/mcp" ``` - ```bash @@ -54,7 +52,6 @@ codex mcp login stellar-raven # opens your browser ``` - Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` per project). Cursor runs the OAuth sign-in on first use. @@ -68,7 +65,6 @@ Add to `~/.cursor/mcp.json` (or `.cursor/mcp.json` per project). Cursor runs the ``` - Go to **Settings → Connectors → Add custom connector**, paste the endpoint, and approve the browser sign-in. @@ -78,7 +74,6 @@ https://raven.stellar.buzz/mcp ``` - ```bash @@ -86,7 +81,6 @@ code --add-mcp '{"name":"stellar-raven","type":"http","url":"https://raven.stell ``` - For clients without native remote/OAuth support, bridge with [`mcp-remote`](https://github.com/geelen/mcp-remote): @@ -109,7 +103,6 @@ For clients without native remote/OAuth support, bridge with [`mcp-remote`](http ``` - ## Stellar Skills