kcp_plan
Produce a deterministic, inspectable load plan for a task against a KCP knowledge.yaml: which units to load in what order, which to skip and why, federation and budget decisions. No content is loaded and no model is called.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task": "<task>",
"manifest": "<manifest>"
},
"name": "kcp_plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| env | No | Runtime environment for federation context selection (dev/test/staging/prod) | |
| role | No | Agent role for audience targeting (default: agent) | |
| task | Yes | The task to plan knowledge loading for | |
| as_of | No | ISO date for temporal evaluation (default: today, UTC) | |
| attest | No | Attestation provider the agent can present, matched against the manifest's trusted_providers | |
| budget | No | Spend ceiling for pay-per-request units | |
| follow | No | Follow eligible federation refs (default false) | |
| strict | No | Fail-closed: drop non-eligible units instead of listing them | |
| methods | No | Payment methods the agent can settle, e.g. ["free","x402"] (default: free only) | |
| currency | No | Budget currency (default USDC) | |
| manifest | Yes | Path, directory, or HTTPS URL of a knowledge.yaml | |
| max_depth | No | Federation hops to follow when follow=true (default 1) | |
| max_nodes | No | Cap on total manifests fetched across the walk (default 64) | |
| max_units | No | Cap on selected units (default 5) | |
| credentials | No | Credential kinds the agent holds, e.g. ["mtls","api_key"] — opens access-gated units | |
| context_budget | No | Token ceiling for what the plan loads into the caller's context window; over-budget units skipped with the arithmetic | |
| allow_private_hosts | No | Permit fetches to loopback/private/link-local hosts and http:// (default false — fail-closed) |