docs(mcp): fix delete tool instructions — no-args CWD mode not supported

[Ankitsinghsisodya]

Note: Re-submission of #3764, accidentally closed when the head repository was deleted.

Problem

The embedded MCP instructions at pkg/mcp/instructions.md stated:

"no named parameter indicates 'delete the Function in my cwd'"

This implied that agents could call the delete tool with no path and no name, and the tool would delete the Function in the current working directory.

That is incorrect in the MCP context. The MCP server runs as a separate process with its own working directory, unrelated to the Function the agent is managing. The handler at pkg/mcp/tools_delete.go correctly enforces that exactly one of path or name must be provided, returning an error otherwise.

The result was a direct contradiction between two lines in the same file, causing agents following the incorrect guidance to send requests the handler would reject.

Fix

Updated the description to accurately reflect the handler's contract: delete requires exactly one of path or name and does not support a no-argument CWD mode.

No code changes are needed. The handler behavior is correct.

Files changed

• pkg/mcp/instructions.md — corrected description of the delete tool

[knative-prow]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: Ankitsinghsisodya
Once this PR has been reviewed and has the lgtm label, please assign matejvasek for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details

Needs approval from an approver in each of these files:

• OWNERS

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[knative-prow]

Hi @Ankitsinghsisodya. Thanks for your PR.

I'm waiting for a knative member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Tip

We noticed you've done this a few times! Consider joining the org to skip this step and gain /lgtm and other bot rights. We recommend asking approvers on your previous PRs to sponsor you.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

[Copilot]

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

Updates MCP documentation to clarify delete tool argument requirements and remove the previously documented implicit “delete in my cwd” mode.

Changes:

• Clarifies that delete requires exactly one of path or name
• Documents that a no-argument CWD-based delete mode is not supported due to MCP server process working directory semantics

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.