Raven: Stellar entero dentro de tu agente de IA

Construir en una blockchain nueva nunca fue difícil por el lenguaje. Fue difícil por el contexto. La documentación vive en un sitio y los estándares en otro. Los datos de la red cambian todos los días. Y el agente de IA que uno tiene abierto no sabe nada de eso: escribe código plausible sobre una cadena que no conoce.

Stellar decidió resolver eso desde adentro. En su sección Building with AI publicó tres herramientas para que un agente construya sobre Stellar y sobre Soroban, su plataforma de contratos inteligentes. La principal se llama Raven y la fundación la describe como el camino recomendado.

El resultado práctico es este: una persona con Claude Code o Codex instalado le pega una URL a su agente e inicia sesión una vez. Desde ahí el agente busca en la documentación oficial y consulta datos vivos del ecosistema antes de escribir una línea. La barrera que quedaba era la que Raven saca del medio.

Raven no despliega un contrato en mainnet ni decide si la idea sirve. Da contexto. El criterio sigue siendo de quien construye.

Raven es un servidor MCP remoto alojado en raven.stellar.buzz. MCP es el Model Context Protocol, un estándar abierto que Anthropic publicó a fines de 2024 para que un modelo de lenguaje se conecte a herramientas externas de forma uniforme. Si un agente habla MCP, puede usar cualquier servidor MCP. Por eso Raven funciona igual en Claude Code, Codex, Cursor, VS Code y Claude Desktop.

El servidor expone dos herramientas. search localiza documentación de Stellar e información del ecosistema. execute corre consultas contra datos vivos de la red. Debajo, según la propia documentación, Raven envuelve Stellar Docs (indexada con Algolia), Lumenloop, Stellar Light y las skills del ecosistema. Todo eso vuelve como una sola respuesta.

Raven cruza varias fuentes y resume. Eso sirve, y también significa que su respuesta trae un encuadre propio. Lo que un builder verifica es la página de la documentación o el dato en blockchain que Raven señala. Si bien la respuesta ahorra la búsqueda, lo cierto es que no reemplaza la fuente.

El código es público. El repositorio vive en stellar-experimental/stellar-raven bajo licencia Apache-2.0, con Tyler van der Hoeven (@kalepail) como autor principal. Ahí el servicio se describe como una sola puerta autenticada a documentación oficial, datos vivos del ecosistema, inteligencia de comunidad y playbooks probados.

Tellus Cooperative ya publicó en inglés una artículo de Raven en X que lo resume así: el problema no es que la información no exista, es que está repartida.

Corre sobre Cloudflare Workers y, según ese mismo repositorio, está en producción desde el 2 de julio de 2026. El nombre de la organización dice lo que es: experimental, aunque ya se use en producción.

Un comando y una autenticación. En la terminal:

Después, dentro de Claude Code, se escribe /mcp, se elige Authenticate y se completa el inicio de sesión en el navegador. Raven usa OAuth. Ese login es lo que habilita las dos herramientas; sin él el servidor aparece conectado pero no responde.

Desde ahí el agente ya puede usar search y execute por su cuenta. Una forma de comprobarlo es pedirle algo que solo sepa con la documentación al frente. Por ejemplo, qué SEP regula un flujo de depósito y retiro con un ancla, y mirar si cita la página exacta.

Al probarlo, la respuesta llegó con cuatro resultados de la documentación oficial, cada uno con su URL y su sección: SEP-6 para depósitos y retiros programáticos, SEP-24 para los alojados por el anchor, y la diferencia entre los dos (con SEP-24 el cliente no recolecta la información KYC).

Para seguir, el artículo de X de Tellus trae una lista de preguntas de arranque: en qué se diferencian Horizon y RPC, qué documentación leer antes de emitir un activo, qué proyectos del ecosistema trabajan wallets y pagos. Sirven como primer test de cualquier instalación.

Dos comandos, el segundo para el login:

El resto es igual. Para Cursor la doc entrega un bloque para ~/.cursor/mcp.json y para VS Code un code --add-mcp con la misma URL. En Claude Desktop el camino es Settings, Connectors, agregar un conector personalizado y pegar el endpoint. Quien use otro cliente tiene el puente mcp-remote.

Hay también un playground en el navegador para probar Raven sin instalar nada. Pide iniciar sesión.

Raven es la puerta. Las Stellar Skills son el manual que el agente lee cuando ya entró: instrucciones empaquetadas para que sepa cómo se hace cada cosa en Stellar.

La fundación las organiza en siete áreas. Contratos Soroban, frontend y wallets, activos y SAC, las APIs de RPC y Horizon, pagos entre agentes, pruebas ZK, y los estándares SEP y CAP del ecosistema.

Aparte existe un instalador comunitario, stellar-build, que agrega 46 skills con un solo comando. Es de la comunidad, no de la fundación, y vale leer el script antes de correrlo, como con cualquier curl | bash.

La tercera pieza es un archivo llms.txt en developers.stellar.org/llms.txt. Es un formato simple: la documentación resumida y ordenada para que un modelo la lea como contexto. Sirve cuando el agente no soporta MCP o cuando uno quiere darle el mapa entero de una vez.

Hasta acá, empezar en Stellar pedía leer mucho antes de escribir poco. Un contrato en Soroban se escribe en Rust, los estándares tienen número y los datos de la red no están en la cabeza de ningún modelo. Raven pone las tres cosas al alcance del agente.

Lo que no pone es la idea, ni la decisión de qué desplegar, ni la revisión de que el contrato haga lo que dice. Un agente con buena documentación escribe mejor código; no reemplaza a quien lo lee.

Y Raven puede fallar: responder incompleto, mezclar contexto, citar algo viejo. El proyecto lo asume y pide que cada fallo vuelva como un issue en el repositorio (https://github.com/stellar-experimental/stellar-raven/issues).

El artículo de X de Tellus propone algo práctico para eso: pedirle al mismo agente que redacte el issue con la pregunta, la respuesta que dio, qué faltó y las fuentes correctas. Un fallo reportado así mejora la herramienta para el siguiente builder.

Raven es además un servidor remoto con login: cada consulta pasa por la infraestructura de Stellar. El repositorio explica que las consultas de execute corren en sandboxes aislados sin acceso a red. Es un dato para tener a la vista antes de conectarlo, no un motivo para no hacerlo.

Con la barrera de contexto más baja, lo que se va a ver en los próximos meses es cuánta gente en Chile pasa de mirar Stellar a desplegar algo. Ese número, y no la herramienta, es el que va a decir si Raven sirvió.