memento_set_project_state · Memento MCP: Risk & Policy

WHAT IT DOES

What memento_set_project_state does on Memento

AI agents use memento_set_project_state to create or update resources in Memento — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Memento environment.

WHY IT NEEDS A POLICY

Why memento_set_project_state needs a policy

This tool creates or modifies project state data without permanently deleting it. The deprecation notice does not change its functional category. While it affects project planning and decision-making (hence medium severity), it remains a Write operation: changes are reversible and the blast radius is limited to project metadata rather than system-critical or financial operations.

From the tool's definition Tool description states 'Set a project state field' with fields like vision, milestones, blockers, tech_debt, decisions, current_sprint—all operations that modify project data reversibly.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

memento_set_project_state Rate-limited

memento_set_project_state stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

View as policy code

policy.json

{
  "version": "1",
  "default": "deny",
  "tools": {
    "memento_set_project_state": {
      "limits": [
        {
          "counter": "memento_set_project_state_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

LIMIT THIS TOOL →

Instant setup, no code required.

PolicyLayer is an MCP gateway: every tool call is checked against your rule before it reaches Memento, so you can run agents against it safely.

FAQ

Questions about memento_set_project_state

What does the memento_set_project_state tool do? +

[DEPRECATED] Set a project state field. Use for vision, milestones, blockers, tech_debt, decisions, current_sprint. It is categorised as a Write tool in the Memento MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on memento_set_project_state? +

Register the Memento MCP server in PolicyLayer and add a rule for memento_set_project_state: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Memento. Nothing to install.

What risk level is memento_set_project_state? +

memento_set_project_state is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit memento_set_project_state? +

Yes. Add a rate_limit block to the memento_set_project_state rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block memento_set_project_state completely? +

Set action: deny in the PolicyLayer policy for memento_set_project_state. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides memento_set_project_state? +

memento_set_project_state is provided by the Memento MCP server (joyciakira/memento). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.