# kcp-agent — KCP navigation planner

Builds deterministic load plans from KCP knowledge manifests before calling an LLM. It selects relevant context units while enforcing token and budget limits.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: Cantara
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Cantara/kcp-agent
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/kcp-agent-kcp-navigation-planner

## What it does

The server inspects `knowledge.yaml` files to determine which context fragments should be retrieved for a given prompt. Rather than feeding entire folders into an agent prompt, it scores unit relevance, checks signature trust, and filters out expired units before any prompt synthesis takes place.

The planning core runs deterministically without model inference. Units exceeding the `--context-budget` token threshold or lacking clearance are excluded under a fail-closed policy, accompanied by the arithmetic reason in the output.

Generating inspection plans with `plan` works offline without external credentials. Running `ask` to answer the prompt requires the `ANTHROPIC_API_KEY` environment variable.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add kcp-agent -- npx -y kcp-agent
```

### Codex

**Platform CLI**
```bash
codex mcp add kcp-agent-kcp-navigation-planner -- npx -y kcp-agent
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "kcp-agent-kcp-navigation-planner": {
            "command": "npx",
            "args": [
                "-y",
                "kcp-agent"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "kcp-agent-kcp-navigation-planner": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "kcp-agent"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add kcp-agent-kcp-navigation-planner npx -y kcp-agent
```

## When to use it
- build a context loading plan from a `knowledge.yaml` manifest
- enforce context token ceilings before fetching external docs
- exclude unauthorized or temporally expired documentation units
- verify that generated answers match loaded reference sources

## Example prompts
- Generate a load plan for deploying to production using knowledge.yaml
- Filter the knowledge manifest against a context budget of 4000 tokens

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md