MCP Tools Reference

Your AI assistant calls these tools automatically. This reference is useful for understanding what's available, debugging, or writing custom strategies.

💡 Full schema via MCP: Ask your AI: "List all available Engrams tools and their parameters." It will call get_engrams_schema() and return live documentation.

Core Context

ToolDescription
get_product_contextRetrieve the project's product context document
update_product_contextOverwrite or patch the product context
get_active_contextRetrieve the current active context document
update_active_contextOverwrite or patch the active context
get_item_historyRetrieve version history for product or active context

Decisions

ToolDescription
log_decisionRecord a new decision with summary, rationale, and tags
get_decisionsList decisions with optional tag and limit filters
search_decisions_ftsFull-text search across decision fields
delete_decision_by_idDelete a decision by its ID

Progress

ToolDescription
log_progressCreate a new progress/task entry
get_progressList progress entries with optional status and parent filters
update_progressUpdate the status or description of an existing entry
delete_progress_by_idDelete a progress entry

System Patterns

ToolDescription
log_system_patternDocument a new architectural or design pattern
get_system_patternsList patterns with optional tag filters
delete_system_pattern_by_idDelete a pattern by ID

Custom Data

ToolDescription
log_custom_dataStore arbitrary category/key/value data
get_custom_dataRetrieve custom data by category and key
delete_custom_dataDelete a custom data entry
search_custom_data_value_ftsFull-text search across custom data values
search_project_glossary_ftsFTS scoped to the ProjectGlossary category

Relationships

ToolDescription
link_engrams_itemsCreate a typed relationship between two items
get_linked_itemsRetrieve all items linked to a given item

Governance

ToolDescription
create_scopeCreate a governance scope (team or individual)
get_scopesList all scopes
log_governance_ruleLog a governance rule within a scope
get_governance_rulesRetrieve governance rules
check_complianceCheck whether a proposed decision conflicts with rules
get_scope_amendmentsList amendment proposals
review_amendmentApprove or reject an amendment
get_effective_contextMerged team + individual context for a scope

Codebase Bindings

ToolDescription
bind_code_to_itemBind a glob path pattern to a decision or pattern
get_bindings_for_itemList all bindings for an item
get_context_for_filesRetrieve all context bound to given file paths
verify_bindingsCheck all bindings for path validity
get_stale_bindingsList bindings pointing to non-existent paths
suggest_bindingsAuto-propose bindings based on pattern analysis
unbind_code_from_itemRemove a binding by ID

Context Budgeting

ToolDescription
get_relevant_contextRetrieve scored, budget-aware context for a query
estimate_context_sizeEstimate token usage for a retrieval
get_context_budget_configView current budget settings
update_context_budget_configAdjust token budget and scoring weights

Onboarding

ToolDescription
get_project_briefingGenerate a structured project briefing
get_briefing_stalenessCheck which briefing sections are out of date
get_section_detailDrill into a specific briefing section

Utilities

ToolDescription
get_recent_activity_summarySummary of recent database activity
get_engrams_schemaReturn live tool schema documentation
export_engrams_to_markdownExport all knowledge to markdown files
import_markdown_to_engramsImport knowledge from a markdown export directory
batch_log_itemsLog multiple items of the same type in one call
get_workspace_detection_infoReturn auto-detected workspace path and details