SpecMem Command → Tool Mapping

Maps SpecMem commands to their corresponding MCP tools for quick reference.

Quick reference mapping all SpecMem commands to their corresponding MCP tools and resources.


Commands Summary Table

#CommandPrimary ToolSecondary ToolsRequired Args
1/specmem-findmcp__specmem__find_memoryN/Aquery (2+ words)
2/specmem-statsmcp__specmem__show_me_the_statsN/Anone (optional: memory, codebase, team-members)
3/specmem-drilldownmcp__specmem__find_memorymcp__specmem__spawn_research_teamMemberquery (start or auto mode)
4/specmem-changesFile change history trackerN/Anone (optional: --limit, --path, --type)
5/specmem-hooksHook managerN/Asubcommand (list, add, remove, enable, disable, deploy, scan, example, status)
6/specmem-codemcp__specmem__find_code_pointersN/Aquery (code search)
7/specmem-remembermcp__specmem__save_memoryN/Acontent (required)
8/specmem-pointersmcp__specmem__find_code_pointersN/Aquery (semantic code search)
9/specmem-configteammembercommsAskUserQuestion + Hook/HTTP ConfigN/Anone (interactive selection)
10/specmemmcp__specmem__send_team_message + mcp__specmem__read_team_messagesTask toolaction (deploy, list, memory, codebase)
11/specmem-getdashboardConfiguration readerN/Anone
12/specmem-team-memberHTTP API endpoints + Task toolmcp__specmem__send_team_messageaction (deploy, list, help)
13/specmem-autoclaudemcp__specmem__find_memory + ExplorationTodoWritetask description
14/specmem-serviceService mode selectormcp__specmem__show_me_the_stats, HTTP API, PostgreSQLnone (interactive selection)

Detailed Command-Tool Mapping

Memory Operations

1. /specmem-find - Semantic Memory Search

Primary Tool:   mcp__specmem__find_memory
Parameters:     query, limit, threshold, memoryTypes, tags, dateRange

Search stored memories using semantic similarity. Core search capability for all memory-based queries.

7. /specmem-remember - Store Memories

Primary Tool:   mcp__specmem__save_memory
Parameters:     content, memoryType, importance, tags

Persist information to SpecMem's memory system with optional metadata.

2. /specmem-stats - Memory & Codebase Statistics

Primary Tool:   mcp__specmem__show_me_the_stats
Parameters:     (optional filters for memory/codebase/team-members)

View aggregated statistics about stored memories, indexed code, and active team members.


Code Search & Analysis

6. /specmem-code - Codebase Search

Primary Tool:   find_code_pointers (via mcp__specmem__find_code_pointers)
Parameters:     query, semantic, fileTypes, paths, limit
Secondary:      None

Search indexed codebase using semantic or text-based search.

8. /specmem-pointers - Semantic Code Search with Tracebacks

Primary Tool:   mcp__specmem__find_code_pointers
Parameters:     query, limit, galleryMode, includeTracebacks

Find code by semantic meaning and show what files use/import it (tracebacks).

4. /specmem-changes - File Change History

Primary Tool:   File change tracker (database)
Parameters:     limit, filePath, changeType

View recent file changes (add, modify, delete) with timestamps and content diffs.


Advanced Workflows

3. /specmem-drilldown - Interactive Memory Retrieval

Primary Tool:   mcp__specmem__find_memory
Secondary:      mcp__specmem__spawn_research_teamMember
Modes:          start (interactive), auto (automatic)
Flow:
  1. Initial search: find_memory
  2. User controls depth and filtering
  3. Optional: spawn_research_teamMember for web research

User-controlled drilldown for gathering curated context on complex topics.

13. /specmem-autoclaude - Autonomous Task Execution

Primary Tool:   mcp__specmem__find_memory
Secondary:      TodoWrite, Glob, Grep, Read, Edit, Bash

Execute tasks autonomously with memory-driven context gathering and knowledge capture.


Team Member Operations

10. /specmem - Main Command Interface

Primary Tools:
  - mcp__specmem__send_team_message (team communication)
  - mcp__specmem__read_team_messages (listen for updates)
  - Task tool (deploy team members)
Subcommands:
  - deploy "<mission>"     (Task tool + team comms)
  - list                   (mcp__specmem__getActiveTeamMembers)
  - memory store/search    (mcp__specmem__save_memory / mcp__specmem__find_memory)
  - codebase search        (mcp__specmem__find_code_pointers)

Central hub for team member deployment and memory/codebase commands.

12. /specmem-team-member - Team Member Deployment

Primary Tools:
  - Task tool (deploy team members)
  - HTTP API endpoints (team member communication)
Secondary:
  - mcp__specmem__send_team_message (optional monitoring)
Communication Mode: HTTP API (curl commands in spawned team members)

Deploy coordinated multi-team member swarms with Overseer, Workers, and Helpers.

9. /specmem-configteammembercomms - Team Member Communication Config

Tool Type:      Configuration + Interactive Selection
Methods:
  - Hook mode:      PreToolUse hook injects MCP proxy
  - HTTP mode:      Manual curl commands
  - Test both:      Validate which mode works

Configure how subteam members communicate with SpecMem (Hook vs HTTP).


System & Configuration

11. /specmem-getdashboard - Dashboard Information

Tool Type:      Configuration Reader
Sources:
  - .specmem/ports.json (port number)
  - SPECMEM_DASHBOARD_MODE env var (public/private)
Output:         Dashboard URL and access information

Display dashboard location, port, and access mode.

14. /specmem-service - Service Mode Selector

Tool Type:      Service Mode Selector
Available Modes:
  1. Native MCP:    mcp__specmem__show_me_the_stats
  2. HTTP API:      curl to http://localhost:8595
  3. Direct DB:     PostgreSQL connection
  4. Auto-detect:   Try MCP → HTTP → DB

Choose between MCP, HTTP, or database access modes for SpecMem operations.

5. /specmem-hooks - Custom Hook Management

Tool Type:      Hook Manager
SubCommands:
  - list           (show registered hooks)
  - add <file>     (register new hook)
  - remove <name>  (unregister hook)
  - enable/disable (toggle hook state)
  - deploy         (push hooks to Claude)
  - scan           (find new hooks)
  - example        (create template hook)
  - status         (show system status)

Manage custom pre/post-tool hooks and deployment to Claude.


Communication Patterns

MCP Tool Patterns

Direct MCP Tools Used:

  • mcp__specmem__find_memory - All memory search operations
  • mcp__specmem__save_memory - Store information
  • mcp__specmem__show_me_the_stats - System statistics
  • mcp__specmem__find_code_pointers - Code search/analysis
  • mcp__specmem__spawn_research_teamMember - Web research
  • mcp__specmem__send_team_message - Team communication
  • mcp__specmem__read_team_messages - Listen for team updates

Indirect Access (via HTTP/Config):

  • Database queries (for team member sessions, memories)
  • HTTP API endpoints (for subteam member communication)
  • Hook system (PreToolUse/PostToolUse injection)

Team Member Communication

Modes:

ModeMechanismUsed InNotes
Native MCPMCP toolsMain contextRequires tool permissions
HTTP APIcurl commandsSubteam membersWorks everywhere, auth required
Hook ModePreToolUse injectionOptional enhancementAuto-injects HTTP proxy

Command Dependency Graph

┌─────────────────────────────────────────────────────────────┐
│                    CORE MEMORY LAYER                        │
│  /specmem-find ──────> mcp__specmem__find_memory            │
│  /specmem-remember ──> mcp__specmem__save_memory            │
│  /specmem-stats ─────> mcp__specmem__show_me_the_stats      │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                    CODE SEARCH LAYER                        │
│  /specmem-code ──────┐                                      │
│  /specmem-pointers ──> mcp__specmem__find_code_pointers    │
│  /specmem-changes ───>                                      │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                   ADVANCED WORKFLOWS                        │
│  /specmem-drilldown ──> find_memory + spawn_research_tm    │
│  /specmem-autoclaude ─> find_memory + TodoWrite + tools    │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                  TEAM MEMBER OPERATIONS                     │
│  /specmem ──────────┐                                       │
│  /specmem-tm deploy > Task tool + HTTP API + team comms    │
│  /specmem-comms ────┘                                       │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│                  SYSTEM CONFIGURATION                       │
│  /specmem-service ───────> MCP / HTTP / DB selector        │
│  /specmem-hooks ─────────> Hook manager                     │
│  /specmem-getdashboard ──> Config reader                    │
└─────────────────────────────────────────────────────────────┘

Quick Reference by Use Case

Need to Search Memory?

/specmem-find (direct search) → /specmem-drilldown (curated, interactive) → /specmem-autoclaude (with autonomous execution)

Need to Search Code?

/specmem-code (semantic code search) → /specmem-pointers (code + tracebacks) → /specmem-changes (see recent modifications)

Need to Deploy Team Members?

/specmem deploy (shorthand) → /specmem team member deploy (full syntax) → /specmem-team-member deploy (direct command)

Need System Info?

/specmem-stats (memory, code, team stats) → /specmem-getdashboard (dashboard location) → /specmem-service (service availability)

Need to Store Knowledge?

/specmem-remember (save to memory) → /specmem-hooks (custom logic)


Tool Permission Requirements

ToolMCP AccessHTTP AccessDB AccessSubteam Member Access
find_memory✅ Yes✅ Yes✅ YesHTTP only
save_memory✅ Yes✅ Yes✅ YesHTTP only
show_me_the_stats✅ Yes✅ Yes✅ YesLimited
find_code_pointers✅ Yes✅ Yes✅ YesHTTP only
send_team_message✅ Yes✅ Yes✅ Yes (via DB)HTTP only
Task tool✅ YesN/AN/A✅ Yes

Update History

Version 1.0 - January 3, 2026

  • Initial mapping of all 14 commands
  • Complete MCP tool cross-reference
  • Communication patterns documented
  • Dependency graph included