Ybug

Ybug MCP server

Bring your Ybug bug reports into your AI assistant.

Ybug collects visual feedback and bug reports from your website: a screenshot, the page URL, browser, device and screen size, and optionally console logs and network requests. The Ybug MCP server lets Claude, ChatGPT, Codex, Claude Code, Cursor, VS Code and other MCP clients read those reports and help you triage them. No more copying reports into chat.

https://mcp.ybug.io/mcp

This is a remote server hosted by Ybug. There’s nothing to install or run. This repository holds the documentation and the MCP Registry entry (io.ybug/mcp). The server itself is part of Ybug and is not open source.

What you can ask

• “What feedback came in on the Acme project this week? Group it by page.”
• “Show me open high-priority bugs on Acme that nobody is assigned to.”
• “Read this report and find the likely cause in this repo.” (in a coding agent, with a report link)
• “Review the reports since Friday. Suggest priorities and duplicates, then apply the ones I approve with an internal note.”

More in the example prompts.

Connect

1. Add https://mcp.ybug.io/mcp as a remote MCP server in your client.
2. Sign in with your Ybug account when asked. There’s no API key.
3. Pick a team and approve access.

Step-by-step guides:

Client	Guide
Claude (web and desktop)	Add a custom connector
ChatGPT	Create a developer-mode app
Codex	codex mcp add
Claude Code	claude mcp add
Cursor	mcp.json
VS Code	mcp.json
Anything else	Requirements for other clients

For example, in Claude Code:

claude mcp add --transport http ybug https://mcp.ybug.io/mcp

The server uses streamable HTTP and OAuth 2.1 with PKCE and dynamic client registration.

Tools

Tool	What it does	Plan
list_projects	List your projects	BASIC
get_project	Get a project’s statuses, priorities and types	BASIC
list_tags	List the team’s tags	BASIC
list_project_members	List who feedback can be assigned to	BASIC
list_feedback	Find feedback by status, priority, type, tags, assignee, date or keyword	BASIC
get_feedback	Read one report in full, with screenshot and video links	BASIC
get_feedback_console_logs	Read a report’s console logs	BASIC
get_feedback_network_requests	Read a report’s network requests	BASIC
list_comments	Read a report’s comments	BASIC
update_feedback	Change status, priority, type, assignee and tags	STARTUP
add_comment	Add an internal comment	STARTUP
create_tag	Create a tag	STARTUP

The assistant can’t delete anything, change settings or send public comments. Arguments and responses are in the tool reference.

Plans

Read access is included in BASIC. Triage tools need STARTUP or higher. There’s no extra charge for MCP, and it isn’t available on FREE. See pricing.

Permissions and privacy

• The assistant acts as you, in one team. It sees only the projects you can access and can change only what you could change in the dashboard.
• Reporter and commenter email addresses, phone numbers, the user data your site passes to the widget, and reporter location are never sent.
• Screenshot and video links expire after about an hour.
• Report text is written by other people, so it can contain instructions. The tools tell the assistant to treat it as data. Review what a coding agent plans to do before you approve it. More on this.
• Moving a report to Resolved or Closed can send the reporter your auto-reply, if you’ve turned it on.
• Revoke access any time under Connected apps in your Ybug account.

Details: Permissions, plans and data · Privacy policy

Support

• Documentation
• Troubleshooting
• Contact

Found a problem with the server or the docs? Open an issue here, or send it through Help → Submit feedback in the Ybug dashboard.

License

The documentation and server.json in this repository are available under the MIT License. The Ybug service is subject to the Ybug terms.