How do I install Stellar Raven?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Stellar Raven need an API key?

No required environment variable is listed on this record.

What transport does Stellar Raven use?

Stellar Raven runs locally over stdio.

When was Stellar Raven last checked?

Last checked 2026-10-28. Stellar MCP server for AI agents: one authenticated gateway to official docs, live ecosystem data, community intel, and tested playbooks.

Máy chủ MCP Stellar Raven

Power your agent

Thêm server này

Install from the publisher. Not a PlugMCP endpoint.

Chạy trên PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Chạy trên PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Mở

Server facts

Local

Transport: stdio
License: Apache-2.0
Last checked: 2026-10-28

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Stellar Raven

Stellar Raven is a remote MCP server on Cloudflare Workers. It gives agents two tools over one catalog of Stellar ecosystem sources: Lumenloop, Stellar Light/Scout, Stellar Docs, and selected ecosystem skills.

search finds service operations and skills.
execute runs agent-written JavaScript in a Dynamic Worker isolate with no network access. Host-side adapters make every service call and hold every secret.

The server instructions also include a generated source-family map. Agents use it to plan which source family can answer a question.

Sources and operators

Source family	Run by	How Raven reads it
Lumenloop (`lumenloop.*`)	The independent Lumen Loop team (lumenloop.com)	Its API, with an API key that Lumen Loop issued to Raven
Stellar Light/Scout (`scout.*`)	The Stellar Light team (stellarlight.xyz)	Its read-only public API, which it publishes for AI tools and agents
Stellar Docs (`stellarDocs.*`)	The Stellar Development Foundation (developers.stellar.org)	The search index of the official docs site

Selected ecosystem skills come from Lumen Loop, OpenZeppelin, the Stellar Development Foundation, Stellar Light, and Trustless Work. Raven pins each source at a reviewed commit, and each skill keeps its own license. ecosystem-skills/README.md describes the pin set.

Connect

Add https://raven.stellar.org/mcp to an MCP client that supports streamable HTTP and OAuth. Raven is its own OAuth authorization server, and WorkOS AuthKit handles sign-in. Compatible clients find and complete this flow automatically. An access token lasts 1 hour. Clients refresh it automatically for 90 days, then the user signs in again.

Page	URL
User guide and troubleshooting	https://raven.stellar.org/docs
Browser Playground	https://raven.stellar.org/playground
Terms and privacy	https://raven.stellar.org/terms
Health	https://raven.stellar.org/health

For help, use the #raven channel in the Stellar Developers Discord. To report a vulnerability, read SECURITY.md.

Run locally

Use Node 24 (.nvmrc) and run npm ci.
Create .dev.vars with the variable names in the .dev.vars step of ci.yml. Set DEV_ALLOW_UNAUTHENTICATED=true to skip OAuth. This bypass works only for the loopback hosts localhost, 127.0.0.1, ::1, and [::1]. A Lumenloop call needs a real LUMENLOOP_API_KEY. A Stellar Docs call needs real ALGOLIA_APPLICATION_ID_DOCS and ALGOLIA_API_KEY_DOCS values. Without them, the call returns an error. A Stellar Light/Scout call needs no key.
Run npm run typegen. It generates env.d.ts from wrangler.jsonc and the names in .dev.vars.
Run npm run dev and connect a client to http://localhost:8787/mcp. Restart the server after you edit .dev.vars.

The Worker reads .dev.vars. Maintenance scripts, such as scripts/refresh-inventory.mjs, read .env. Git ignores both files.

Test

npm run typecheck   # tsc
npm test            # unit and contract tests (offline)
npm run test:smoke  # the assembled Worker and the Dynamic Worker boundary
npm run build       # dry-run the Worker bundle

test/README.md maps the test suites.

Documentation

Question	Document
What is in scope, and which decisions are open?	PLAN.md
How do `search` and `execute` work?	ARCHITECTURE.md
How do I deploy and operate Raven?	docs/operations.md
How is usage counted and retained?	usage/README.md
How do I contribute?	CONTRIBUTING.md
How do agents work in this repository?	AGENTS.md
How do I report a vulnerability?	SECURITY.md

Thêm server này

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Stellar Raven?

Does Stellar Raven need an API key?

What transport does Stellar Raven use?

When was Stellar Raven last checked?

Documentation

Stellar Raven

Sources and operators

Connect

Run locally

Test

Documentation

License