team_add_knowledge · Musubix MCP: Risk & Policy

WHAT IT DOES

What team_add_knowledge does on Musubix

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

WHY IT NEEDS A POLICY

Why team_add_knowledge needs a policy

This tool creates new entries in a knowledge base, which is a write operation. It doesn't delete, execute code, move money, or trigger external operations—it simply adds informational content. Severity is medium because misuse could introduce incorrect or misleading information into a shared knowledge base, but the effect is reversible (entries can be edited or removed).

From the tool's definition Tool description states it 'adds new entries' (新しいエントリを追加します) to a team knowledge base, including decisions, lessons learned, best practices, and warnings. This is a create/modify operation that adds data reversibly.

Attacks that exploit this kind of access

Recommended rule Ready

Verdict

team_add_knowledge Rate-limited

team_add_knowledge 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": {
    "team_add_knowledge": {
      "limits": [
        {
          "counter": "team_add_knowledge_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 Musubix, so you can run agents against it safely.

FAQ

Questions about team_add_knowledge

What does the team_add_knowledge tool do? +

チームのナレッジベースに新しいエントリを追加します。決定、教訓、ベストプラクティス、警告などを共有できます。. It is categorised as a Write tool in the Musubix MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on team_add_knowledge? +

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

What risk level is team_add_knowledge? +

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

Can I rate-limit team_add_knowledge? +

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

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

team_add_knowledge is provided by the Musubix MCP server (@nahisaho/musubix-mcp-server). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.