Tool Reference
Complete reference for all 13 Scope MCP tools.
All tools accept an optional project_id parameter. If omitted, Scope uses your most recent project.
Core Workflow
start_ticket
Start here. One call to get the next ticket, set it to in_progress, and receive entity context + learnings + git workflow.
| Parameter | Type | Description |
|---|---|---|
detail_level | string | minimal | standard (default) | full |
project_id | string | Optional project ID |
complete_ticket
Mark a ticket as done and log work.
| Parameter | Type | Description |
|---|---|---|
summary | string | Work summary |
files_created | string[] | Files created |
files_modified | string[] | Files modified |
learnings | object[] | Patterns and gotchas discovered |
skip | boolean | Skip ticket (already done) |
skip_reason | string | Why ticket was skipped |
Context & Search
get_context
Unified context retrieval. Comma-separate scopes for multiple.
| Parameter | Type | Description |
|---|---|---|
scope | string | summary, all, implementation,requirements, entities, entities:User+Card,tech_stack, api_design, pages,flows, schema |
Example: get_context(scope: "entities:User+Order,tech_stack")
search
Semantic search across project context and learnings.
| Parameter | Type | Description |
|---|---|---|
query | string | Search query |
type | string | context | learnings | all |
max_tokens | number | Token budget for results |
Ticket Management
update_ticket
Unified ticket updates via action parameter.
| Action | Parameters |
|---|---|
set_status | status: backlog | ready | in_progress | review | done |
block | reason, blocker_type |
unblock | blocker_id |
update_pr | branch_name, pr_url |
review_milestone
Analyze gaps in a milestone and suggest missing tickets.
Project & Learning
list
Unified listing by type.
| Type | Description |
|---|---|
projects | All your projects |
milestones | Project milestones |
tickets | Milestone tickets (pass ticket_id for full detail on a single ticket) |
blockers | Blocked tickets |
work | Work log entries |
work_summary | Aggregated work summary |
patterns | Captured patterns and learnings |
save_learning
Capture patterns, decisions, gotchas, and conventions for future reference.
| Parameter | Type | Description |
|---|---|---|
content | string | Learning content |
memory_type | string | pattern | gotcha | decision | convention |
learnings | object[] | Batch learnings |
decisions | object[] | Architectural decisions |
Analysis
analyze
Unified analysis by type.
| Type | Description |
|---|---|
dependencies | Dependency graph for a ticket |
validate_deps | Check for cycles and dangling references |
dependents | Find tickets that depend on this one |
impact | Impact analysis for a ticket |
generate_change_set | Preview cascading changes |
approve_changes | Approve proposed changes |
apply_changes | Apply approved changes |
generate_feature | Describe a feature in natural language, get a preview of proposed tickets |
apply_feature | Create approved tickets from a feature preview |
Feature generation flow
Two-step preview-then-apply workflow. Describe a feature, review the proposed tickets, then create only the ones you approve.
// Step 1: Generate a preview (tickets NOT yet created)
analyze(type: "generate_feature", description: "Add Facebook OAuth login")
→ Returns preview_id, proposed tickets, affected existing tickets, milestone detection
// Step 2: Apply approved tickets
analyze(type: "apply_feature", preview_id: "fp_xxx", approvals: { "0": true, "1": false })
→ Creates approved tickets, updates affected tickets| Parameter | Used by | Description |
|---|---|---|
description | generate_feature | Feature description in natural language |
milestone_id | generate_feature | Optional hint for target milestone |
preview_id | apply_feature | Preview ID from generate_feature |
approvals | apply_feature | Map of ticket index to boolean (default: all approved) |
Project Setup
scope_discover
List projects and readiness status. With project_id: deep overview with milestones, tickets, sync status.
scope_init
Create a new project. Returns project_id + next action.
scope_sync
Bulk-sync local files to a project. Runs full V3 analysis (AST, schema, LLM). Incremental — skips unchanged files.
scope_sync_status
Poll background sync progress. Returns next action guiding through review when complete.
Detail levels
| Level | Tokens | Use case |
|---|---|---|
minimal | ~100 | Quick checks, simple tickets |
standard | ~400 | Default — includes related entities and patterns |
full | ~8K | Deep inspection — all 31 fields |