Skip to main content
A prompt is a named text template stored on a profile and served over the profile’s MCP endpoint. Commands target the current profile; pass -p/--profile to target another one. Claude Code surfaces MCP prompts as slash commands — /mcp__<server>__<name>, where <server> is whatever name you gave the connection (machine0 on VMs, which wire the profile endpoint automatically). One prompts new makes a prompt available in every Claude surface connected to the profile — unlike machine-local .claude/commands files, the library follows the profile everywhere, and edits propagate without touching any machine.
Two propagation rules: adds and removes appear in a client on its next connect (Claude Code discovers prompts when it connects — reconnect the server or restart the session to pick up a new prompt); body and description edits are live on the next invocation, no reconnect needed. Prompt names follow the same rules as integration names (letters, digits, and dashes; max 63 characters, unique per profile case-insensitively). Each profile holds up to 50 prompts, bodies up to 64KB, stored encrypted at rest. Prompts in v1 take no arguments — invoking the slash command inserts the body verbatim; argument templating is a planned follow-up.

​
prompts ls

List a profile’s prompts with their descriptions and the start of each body (truncated to the terminal width).

​
prompts get

Show a prompt’s name, description, and full body — word-wrapped to the terminal width.

​
prompts new

Add a prompt to a profile. Aliased as prompts create and prompts add. Takes a --body and an optional --description. Adding a name that already exists errors with a pointer at prompts update. The --body flag takes three input modes (curl’s @ convention), and omitting it in a terminal opens $EDITOR like git commit:

​
prompts update

Update a prompt’s body or description. Pass an empty string to clear the description. With no flags in a terminal, opens $EDITOR pre-filled with the current body.

​
prompts rm

Remove a prompt from a profile. It disappears from connected clients on their next connect.