Skip to main content
The concierca CLI is a thin terminal client for the same MCP surface described in this reference — built for terminal-based AI agents (like Claude Code) and for humans who prefer a shell. Every command is exactly one MCP tool call: validation, tenant and scope filtering, and governance all stay server-side. The only client-side convenience is that commands accepting an agent slug resolve it to the id with one lookup.

​
Setup

Create a key in the app under Settings › MCP Access — when generating it, you pick exactly which tools the key may call (a per-tool allowlist). Then export two environment variables:
No install step is required — invoke it install-free with pnpm dlx, or add a short alias:

​
Commands (v1)

Each command is exactly one MCP tool call.

​
Notes

  • Governance is server-side. The key’s per-tool allowlist governs what the CLI can call; anything not granted is rejected — the client cannot widen its own scope.
  • agents run and missions approve are human-gated. agents run creates a pending approval rather than executing silently; missions approve is the human decision on a paused step.
  • Slug resolution is the only client-side convenience: commands that take an agent slug do one lookup to resolve it to the id, then call the tool.
  • Bootstrapping agent JSON: concierca tools list --json prints each tool’s input schema, so you can build an agent.json from the agent_create schema.
See Connect via MCP for connecting other clients, Authentication for the key + scope model, and Conventions for shared parameters and errors.