MCP Tools Reference

Supaspec exposes 7 MCP tools. Each tool groups related actions under a single tool name. Agents call these tools automatically based on your prompts.

Manage projects. Read-only, idempotent.

`action`	enum	required	"list" \| "get" \| "search" \| "whoami"
`project`	string	optional	Project name or slug (required for get, search)
`query`	string	optional	Search query (required for search)
`status_filter`	string	optional	Filter sections: "draft", "wip", "approved", "implementing", "implemented"

list — Returns all accessible projects with id, name, slug, description.

get — Returns all sections with full content for a project. Use status_filter to narrow results.

search — Full-text search across all sections in a project.

whoami — Returns your identity and accessible projects.

Manage project sections. Create, read, update, diff.

`action`	enum	required	"list" \| "get" \| "create" \| "update" \| "set_status" \| "diff"
`project`	string	required	Project name or slug
`section`	string	optional	Section title or slug (required for get, update, set_status, diff)
`title`	string	optional	Section title (required for create)
`content`	string	optional	Markdown content (required for create, update)
`agent_name`	string	optional	Your agent name, e.g. "claude_code" (required for create, update, set_status)
`mode`	enum	optional	"commit" (default) or "propose" (update only)
`message`	string	optional	Short commit summary
`description`	string	optional	Longer explanation (update only)
`prompt`	string	optional	What the user asked you to do (update only)
`status`	enum	optional	"draft" \| "wip" \| "approved" \| "implementing" \| "implemented"
`after_section`	string	optional	Insert after this section (create only)
`from_version`	number	optional	Starting version (required for diff)
`to_version`	number	optional	Ending version (required for diff)

list — All sections (no content). Shows id, title, slug, status, sort order.

get — Full section content, metadata, latest version, and open proposal count.

create — Creates a new section with title, content, and optional position.

update — Updates content. Mode “commit” applies immediately; “propose” creates a proposal for review.

set_status — Changes section status (draft → wip → approved → implementing → implemented).

diff — Returns a unified diff between two versions.

Manage proposals (change requests on sections).

`action`	enum	required	"list" \| "get" \| "accept" \| "reject" \| "update"
`project`	string	required	Project name or slug
`section`	string	optional	Section title or slug (required for get, accept, reject, update)
`proposal`	number	optional	Proposal number (required for get, accept, reject, update)
`agent_name`	string	optional	Your agent name (required for accept, reject, update)
`content`	string	optional	Updated full content (required for update)
`message`	string	optional	Commit message for revision (update only)
`reason`	string	optional	Rejection reason (reject only)

Manage proposal comments.

`action`	enum	required	"add" \| "resolve"
`project`	string	required	Project name or slug
`section`	string	required	Section title or slug
`proposal`	number	required	Proposal number
`agent_name`	string	optional	Your agent name (required for add)
`body`	string	optional	Markdown comment text (required for add)
`change_id`	string	optional	Anchor comment to a specific change (add only)
`comment_id`	string	optional	Comment ID to resolve (required for resolve)

View version history. Read-only, idempotent.

`action`	enum	required	"log" \| "show_version"
`project`	string	required	Project name or slug
`section`	string	optional	Section title or slug (optional for log, required for show_version)
`version`	number	optional	Version number (required for show_version)

log — Commit log with version numbers, messages, authors. Section-scoped or project-wide.

show_version — Full content at a specific version, plus commit metadata.

Manage project assets (files up to 500KB).

`action`	enum	required	"list" \| "get" \| "upload" \| "delete"
`project`	string	required	Project name or slug
`filename`	string	optional	Asset filename (required for get, upload, delete)
`content_base64`	string	optional	Base64-encoded file content (required for upload)
`mime_type`	string	optional	MIME type (e.g. "image/svg+xml"), default: application/octet-stream

Manage project secrets and environment variables.

`action`	enum	required	"list" \| "get" \| "set" \| "delete" \| "export_env"
`project`	string	required	Project name or slug
`key`	string	optional	Secret key name, e.g. "DATABASE_URL" (required for get, set, delete)
`value`	string	optional	Secret value (required for set)
`description`	string	optional	Description for the secret (optional for set)

list — All keys with values masked.

get — Single key with revealed value.

set — Create or update a key-value pair. Values are encrypted at rest.

export_env — All secrets formatted as a .env file.