waypath_promote

WRITE: submit a candidate for promotion into the Waypath truth-kernel. Creates a new candidate row in the local SQLite review queue — it does NOT promote immediately. A human (or agent with explicit authority) must call waypath_review to accept or reject the candidate before it becomes queryable ...

Server Waypath thestack-ai/waypath
Category Write
Risk class Medium
Parameters 00 required

What waypath_promote does on Waypath

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

Why waypath_promote needs a policy

An AI agent can call waypath_promote faster than any human can review — one bad instruction and it creates or modifies resources in Waypath by the hundred, each call as confident as the last.

Questions about waypath_promote

What does the waypath_promote tool do? +

WRITE: submit a candidate for promotion into the Waypath truth-kernel. Creates a new candidate row in the local SQLite review queue — it does NOT promote immediately. A human (or agent with explicit authority) must call waypath_review to accept or reject the candidate before it becomes queryable by waypath_recall. Use when you want to persist a decision, preference, or fact; use waypath_review_queue to list pending candidates and waypath_review to act on them. It is categorised as a Write tool in the Waypath MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on waypath_promote? +

Register the Waypath MCP server in PolicyLayer and add a rule for waypath_promote: 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 Waypath. Nothing to install.

What risk level is waypath_promote? +

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

Can I rate-limit waypath_promote? +

Yes. Add a rate_limit block to the waypath_promote 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 waypath_promote completely? +

Set action: deny in the PolicyLayer policy for waypath_promote. 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 waypath_promote? +

waypath_promote is provided by the Waypath MCP server (thestack-ai/waypath). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.