MCP Tools - 3ngram

3ngram’s MCP server provides 32 tools, 10 prompt templates, and 17 resources for AI assistants to interact with the knowledge base.

Surface refactor: Many read-only tools have been replaced by MCP resources (engram:// URIs). The old tool names still work but are deprecated. recall is now search_memories and search is now search_content.

Tool catalog

Tool	Purpose	R/W	Status
`remember`	Persist a structured memory with type, scope, project, due date	Write	Active
`search_memories`	Retrieve memories by semantic similarity	Read	Active
`get_memories`	Fetch full memory content by IDs	Read	Active
`resolve`	Mark a memory as resolved with optional note	Write	Active
`search_content`	Hybrid semantic + BM25 search across content chunks (auto-reindexes stale sources)	Read	Active
`reindex`	Re-index markdown content into content chunks	Write	Active
`reclassify_memory`	Change the type of a memory	Write	Active
`batch_reclassify`	Bulk-reclassify multiple memories to a new type	Write	Active
`archive_memories`	Archive resolved or stale memories by ID	Write	Active
`configure_scope`	Assign a project to a scope (work/personal)	Write	Active
`reapply_scope_mappings`	Reapply scope mappings to existing memories	Write	Active
`unresolve`	Reopen a resolved memory	Write	Active
`sync_source`	Trigger re-sync for a content source	Write	Active
`docs_create`	Create a new Google Doc with optional initial content	Write	Active
`docs_export`	Export a Google Doc as plain text by document ID	Read	Active
`propose_action`	Propose an external action for user approval	Write	Active
`decide_action`	Approve or reject a pending action, executing on approval	Write	Active
`set_preference`	Set a user preference key-value pair	Write	Active
`create_prompt`	Create a custom prompt template	Write	Active
`update_prompt`	Update an existing custom prompt	Write	Active
`delete_prompt`	Delete a custom prompt	Write	Active
`create_schedule`	Create a cron-based agent schedule	Write	Active
`update_schedule`	Update an existing schedule	Write	Active
`delete_schedule`	Delete a schedule	Write	Active
`create_trigger`	Create an event-based trigger	Write	Active
`update_trigger`	Update an existing trigger	Write	Active
`delete_trigger`	Delete a trigger	Write	Active
`list_templates`	List available agent templates, optionally filtered by category	Read	Active
`install_template`	Install a curated agent template (bundles prompts, triggers, schedules)	Write	Active
`uninstall_template`	Remove an installed agent template and its resources	Write	Active
`recall`	Alias for `search_memories`	Read	Deprecated
`search`	Alias for `search_content`	Read	Deprecated
`commitments`	List open commitments	Read	Deprecated (use `engram://commitments` resource)
`blockers`	List open blockers	Read	Deprecated (use `engram://blockers` resource)
`overdue`	List commitments past their deadline	Read	Deprecated (use `engram://overdue` resource)
`stale_commitments`	List commitments with no activity for N+ days	Read	Deprecated (use `engram://stale` resource)
`status`	Index statistics and memory breakdown	Read	Deprecated (use `engram://status` resource)
`list_sources`	List connected content sources	Read	Deprecated (use `engram://sources` resource)
`list_pending_actions`	List actions by status and provider	Read	Deprecated (use `engram://actions/pending` resource)
`get_preference`	Retrieve a preference by key	Read	Deprecated (use `engram://preferences/{key}` resource)
`list_preferences`	List all active user preferences	Read	Deprecated (use `engram://preferences` resource)
`list_prompts`	List all custom prompts	Read	Deprecated (use `engram://prompts` resource)
`get_prompt`	Get full details of a custom prompt	Read	Deprecated (use `engram://prompts` resource)
`list_schedules`	List all schedules	Read	Deprecated (use `engram://schedules` resource)
`list_triggers`	List all triggers	Read	Deprecated (use `engram://triggers` resource)
`suggested_context`	Surface recently active context	Read	Deprecated (use `engram://suggested-context` resource)
`suggest_reclassifications`	Find misclassified memories	Read	Deprecated (use MCP prompt)
`triage_stale`	Surface stale memories with prompts	Read	Deprecated (use MCP prompt)
`handoff`	Export session context as JSON	Read	Deprecated (use MCP prompt)
`compile_context`	Compile task-relevant context	Read	Deprecated (use MCP prompt)
`get_schedule_history`	Query past schedule runs	Read	Deprecated (use `engram://schedules/{name}/history` resource)
`get_trigger_history`	Query trigger evaluations	Read	Deprecated (use `engram://triggers/{name}/history` resource)

MCP resources

Resources are read-only data exposed via engram:// URIs. Clients that support MCP resources can read these directly instead of calling tools.

Resource URI	Purpose
`engram://status`	Index statistics and memory breakdown
`engram://sources`	Connected content sources
`engram://preferences`	All active user preferences
`engram://schedules`	All agent schedules
`engram://triggers`	All agent triggers
`engram://prompts`	All custom prompt templates
`engram://actions/pending`	Pending agent actions
`engram://commitments`	Open commitments
`engram://blockers`	Open blockers
`engram://overdue`	Overdue commitments
`engram://stale`	Stale commitments
`engram://suggested-context`	Recently active and revisit-worthy context
`engram://memories/{id}`	Full content of a single memory
`engram://preferences/{key}`	A single preference by key
`engram://schedules/{name}/history`	Past runs for a schedule
`engram://triggers/{name}/history`	Evaluation history for a trigger

Key parameters

remember

Parameter	Type	Required	Description
`topic`	string	Yes	Short identifier for the memory
`content`	string	Yes	Full memory content
`memory_type`	string	No	`decision`, `commitment`, `blocker`, `preference`, `pattern`, `context`
`project`	string	No	Project tag
`scope`	string	No	`work` or `personal`
`due_date`	string	No	ISO date for commitments
`status`	string	No	`open`, `waiting`, `scheduled`

search_memories (formerly recall)

Parameter	Type	Required	Description
`topic`	string	Yes	Search query
`brief`	boolean	No	Compact one-line-per-memory format
`limit`	integer	No	Max results (default 10)
`memory_type`	string	No	Filter by type
`project`	string	No	Filter by project
`scope`	string	No	Filter by scope
`source`	string	No	Filter by source (`manual`, `hook`, `auto`)

resolve

Parameter	Type	Required	Description
`memory_id`	integer	Yes	Memory to resolve
`resolution`	string	No	What happened

Output format

All MCP tools return human-readable formatted strings, not structured JSON. These outputs are optimized for LLM consumption. Do not rely on stable parsing of the text format.

Example commitments output:

Open Commitments (3):
  [122] Implement memory consolidation UI (5 days) [project: engram]
  [125] Write integration tests for OAuth flow (3 days) [project: engram]
  [131] Review Cursor MCP configuration (1 day) [project: my-project]

Progressive disclosure

Use search_memories(brief=True) to scan, then get_memories(ids=[...]) to read details. This keeps token usage low when browsing large memory sets.

Auto-consolidation

When remember finds a sufficiently similar existing memory, it merges instead of creating a duplicate. Consolidation uses advisory locks to prevent race conditions.

Overview

​Tool catalog

​MCP resources

​Key parameters

​remember

​search_memories (formerly recall)

​resolve

​Output format

​Progressive disclosure

​Auto-consolidation

Tool catalog

MCP resources

Key parameters

remember

search_memories (formerly recall)

resolve

Output format

Progressive disclosure

Auto-consolidation