Command reference

This is a forward-looking specification. The mcpsail CLI is not yet implemented.

Auth commands#

Command	Description
mcpsail auth login	OAuth 2.1 PKCE login, stores token in OS keychain
mcpsail auth logout	Clear stored tokens
mcpsail auth status	Show current auth state
mcpsail auth whoami	Show authenticated identity
mcpsail auth token print	Print current access token
mcpsail auth service-account create --org <id> --name <n> --scopes ...	Create service account
mcpsail auth service-account list --org <id>	List service accounts
mcpsail auth service-account rotate <id>	Rotate credentials
mcpsail auth service-account revoke <id>	Revoke service account

MCP server commands#

Command	Description
mcpsail mcp connect --url <url>	Connect existing MCP server
mcpsail mcp generate --openapi <spec>	Generate from OpenAPI
mcpsail mcp list [--kind generated|connected]	List servers
mcpsail mcp show <id>	Show server details
mcpsail mcp refresh-openapi <id> [--dry-run]	Non-destructive merge
mcpsail mcp discover <id>	Rediscover connected server tools
mcpsail mcp publish <id>	Publish / redeploy
mcpsail mcp delete <id>	Delete server

Tool commands#

Command	Description
mcpsail tool list --server <id>	List tools
mcpsail tool show <server-id> <tool>	Show tool details
mcpsail tool patch <server-id> <tool> [--enabled] [--instructions ...]	Edit tool rules
mcpsail tool import-rules <server-id> --file rules.yaml	Bulk import from YAML
mcpsail tool export-rules <server-id>	Export rules to YAML

Agent commands#

Command	Description
mcpsail agent create --name ... --model ...	Create agent
mcpsail agent attach <id> --server <id> [--enabled-tools ...]	Attach MCP server
mcpsail agent detach <id> --server <id>	Detach MCP server
mcpsail agent show <id>	Show agent details
mcpsail agent chat <id>	Interactive REPL

Gateway commands#

Command	Description
mcpsail gateway create --name ...	Create gateway profile
mcpsail gateway list	List gateways
mcpsail gateway attach <gw-id> --server <id>	Attach to server
mcpsail gateway detach <gw-id> --server <id>	Detach from server

Utility commands#

Command	Description
mcpsail logs tail --server <id> [--follow]	Stream request logs
mcpsail audit tail [--actor ...] [--resource ...]	Stream audit events
mcpsail config use-profile <name>	Switch active profile
mcpsail config set <key> <value>	Set config value
mcpsail doctor	Check connectivity and auth
mcpsail version	Print version

Global flags#

All commands accept:

• --org <id> — override profile org
• --tenant <id> — override profile tenant
• --output table|json|yaml — output format
• --quiet — suppress non-essential output
• --dry-run — preview mode for write commands

Exit codes#

Code	Meaning
0	Success
1	User error
2	Auth error
3	Not found
4	Conflict (optimistic concurrency)
5	Server error