RembrREMBR

MCP Tools Reference

All 98 MCP Tools available to your AI

Core Memory (6 tools)

store_memory

Store a new memory with metadata and category

Parameters:
  • content (required) - The content to remember
  • category (required) - One of 12 categories
  • metadata (optional) - Additional key-value pairs
  • relevance_score (optional) - 0.0-1.0 relevance score

search_memory

Search memories using hybrid text and semantic search

Parameters:
  • query (required) - Search query
  • category (optional) - Category filter
  • limit (optional) - Max results (1-50, default 10)
  • min_similarity (optional) - Minimum score (default 0.7)
  • search_mode (optional) - "hybrid", "semantic", "text", "phrase"
  • metadata_filter (optional) - Filter by metadata fields (e.g., {"topic": "auth"})

get_memory, update_memory, delete_memory, list_memories

CRUD operations for managing memories

Standard operations for retrieving, updating, and deleting individual memories or listing recent ones.

Enhanced Memory (3 tools)

find_similar_memories

Find memories similar to a specific memory using semantic similarity

Great for discovering related context you may have forgotten about.

get_stats, get_embedding_stats

Get memory statistics and usage information

View plan limits, usage percentages, and semantic search status.

Context Management (4 tools)

create_context, list_contexts

Create and manage context workspaces

Organize memories into focused workspaces for specific tasks or topics.

search_context

Search within a specific context using scoped hybrid search

More accurate results when you know the context you're working in.

add_memory_to_context

Link existing memories to contexts (many-to-many)

Memories can be in multiple contexts for flexible organization.

Snapshots & Temporal (8 tools)

create_snapshot, get_snapshot, list_snapshots

Create immutable snapshots for time-travel debugging

Perfect for understanding what an agent knew at a specific point in time.

create_temporal_snapshot, list_temporal_snapshots

Named snapshots for fast temporal queries

Create checkpoints at important moments for later analysis.

search_at_time, get_memory_history, compare_snapshots

Query memories as they existed at specific times

Debug decisions: "What did the agent know when it chose X?"

Graph Analytics (4 tools)

get_memory_graph

Get relationship graph for a context

Visualize how memories connect to each other.

detect_contradictions

Find contradicting memory pairs within a context

Identify inconsistencies in stored information.

get_context_insights, classify_query_intent

Get insights and classify query intent

Pre-compiled analytics and AI-powered query classification.

Context Intelligence (3 tools)

infer_memory_relationships

Infer semantic relationships for a specific memory

Automatically discover how memories relate to each other.

enhanced_search

Smart search with intent classification and relationship expansion

Get better results by understanding query intent and following relationships.

get_memory_insights

Get insights about memory patterns and relationships

Understand how a specific memory fits into your knowledge graph.

Advanced Analytics (4 tools)

detect_memory_contradictions

Detect contradictions with confidence scoring

generate_context_graph

Generate interactive context graph with clusters

generate_memory_insights

Generate insights about memory usage patterns

get_predictive_analytics

Forecast memory growth and quality trends

Personal Memory (2 tools)

set_memory_visibility

Change visibility scope (personal, shared, project)

list_personal_memories

List personal memories for current user only

Causal Reasoning (4 tools)

trace_causality

Trace causal reasoning chain from a memory

Critical for RLM debugging: understand why an agent made a decision.

infer_causality

Infer causal relationship between two memories

get_causal_links, validate_causal_link

Get and validate causal relationships

Audit & Compliance (3 tools)

query_audit_log

Query audit logs with filters

generate_compliance_report

Generate SOC2/compliance audit report

get_audit_stats

Get audit logging statistics and health metrics

Attachments (5 tools)

upload_attachment

Upload a file attachment to a memory (images, documents, PDFs, etc.)

list_attachments

List all file attachments for a memory

get_attachment_url

Get a presigned download URL for an attachment (time-limited)

delete_attachment

Delete a file attachment (only the owner can delete)

get_storage_usage

Get storage usage statistics for the current tenant (used bytes, file count, quota)

Task Management (4 tools)

manage_task

Task CRUD and assignment. Operations: create, get, update, delete, list, assign.

task_state

Task state machine. State flow: pending → in_progress → blocked / completed / failed; blocked → in_progress / failed.

task_dependencies

Task dependency DAG management with cycle detection. Operations: add, remove, blocked_by, blocking, all.

task_search

Task search, filter, and aggregation. Operations: search (full-text), filter (by status/assignee/tag), aggregate (counts by status/assignee).

RLM Session Tools (4 tools)

rlm_session

Manage Ralph-RLM sessions: create with acceptance criteria and plan, get or list sessions, update status, export/import full session state.

rlm_evaluate_ac

Evaluate acceptance criteria for an RLM session. Provide pass/fail status and evidence for each criterion. Session auto-completes when all AC are met or skipped.

rlm_iteration

Track RLM iteration cycles: start a new iteration with plan and approach, or complete an existing one with outcomes and findings.

rlm_regenerate

Request plan regeneration for a stuck RLM session. Provide the reason, evidence of being stuck, failed approaches, and constraints for the new plan.

PII & Privacy (4 tools)

pii

Detect, redact, and audit personally identifiable information (PII) in memories. Supports email, phone, SSN, credit card, and more. Operations: detect, redact, audit, compliance_report, batch_scan.

pii_nlp_detect

Detect PII using combined pattern + NLP heuristic engine. Supports 21 PII types including person names and org names beyond regex patterns.

pii_nlp_redact

Detect and redact PII from text. Four redaction modes: mask (***), hash ([TYPE_REDACTED]), label ([TYPE]), or remove.

pii_nlp_score

Quickly score text for PII risk (0.0–1.0). Useful for filtering or ranking without running full detection.

Enhanced Snapshots (4 tools)

snapshot_timeline

Get a chronological timeline of context snapshots showing how memory evolved over time, with adjacent snapshot deltas.

snapshot_diff

Diff two named snapshots: see memory delta, growth %, and categories added, removed, or changed between them.

snapshot_nearest

Find the nearest snapshot to a given timestamp. Returns the snapshot plus distance in seconds and direction (before/after).

snapshot_category_evolution

Track how each memory category evolved across all snapshots, showing per-snapshot counts for every category.

Reporting & Analytics (6 tools)

get_usage_analytics

Time-series breakdown of memory and search usage: memories stored, searches performed, tool calls, and PII detections grouped by hour/day/week/month.

get_performance_metrics

Performance metrics over time: average and p95 latency for store_memory and search_memory, tool call counts, and error rates.

get_memory_growth

Memory growth statistics for a time window: start/end counts, net change, growth rate %, and average per-day.

get_category_breakdown

Breakdown of stored memories by category: count, percentage of total, PII count, and average content length per category.

get_pii_analytics

PII analytics: total memories, PII count and percentage, breakdown by PII type (email/phone/etc.) and category.

build_report

Custom report builder. Assemble a report from selected metrics (usage, performance, growth, categories, pii_summary) for a time range, with export in JSON, CSV, or Markdown.

Extended Audit Tools (6 tools)

audit_health

Real-time audit health dashboard: current metrics (failure rate, event rate, denied count), active alerts, and system health status.

audit_metrics

Current audit metrics snapshot: event counts, failure/error rates, events/min, unique users, and top event types.

audit_alerts

List active or historical alerts. Operations: active (currently firing), history (resolved alerts with timestamps).

audit_evaluate_thresholds

Evaluate all alert thresholds against current metrics. Returns any fired alerts using built-in thresholds.

audit_anomaly_detect

Run anomaly detection on recent audit events. Returns anomaly score (0–1), risk level (low/medium/high/critical), and detected patterns.

audit_metrics_prometheus

Export current audit metrics in Prometheus text format for scraping by monitoring systems.

Utility Tools (7 tools)

filter_memories

Advanced memory filtering with date range, multi-category, metadata conditions, content length, and PII flag filters. Returns paginated results.

export_memories

Export filtered memories to JSON, CSV, or Markdown. Supports the same filter options as filter_memories.

batch_memories

Batch operations on a filtered set of memories: delete or update (category/metadata) all matching memories in one call.

saved_searches

Manage saved search queries: save a filter for reuse, list saved searches, or execute a saved search by name.

work_queue

Multi-agent work queue with priority scheduling and handoff payloads. Operations: enqueue, claim, complete, fail, peek, stats.

gdpr

GDPR compliance tools: right to erasure (forget-me), data retention policies, consent audit trail, and data export for data subject access requests.