Read-only mode

By default the Connector exposes 95 tools — including ones that create, update, and delete. Read-only mode registers only tools that read data. Anything that writes is hidden from the assistant entirely, not just marked "destructive."

One flag
Write tools hidden
Per-profile
TURN IT ON

Pass --tools read-only at setup

$

kuali mcp setup --profile prod --tools read-only

$

kuali mcp setup --profile prod --client claude-code --tools read-only

Restart the AI client (or reload tools) and the destructive tools vanish.

WHAT'S AVAILABLE

Every read operation stays

Symptom
Fix
Apps & Forms
list, get, icons, schema, options, outline
Documents
list, get
Users & Groups
list, get, members, API-key listing
Workflows
status, actions, get, list, executions
Products & Integrations
all read tools, failures
Export
csv, pdf, xlsx — exports are reads
Utilities
summary, doctor, connection management
WHAT'S HIDDEN

Everything that changes the instance

Any _create, _update, _delete, _activate, _deactivate. Document lifecycle (submit, approve, sendback, duplicate). Workflow administration (bypass, retry, skip, reassign, trigger). Imports, integration invocation, file uploads, API key creation, form template updates, permission grants — and kuali_run, the arbitrary-command escape hatch.

No partial execution, no prompts

If the assistant tries to call one of these, it simply doesn't see it in the tool list.

MIXING MODES

Sandbox full-access, production read-only

$

kuali mcp setup --profile sandbox

$

kuali mcp setup --profile prod --tools read-only

Same Connector binary, two config entries. For clients that keep one kuali entry at a time, register each profile as its own MCP server with a distinct name (kuali-sandbox, kuali-prod).

LIMITS

What read-only does not protect

Your API key still has whatever permissions its owner has — if the key could read something you'd rather it couldn't, issue a key for a narrower Kuali user. And the assistant can still describe an action it would take; it just can't execute it.

Belt and braces

Pair read-only mode with a dedicated low-privilege API key for truly sensitive environments.

First connection ->

Where to next

Prompt library

Ready-to-use prompts for curriculum, research, build apps, imports, workflow analysis, and reporting.

Browse prompts →
Client-specific guides

Tips for Claude Desktop, Claude Code, Codex, Gemini, Copilot, and VS Code.

AI assistants →
Use it as a CLI

Skip the chat — every capability is also a plain kuali command, ready for scripts and CI.

Command reference →