Stellar Jay MCP server
Commit 30. Okt. 2026Ermöglicht es AI Agents, versionierte, attribuierte und umkehrbare Geschäftsprozesse auf Unternehmensdaten mithilfe eines agenten-nativen Data Store durchzuführen.
Auch bekannt als kyle-visner/stellarjay, stellarjay
- Stars
- 9
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 0.7.1
- Letzter Commit
- 30. Okt. 2026
- Lizenz
- AGPL-3.0
Was ist Stellar Jay MCP?
Ermöglicht es AI Agents, versionierte, attribuierte und umkehrbare Geschäftsprozesse auf Unternehmensdaten mithilfe eines agenten-nativen Data Store durchzuführen.
Zusammenfassung generiert aus dem README des Projekts
Über Stellar Jay MCP server
AvianSuite bietet eine agenten-native Business-Data-Plattform für Entwickler und kleine Teams, die den Schritt von Read-only-Copiloten zu aktiven Agents machen wollen. Es nutzt den Stellar Jay Data Store, damit AI Agents Aufgaben wie Buchhaltung oder Sales Follow-ups erledigen können, während sichergestellt wird, dass jede Modifikation versioniert und einem spezifischen Agent zugeordnet wird. Diese Struktur funktioniert wie Git für Business-Daten, was bedeutet, dass keine Informationen jemals überschrieben oder gelöscht werden und jede Änderung rückgängig gemacht werden kann.
Nutzer können den Service über eine hosted Version bei AvianSuite für 20 $ pro Monat und Store nutzen oder die Open-Source-Software unter der AGPL-Lizenz selbst hosten. Um einen Agent zu verbinden, kannst du den MCP server via Claude Code, Cursor oder über benutzerdefinierte Connectors in Claude und ChatGPT verwenden. Self-hosted Setups erfordern den stellarjay-mcp Befehl und spezifische Umgebungsvariablen wie STELLARJAY_URL und STELLARJAY_TOKEN, um die sichere Kommunikation mit dem lokalen oder remote Store zu verwalten.
Was du damit machen kannst
- 1Agent-Fehler rückgängig machenEin AI Agent kann alle Änderungen, die innerhalb eines bestimmten Zeitfensters vorgenommen wurden, rückgängig machen, falls er eine falsche Aktion ausführt.
- 2Agent-Aktivitäten auditierenEntwickler können genau nachverfolgen, welcher Agent einen spezifischen Datensatz modifiziert hat und wann dies geschah.
- 3Datenkorruption verhindernDas System verhindert, dass Agents bei Retries Duplikate erstellen oder Daten basierend auf veralteten Informationen schreiben.
- 4Flexible Geschäftsdatensätze verwaltenDu kannst neue Felder zu deinen Business Facts hinzufügen, ohne komplexe Datenbank-Migrationen durchführen zu müssen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Stellar Jay MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenStellar Jay MCP in Claude Code installieren
$ claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcpStellar Jay MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Stellar Jay MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"stellarjay": {
"type": "http",
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Stellar Jay MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"stellarjay","type":"http","url":"https://mcp.aviansuite.com/mcp"}'Stellar Jay MCP in Codex installieren
$ codex mcp add stellarjay --url https://mcp.aviansuite.com/mcpStellar Jay MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.stellarjay] url = "https://mcp.aviansuite.com/mcp"
Stellar Jay MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http stellarjay https://mcp.aviansuite.com/mcpStellar Jay MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp",
"type": "http"
}
}
}Konfiguration
STELLARJAY_AUTH_FILESTELLARJAY_DATA_DIRSTELLARJAY_DATA_KEY_FILESTELLARJAY_TOKENSTELLARJAY_URL
| Name | Beschreibung | Typ |
|---|---|---|
| STELLARJAY_AUTH_FILE | — | |
| STELLARJAY_DATA_DIR | — | |
| STELLARJAY_DATA_KEY_FILE | — | |
| STELLARJAY_TOKEN | — | |
| STELLARJAY_URL | — |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarkyle-visner/stellarjay is public and reachablegithub.com/kyle-visner/stellarjay ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-30github.com/kyle-visner/stellarjay ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeHTTPS endpoint answered 401 (sign-in required)Bestanden
README
Auf GitHub ansehenStellar Jay
Stellar Jay is the open-source data store that powers AvianSuite. AvianSuite is an agent-native business data platform: AI agents run business processes like sales follow-up and bookkeeping on your company's data, and every change they make is versioned, attributed to the agent that made it, and reversible. Think of it as Git for your business data.
Agents connect over MCP. The server is listed in the MCP registry as
com.aviansuite/stellar-jay, and the CRM (Martin)
and bookkeeping (Magpie) apps run on
the same store. This project was formerly called JayBase.
- Hosted: AvianSuite runs Stellar Jay for you. $20/month per store, with a 14-day free trial.
- Self-hosted: free and open source under the AGPL. The quick start below gets a store running on your machine in a few minutes.
Agent setup
Connect an agent with the MCP server. On AvianSuite, add the remote server:
# Claude Code
claude mcp add --transport http aviansuite https://mcp.aviansuite.com/mcp
// Cursor: .cursor/mcp.json
{"mcpServers": {"aviansuite": {"url": "https://mcp.aviansuite.com/mcp"}}}
In Claude and ChatGPT, add a custom connector with the same URL.
For a self-hosted store, run the local server instead:
{
"mcpServers": {
"aviansuite": {
"command": "stellarjay-mcp",
"env": {"STELLARJAY_URL": "https://store.example.com", "STELLARJAY_TOKEN": "writer-token"}
}
}
}
Install it with go install github.com/kyle-visner/stellarjay/cmd/stellarjay-mcp@latest.
Tools and details: docs/mcp.md.
Why
Clients want agents that do the work, not just read about it. But when an agent writes straight into a CRM or ticketing system, one bad decision or runaway loop can overwrite or delete records, and there is often no way back.
Stellar Jay is built so that can't happen:
- Nothing is overwritten or deleted. A correction or retraction is a new entry, and the original stays in history.
- Every change has a name on it. Each agent gets its own token, so you can see exactly which agent changed what, and when.
- Any change can be undone. Roll back everything one agent did in a time window, with a preview first.
- History is tamper-evident. If anyone rewrites or removes past entries, it shows.
- Retries are safe. An agent that retries after a timeout doesn't create duplicates, and a write based on stale information is refused.
- Your data stays flexible. Facts are JSON, so new fields and new kinds of records need no migrations.
Every fact keeps its evidence and the agent that recorded it, so any wrong one is visible, attributed and correctable.
Who it's for
Developers, consultants, and small teams moving from read-only copilots to agents that are allowed to act: operations, accounting, approvals, support, and other work where the data matters. Each store serves one organization. Many agents and apps can share it.
Quick start (self-hosted)
Requires Go 1.22 or later.
1. Install and create secrets.
go install github.com/kyle-visner/stellarjay/cmd/stellarjay-server@latest
stellarjay-server init ./secrets
init creates a data encryption key and prints an admin, writer, and reader
token once. Save them in a password manager.
2. Start the server.
export STELLARJAY_DATA_DIR=./data
export STELLARJAY_DATA_KEY_FILE=./secrets/data_key
export STELLARJAY_AUTH_FILE=./secrets/auth.json
stellarjay-server serve
It listens on 127.0.0.1:8080.
3. Record a fact. In another terminal:
export STELLARJAY_URL=http://127.0.0.1:8080
export STELLARJAY_TOKEN='the-writer-token'
curl -fsS -X POST "$STELLARJAY_URL/v1/events" \
-H "Authorization: Bearer $STELLARJAY_TOKEN" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: first-fact" \
--data '{
"type": "business.fact",
"entity_id": "customer-42",
"command": "fact assert",
"payload": {"predicate": "primary_contact", "value": "Ada Lovelace"},
"expected_root": ""
}'
expected_root is empty only for the first entry in a new store. After that,
read the current value from GET /v1/root and send it with each write, so a
write based on stale information is refused. The API guide
covers reading history, pagination, named checkpoints, and snapshots.
4. Connect an agent. Point the MCP server at your store:
go install github.com/kyle-visner/stellarjay/cmd/stellarjay-mcp@latest
Then use the self-hosted config from Agent setup with
STELLARJAY_URL=http://127.0.0.1:8080 and your writer token. Agents that don't
use MCP can read $STELLARJAY_URL/llm.txt, which explains how to work with the
store.
Deploy to a server
For a production store with HTTPS, you need a Linux host with Docker Compose, ports 80 and 443 open, and a DNS record pointing a domain at the host.
git clone https://github.com/kyle-visner/stellarjay.git
cd stellarjay
cp .env.example .env
# Edit .env and set STELLARJAY_DOMAIN.
go run ./cmd/stellarjay-server init ./secrets
docker compose up -d --build
curl https://stellarjay.example.com/health/ready
init will not replace existing secrets. The
operations runbook covers backups, token rotation and
upgrades, and the security model covers keys, roles and
hardening. Or skip all of this and use AvianSuite.
Documentation
- llm.md: the guide agents follow to read and write safely
- docs/mcp.md: MCP server setup and tools
- docs/how-it-works.md: storage model, deployment and the embedded Go library
- docs/api.md: HTTP API reference (OpenAPI)
- docs/architecture.md, docs/security.md, docs/operations.md: running it in production
Development
GOCACHE=/tmp/stellarjay-gocache go test -race ./...
GOCACHE=/tmp/stellarjay-gocache go vet ./...
docker compose config
docker build -t stellarjay:test .
License
AGPL-3.0-or-later. See LICENSE. Hosted Stellar Jay is available from
AvianSuite.
Stellar Jay MCP Fragen
Wie füge ich Stellar Jay MCP zu Claude Code hinzu?
Führe claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Stellar Jay MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Wie kann ich verhindern, dass Agents meine Daten überschreiben oder löschen?
Das System ist so konzipiert, dass nichts überschrieben oder gelöscht wird; Korrekturen sind neue Einträge, während das Original in der Historie erhalten bleibt.
Kann ich Änderungen, die ein AI Agent vorgenommen hat, rückgängig machen?
Ja, du kannst alle Änderungen, die ein spezifischer Agent innerhalb eines Zeitfensters vorgenommen hat, zurückrollen, mit der Option, den Rollback vorab in einer Vorschau zu prüfen.
Woher weiß ich, welcher Agent eine bestimmte Änderung vorgenommen hat?
Jede Änderung wird dem spezifischen Agent über dessen eigenen Token zugeordnet, sodass du genau sehen kannst, wer was wann geändert hat.