# Available Tools (v1.3.30)

Memory Pickle MCP provides 8 essential tools for streamlined project management and memory storage. The agent uses these automatically - you don't need to call them directly.

## Simplified Design
- **One tool per function** - No redundancy or overlap
- **Smart defaults** - Tools work together automatically
- **Agent-friendly** - Clear, focused functionality
- **Essential only** - Removed rarely-used utilities and diagnostics

## Project Management

### `get_project_status`
**Auto-called at session start**

Shows current project state, task tree, and progress.

```yaml
# Optional parameters:
project_id: "proj_123"  # Defaults to current project
```

Returns:
- Task hierarchy with completion status
- Progress percentages
- Blocked items
- Recent completions
- Critical priority items

### `create_project`
Creates a new project container. **Automatically becomes the current project.**

```yaml
name: "My New Project"
description: "Project description"
```

### `set_current_project`
Switches to a different project.

```yaml
project_id: "proj_123"
```

### `generate_handoff_summary`
Creates session transition summary.

```yaml
format: "detailed"  # or "compact"
```

## Task Management

### `create_task`
Adds a new task to the current project.

```yaml
title: "Implement feature X"
description: "Detailed description"
priority: "high"  # critical, high, medium, low
project_id: "proj_123"  # Optional - uses current project if not specified
```

### `update_task`
**Consolidated tool** - handles completion, progress, notes, and blockers.

```yaml
task_id: "task_123"
completed: true  # Optional - mark complete/incomplete
progress: 75  # Optional - 0-100 percentage
notes: "Almost done"  # Optional - progress notes
blockers: ["Waiting for approval"]  # Optional - list of blockers
```

## Memory Management

### `remember_this`
Stores important information.

```yaml
title: "Important Decision"
content: "We decided to use React instead of Vue"
category: "technical"  # general, technical, business
importance: "high"  # low, medium, high, critical
tags: ["react", "frontend"]
task_id: "task_123"  # Optional link to task
```

### `recall_context`
Searches stored memories.

```yaml
query: "react decision"  # Optional search term
category: "technical"  # Optional filter
tags: ["frontend"]  # Optional filter
limit: 10  # Default 10
```

## Session Management

### `generate_handoff_summary`
Creates session transition summary for continuing work in new chats. **Also serves as clean markdown generator for agents.**

```yaml
format: "detailed"  # or "compact"
project_id: "proj_123"  # Optional: specific project
```

**Note:** This tool returns clean markdown content without MCP wrapper formatting, making it ideal for agents that need to process session data directly.

### `export_session`
Export session data as markdown or JSON for permanent storage.

```yaml
format: "markdown"  # or "json"
include_handoff: true  # Include handoff summary
raw_markdown: false  # If true, returns clean markdown without MCP wrapper
```

**Note:** By default, `export_session` wraps the markdown in MCP response format with helpful instructions. For agents that want to process the markdown directly, use `raw_markdown: true` or use `generate_handoff_summary` for clean markdown.

### `set_current_project`
Switches to a different project when working on multiple things.

```yaml
project_id: "proj_123"
```

## Tool Usage Patterns

**Critical (Auto-triggered):**
- `get_project_status` - Always called at session start
- `create_task` - When user mentions work items
- `update_task` - When user reports progress or completion

**High (Frequently used):**
- `remember_this` - Store important decisions and context
- `recall_context` - Search previous memories and decisions
- `generate_handoff_summary` - Create session transitions

**Medium (As needed):**
- `create_project` - Start new projects (auto-becomes current)
- `set_current_project` - Switch between multiple projects

## Summary of Changes in v1.3.30

**Removed Tools:**
- `toggle_task` → Consolidated into `update_task`
- `update_task_progress` → Consolidated into `update_task`
- `get_tasks` → Functionality covered by `get_project_status`
- `export_to_markdown` → Replaced with `generate_handoff_summary`
- `apply_template` → Removed (rarely used)
- `list_categories` → Removed (redundant with `get_project_status`)

**Enhanced Tools:**
- `update_task` now handles completion, progress, notes, and blockers
- `create_project` automatically sets as current project
- `get_project_status` provides comprehensive project overview