Medium Risk

kage_code_index

Write external code index artifacts consumed by the code graph. Prefers SCIP when scip-typescript and scip are installed, then falls back to the built-in LSP-compatible symbol index.

How to control kage_code_index ↓

What kage_code_index does on Kage

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

Medium Risk

Why kage_code_index needs a policy

This tool creates or modifies code index artifacts (SCIP or LSP-compatible symbol indices) that feed into the code graph system. While the write is reversible (indices can be regenerated or deleted), the artifacts influence code analysis and understanding across the team, so misuse could corrupt shared understanding or inject false symbol information.

From the tool's definition "Write external code index artifacts consumed by the code graph" — the tool explicitly creates/writes index artifacts that are consumed by other systems.

Documented attack patterns abuse exactly the kind of access kage_code_index gives an agent:

How to control kage_code_index

PolicyLayer is an MCP gateway — it sits between your AI agents and Kage, and nothing reaches the server without passing your rules. This is the rule we recommend for kage_code_index:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "kage_code_index": {
      "limits": [
        {
          "counter": "kage_code_index_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

kage_code_index 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.

  1. Create a free account and register Kage — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
LIMIT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about kage_code_index

What does the kage_code_index tool do? +

Write external code index artifacts consumed by the code graph. Prefers SCIP when scip-typescript and scip are installed, then falls back to the built-in LSP-compatible symbol index. It is categorised as a Write tool in the Kage MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on kage_code_index? +

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

What risk level is kage_code_index? +

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

Can I rate-limit kage_code_index? +

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

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

kage_code_index is provided by the Kage MCP server (@kage-core/kage-graph-mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Kage tool call.

Start from Kage, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

62 Kage tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.