Skip to content

Clarify agent feedback MCP workflow#6744

Open
ethanpalm wants to merge 2 commits into
mainfrom
docs/agent-feedback-mcp-only
Open

Clarify agent feedback MCP workflow#6744
ethanpalm wants to merge 2 commits into
mainfrom
docs/agent-feedback-mcp-only

Conversation

@ethanpalm

@ethanpalm ethanpalm commented Jul 24, 2026

Copy link
Copy Markdown
Collaborator

Documentation changes

  • Remove the HTTP endpoint workflow that agents cannot discover from Markdown exports.
  • Document the Search MCP server and submit_feedback tool as the agent feedback workflow.
  • Clarify that web search and fetch tools do not provide an MCP connection.
  • Correct the April 17 changelog entry, which said Markdown exports include feedback instructions.
  • Sync the changes across English, Spanish, French, and Chinese.

Validation

  • vale optimize/feedback.mdx
  • mint broken-links
  • git diff --check

Note

Low Risk
Documentation-only wording changes with no application code or runtime behavior affected.

Overview
Agent feedback documentation is narrowed to a single integration path: connect agents to the site Search MCP server and use the submit_feedback tool (page path + problem description). The previous HTTP POST to /feedback option and curl example are removed because agents cannot discover that workflow from Markdown exports.

The caution about web search / web fetch is rewritten to state those tools do not connect agents to Search MCP (not that they lack the tool or that POST is an alternative). Closing copy now describes one submission flow (e.g. each submission recorded as unhelpful feedback) instead of “both methods.”

The same edits are applied in English, Spanish, French, and Chinese optimize/feedback.mdx files.

Reviewed by Cursor Bugbot for commit 1052730. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Jul 24, 2026, 10:41 PM

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟢 Ready View Preview Jul 24, 2026, 10:41 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants