// MCP TOOL REFERENCE

FORGETFUL TOOLS

59 tools from the Forgetful MCP Server, categorised by risk level.

// ALL 59 FORGETFUL TOOLS

READ 21 tools

Read get_code_artifact Retrieve code artifact by ID with complete details. WHEN: You need the full code implementation an... Read get_current_user Returns information about the current user **WHAT**: Returns information about the current authent... Read get_document Retrieve document by ID with complete content. WHEN: You need the full document content and metada... Read get_entity Retrieve entity by ID with complete details. WHEN: You need the full entity information for a spec... Read get_entity_memories get_entity_memories Read get_entity_relationships get_entity_relationships Read get_memory Retreive complete memory details by ID WHEN: You require the full details of a specific memory and... Read get_project get_project Read get_recent_memories Retrieve most recent memories by creation timestamp WHEN: You want to see what was recently learne... Read get_skill Retrieve skill by ID with complete content. WHAT: Returns the full skill including markdown conten... Read how_to_use_forgetful_tool Get detailed documentation for a specific tool Returns complete documentation including JSON schem... Read list_code_artifacts list_code_artifacts Read list_documents list_documents Read list_entities List entities with optional filtering. WHEN: Browsing entities, filtering by project/type/tags, or... Read list_projects list_projects Read list_skills list_skills Read query_memory query_memory Read search_entities search_entities Read search_skills search_skills Read discover_forgetful_tools Placeholder - set dynamically below Read export_skill Export a skill to Agent Skills markdown format (SKILL.md). WHAT: Generates a standards-compliant S...

WRITE 29 tools

Write link_memories Manually create bidirectional links between memories WHEN: You or the user decide that a memory wa... Write create_code_artifact create_code_artifact Write create_document create_document Write create_entity create_entity Write create_entity_relationship create_entity_relationship Write create_memory create_memory Write create_project create_project Write create_skill create_skill Write import_skill import_skill Write link_entity_to_memory Link entity to memory (establishes reference relationship). WHEN: When a memory mentions or relate... Write link_entity_to_project Link entity to project (organizational grouping). WHEN: When an entity belongs to or is relevant t... Write link_skill_to_code_artifact Link skill to code artifact (establishes reference relationship). WHAT: Creates an association bet... Write link_skill_to_document Link skill to document (establishes reference relationship). WHAT: Creates an association between ... Write link_skill_to_file Link skill to file (establishes reference relationship). WHAT: Creates an association between a sk... Write link_skill_to_memory Link skill to memory (establishes reference relationship). WHAT: Creates a bidirectional associati... Write unlink_entity_from_memory Unlink entity from memory (removes reference relationship). WHEN: When an entity-memory link is no... Write unlink_entity_from_project Unlink entity from project (removes organizational grouping). WHEN: When an entity-project associa... Write unlink_skill_from_code_artifact Unlink skill from code artifact (removes reference relationship). WHAT: Removes the association be... Write unlink_skill_from_document Unlink skill from document (removes reference relationship). WHAT: Removes the association between... Write unlink_skill_from_file Unlink skill from file (removes reference relationship). WHAT: Removes the association between a s... Write unlink_skill_from_memory Unlink skill from memory (removes reference relationship). WHAT: Removes the association between a... Write update_code_artifact update_code_artifact Write update_document update_document Write update_entity update_entity Write update_entity_relationship Update entity relationship (PATCH semantics - only provided fields changed). WHEN: Refining relati... Write update_memory update_memory Write update_project update_project Write update_skill update_skill Write update_user_notes Update the notes field for the current user **WHAT**: Updates the notes/metadata field for the aut...

DESTRUCTIVE 7 tools

Destructive delete_code_artifact Delete code artifact (cascades memory associations). WHEN: Removing obsolete, incorrect, or no-lon... Destructive delete_document Delete document (cascades memory associations). WHEN: Removing obsolete, incorrect, or no-longer-r... Destructive delete_entity Delete entity (cascade removes memory links and relationships). WHEN: Removing obsolete or incorre... Destructive delete_entity_relationship Delete entity relationship (removes knowledge graph edge). WHEN: Removing obsolete or incorrect re... Destructive delete_project delete_project Destructive delete_skill Delete skill (cascades memory and artifact associations). WHAT: Permanently removes a skill and it... Destructive mark_memory_obsolete Mark a memory as obsolete (soft delete for audit trail) WHEN: Memory is outdated, contradicted by ...

EXECUTE 2 tools

Execute execute_forgetful_tool Placeholder - set dynamically below Execute rebuild_embeddings Rebuild embeddings for a user-scoped subset of memories (issue #39). WHEN: A small set of memories...

// FAQ

How many tools does the Forgetful MCP server have? +

The Forgetful MCP server exposes 59 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Forgetful tools? +

Route the Forgetful server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Forgetful tools fall into? +

Forgetful tools are categorised as Read (21), Write (29), Destructive (7), Execute (2). Each category has a recommended default policy.

Enforce policy on every Forgetful tool call.

Deterministic rules across all 59 Forgetful tools. Per-identity grants. Full audit log. Live in minutes. Nothing to install.

GOVERN FORGETFUL →

Free to start. No card required.

42,500+ MCP servers and 110,000+ tools scanned and risk-classified.