Skip to content

docs(mcp): sync CON-5326 usage-limit widget behavior from common#8250 - #10

Draft
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1787802977-sync-mcp-usage-limit-widget
Draft

docs(mcp): sync CON-5326 usage-limit widget behavior from common#8250#10
devin-ai-integration[bot] wants to merge 1 commit into
mainfrom
devin/1787802977-sync-mcp-usage-limit-widget

Conversation

@devin-ai-integration

Copy link
Copy Markdown
Contributor

Summary

Update the MCP docs to reflect how the ChatGPT widget now renders usage/rate/billing limits returned by the search tool.

Why

Consensus-NLP/common#8250 (commit 4912e79e5) changed the MCP search tool so that blocked searches for the ChatGPT client return a ToolResult with is_error: true and structuredContent.error (plus an optional upgrade CTA) instead of raising a bare ToolError. The widget reads this and shows the server message; Free and anonymous users also see an Upgrade to Pro button. Other MCP clients still receive the error in the tool result.

Changes

  • consensus-mcp.mdx
    • Added a Response <Note> explaining that ChatGPT surfaces usage/rate-limit messages in the widget and that Free/anonymous users see an upgrade CTA.
    • Updated the Monthly search limit reached troubleshooting accordion to mention the widget message and upgrade button.
    • Updated the Rate limit exceeded (429 error) troubleshooting accordion to mention the widget retry message.

No openapi.json changes are needed because the commit only touches the MCP server, not the REST API.

Link to Devin session: https://app.devin.ai/sessions/db25d1b401b34ada9f19d27bb2ec57a2
Open in Devin Desktop: https://app.devin.ai/desktop/session/db25d1b401b34ada9f19d27bb2ec57a2?variant=devin
Requested by: @aakashadesara

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
@mintlify

mintlify Bot commented Aug 27, 2026

Copy link
Copy Markdown

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

Project Status Preview Updated (UTC)
consensus 🟢 Ready View Preview Aug 27, 2026, 3:57 AM

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

@devin-ai-integration

Copy link
Copy Markdown
Contributor Author

🤖 Devin AI Engineer

I'll be helping with this pull request! Here's what you should know:

✅ I will automatically:

  • Address comments on this PR. Add '(aside)' to your comment to have me ignore it.
  • Look at CI failures and help fix them

Note: I can only respond to comments from users who have write access to this repository.

⚙️ Control Options:

  • Disable automatic comment, CI, and merge conflict monitoring

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.

1 participant