reverse-sync · Kit MCP: Risk & Policy

WHAT IT DOES

What reverse-sync does on Kit

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

WHY IT NEEDS A POLICY

Why reverse-sync needs a policy

The tool writes/synchronizes changes from IDE edits back to a canonical source directory. This is a reversible write operation (modifying files in kit/), not a destructive one since it's syncing edits rather than deleting data. However, it could overwrite canonical files, so medium severity is appropriate.

From the tool's definition Detect and apply edits made directly in an IDE back to the canonical kit/

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

reverse-sync Rate-limited

reverse-sync 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": {
    "reverse-sync": {
      "limits": [
        {
          "counter": "reverse-sync_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 Kit, so you can run agents against it safely.

FAQ

Questions about reverse-sync

What does the reverse-sync tool do? +

Detect and apply edits made directly in an IDE back to the canonical kit/. It is categorised as a Write tool in the Kit MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on reverse-sync? +

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

What risk level is reverse-sync? +

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

Can I rate-limit reverse-sync? +

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

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

reverse-sync is provided by the Kit MCP server (luanpdd/kit-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.