Connect an agent over MCP

The data store your agents can safely write to. Add one MCP server and your agent can record, correct and retract business facts. Every change is kept and attributed to the agent that made it, and any change can be undone.

Getting in

• You have an account: connect https://mcp.aviansuite.com/mcp and sign in.
• You don't, or your agent can't open a browser: your agent registers with auth.md and gives you a link and a six-digit code. Open the link and type the code, then confirm your email and set a password to create a free sandbox (or sign in). Details below.

Hosted on AvianSuite

Add this URL as a remote MCP server (Streamable HTTP):

https://mcp.aviansuite.com/mcp

Claude, ChatGPT and Cursor sign you in with OAuth and ask you to approve the connection. Approving adds the app as an agent connection on your store, so you can see, undo or revoke what it does. Other clients send an agent token from Agents as Authorization: Bearer.

Claude Code:

claude mcp add --transport http aviansuite https://mcp.aviansuite.com/mcp

Cursor, in .cursor/mcp.json:

{"mcpServers": {"aviansuite": {"url": "https://mcp.aviansuite.com/mcp"}}}

Agent frameworks and scripts:

{"mcpServers": {"aviansuite": {"url": "https://mcp.aviansuite.com/mcp", "headers": {"Authorization": "Bearer YOUR_AGENT_TOKEN"}}}}

No account yet

Ask your agent to set up AvianSuite. It registers with your email by following auth.md:

curl -X POST https://app.aviansuite.com/agent/identity -H 'Content-Type: application/json' \
  -d '{"type": "service_auth", "login_hint": "[email protected]", "agent_name": "Help desk bot", "purpose": "Keep ticket status for the help desk"}'

The agent gives you a link and a six-digit code. Open the link, optionally pick a workspace name such as acme-co (it becomes your workspace address; leave it empty and one is chosen for you), and type the code. We then email you a link to confirm the address is yours; open it and set a password. That creates a free sandbox and connects the agent to it; the agent picks up its access token on its own. The code lasts 10 minutes; if it expires, the agent can get a new one.

You can sign in with the same email and password, so in Claude, ChatGPT or Cursor you connect https://mcp.aviansuite.com/mcp like any account. Sandboxes allow 2 agent connections and 100 MB.

Sandbox states

• Sandbox: free, no card. It is writable for 7 days, then read-only, and it is deleted after 30 days unless you keep it.
• Trial: you added a card. This starts the normal 14-day free trial with nothing lost.
• Paid: the subscription after the trial.

Receipts

Every write returns a receipt link. Agents include it when they report a change, and the person sees exactly what changed, which agent did it, and an Undo button. Only people signed in to the workspace see the change.

Self-hosted Stellar Jay

Run the same tools over stdio against your own store. Self-hosting is free.

go install github.com/kyle-visner/stellarjay/cmd/stellarjay-mcp@latest

{"mcpServers": {"aviansuite": {"command": "stellarjay-mcp", "env": {"STELLARJAY_URL": "https://store.example.com", "STELLARJAY_TOKEN": "writer-token"}}}}

Tools

• record_fact: save a business fact with its evidence.
• correct_fact: replace a fact that was wrong when it was recorded. The old one stays in history. For a value that has since changed, record the new one with record_fact.
• retract_fact: withdraw a fact with a reason.
• get_entity: current facts and full history for one record.
• list_changes: what changed in a time window, filtered by agent or record.
• undo_changes: preview, then reverse everything an agent did in a time window, or restore a checkpoint. A dry run unless you confirm; the dry run returns the exact window and a plan_id to confirm with.
• save_checkpoint: name the current state, such as before-import. To go back to it, call undo_changes with that checkpoint.
• status: store health, current root, and the actor name your writes are attributed to.

Nothing is ever overwritten, so an undo is itself a change you can undo. Each write takes an operation_id, so a retried write is recorded once.

Built-in apps

The hosted server also carries Magpie for bookkeeping and Martin for CRM. They write to the same workspace store, attributed to the same agent. Each is off until an agent turns it on.

• list_apps: which apps this workspace has on, and what each adds.
• enable_app: turn on magpie or martin (with its currency, default USD). Its tools then appear for every agent on the workspace, prefixed magpie_ or martin_, such as magpie_invoice_create and martin_deal_touch. Some clients show new tools only after you reconnect.
• disable_app: turn an app off again. Its tools stop being listed, and its records stay in the store, so enable_app brings it back as it was.

More

• MCP reference
• Agent guide for the HTTP API underneath
• OpenAPI description of the HTTP API