Stellar Jay MCP server
Commit Oct 30, 2026Enables AI agents to perform versioned, attributed, and reversible business processes on company data using an agent-native data store.
Also known as kyle-visner/stellarjay, stellarjay
- Stars
- 9
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.7.1
- Last commit
- Oct 30, 2026
- License
- AGPL-3.0
What is Stellar Jay MCP?
Stellar Jay enables AI agents to perform versioned, attributed, and reversible business processes on company data using an agent-native data store.
Summary generated from the project's README
About Stellar Jay MCP server
AvianSuite provides an agent-native business data platform designed for developers and small teams who want to move from read-only copilots to active agents. It uses the Stellar Jay data store to allow AI agents to perform tasks like bookkeeping or sales follow-up while ensuring every modification is versioned and attributed to a specific agent. This structure functions like Git for business data, meaning no information is ever overwritten or deleted, and every change can be reversed.
Users can access the service through a hosted version at AvianSuite for $20 per month per store or by self-hosting the open-source software under the AGPL license. To connect an agent, you can use the MCP server via Claude Code, Cursor, or custom connectors in Claude and ChatGPT. Self-hosted setups require the stellarjay-mcp command and specific environment variables like STELLARJAY_URL and STELLARJAY_TOKEN to manage secure communication with the local or remote store.
What you can do with it
- 1Reversing agent mistakesAn AI agent can undo all changes made within a specific time window if it performs an incorrect action.
- 2Auditing agent activityDevelopers can track exactly which agent modified a specific piece of data and when it happened.
- 3Preventing data corruptionThe system prevents agents from creating duplicate entries during retries or writing data based on outdated information.
- 4Managing flexible business recordsYou can add new fields to your business facts without needing to perform complex database migrations.
Written from the project's README. Every use case is checked against a quote from it.
How to install Stellar Jay MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Stellar Jay MCP in Claude Code
$ claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcpInstall Stellar Jay MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Install Stellar Jay MCP in VS Code
.vscode/mcp.json
{
"servers": {
"stellarjay": {
"type": "http",
"url": "https://mcp.aviansuite.com/mcp"
}
}
}Install Stellar Jay MCP in VS Code CLI
$ code --add-mcp '{"name":"stellarjay","type":"http","url":"https://mcp.aviansuite.com/mcp"}'Install Stellar Jay MCP in Codex
$ codex mcp add stellarjay --url https://mcp.aviansuite.com/mcpInstall Stellar Jay MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.stellarjay] url = "https://mcp.aviansuite.com/mcp"
Install Stellar Jay MCP in Gemini CLI
$ gemini mcp add -s user --transport http stellarjay https://mcp.aviansuite.com/mcpInstall Stellar Jay MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"stellarjay": {
"url": "https://mcp.aviansuite.com/mcp",
"type": "http"
}
}
}Configuration
STELLARJAY_AUTH_FILESTELLARJAY_DATA_DIRSTELLARJAY_DATA_KEY_FILESTELLARJAY_TOKENSTELLARJAY_URL
| Name | Description | |
|---|---|---|
| STELLARJAY_AUTH_FILE | — | |
| STELLARJAY_DATA_DIR | — | |
| STELLARJAY_DATA_KEY_FILE | — | |
| STELLARJAY_TOKEN | — | |
| STELLARJAY_URL | — |
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekyle-visner/stellarjay is public and reachablegithub.com/kyle-visner/stellarjay ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)AGPL-3.0spdx.org/licenses/AGPL-3.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-30github.com/kyle-visner/stellarjay ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubStellar 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 questions
How do I add Stellar Jay MCP to Claude Code?
Run claude mcp add --transport http stellarjay https://mcp.aviansuite.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Stellar Jay MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I prevent agents from overwriting or deleting my data?
The system is designed so that nothing is overwritten or deleted; corrections are new entries and the original remains in history.
Can I undo changes made by an AI agent?
Yes, you can roll back all changes made by a specific agent within a time window, with the option to preview the rollback first.
How do I know which agent made a specific change?
Every change is attributed to the specific agent via its own token, allowing you to see exactly who changed what and when.