Speck-It

API Reference

Complete reference for all Speck-It MCP Server tools and resources.

Workspace Setup

Tools for setting up and managing your project workspace.

set_constitution

Create or update the project constitution used for downstream planning.

Parameters:

contentstring*

Constitution content

modestring

Replace or append mode

rootstring

Project root path

get_constitution

Retrieve the current constitution contents, if any.

Parameters:

rootstring

Project root path

set_feature_root

Register the project root that owns the feature artifacts.

Parameters:

feature_idstring*

Feature identifier

rootstring*

Project root path

Specification Pipeline

Tools for generating specifications, plans, and tasks.

generate_spec

Create a specification artifact for the provided feature description.

Parameters:

feature_namestring*

Feature name

descriptionstring*

Feature description

feature_idstring

Feature identifier

rootstring

Project root path

saveboolean

Save to file

generate_plan

Render an implementation plan using the previously generated spec.

Parameters:

feature_idstring*

Feature identifier

tech_contextstring

Technical context

rootstring

Project root path

saveboolean

Save to file

generate_tasks

Create a TDD-oriented task list from the existing plan.

Parameters:

feature_idstring*

Feature identifier

rootstring

Project root path

saveboolean

Save to file

Task Management

Tools for managing and tracking task execution.

manage_project_tasks

Comprehensive project task management with dependencies and progress tracking.

Parameters:

actionstring*

Action to perform

feature_idstring

Feature identifier

task_idstring

Task identifier

descriptionstring

Task description

prioritynumber

Task priority

statusstring

Task status

list_tasks

Return the task checklist for a feature, including completion state.

Parameters:

feature_idstring*

Feature identifier

rootstring

Project root path

update_task

Update task completion or append notes for execution traceability.

Parameters:

feature_idstring*

Feature identifier

task_idstring*

Task identifier

completedboolean

Task completion status

notestring

Task notes

rootstring

Project root path

Resources

Available resources for accessing project information.

speck-it://features

Resource view exposing generated feature metadata for discovery.

Usage Examples

Basic Workflow

1. Set constitution → 2. Register feature root → 3. Generate spec → 4. Create plan → 5. Generate tasks → 6. Execute tasks

MCP Client Configuration

{
  "mcpServers": {
    "speck-it": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<path-to-repo>/main.py"
      ],
    }
  }
}

Storage Layout

.speck-it/
├── memory/
│   └── constitution.md
├── project_tasks/
│   └── project_tasks.json
├── specs/
│   └── <feature-id>/
|       ├── analysis.json
│       ├── spec.md
│       ├── plan.md
│       ├── tasks.md
│       └── analysis.json
└── state/
    └── <feature-id>_status.json

All artifacts are written under the `.speck-it/` directory by default. Use the `SPECKIT_STORAGE_DIR` environment variable to customize the storage location.