About Ybug
Ybug’s remote MCP server lets AI clients read website bug reports and help teams investigate and triage them. Reports can include screenshots, browser details, console logs, and network requests; selected triage changes are also available.
Key features
- 01Search reports by status, priority, tags, assignee, date, or keyword
- 02Read screenshots, video links, logs, and network requests
- 03Update report status, priority, type, assignee, and tags
- 04Add internal comments and create tags
Use cases
- 01Group incoming feedback by project page
- 02Find unassigned high-priority bugs
- 03Review reports and suggest priorities or duplicates
- 04Inspect a report alongside a code repository
MCP support
Hosted by Ybug at https://mcp.ybug.io/mcp, the remote MCP server exposes tools for reading and triaging Ybug reports to MCP clients. It uses streamable HTTP and OAuth 2.1 with PKCE.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.ybug.io/mcpclaude mcp add --transport http ybug https://mcp.ybug.io/mcp{"mcpServers":{"ybug":{"type":"http","url":"https://mcp.ybug.io/mcp"}}}Open in Cursor{"servers":{"ybug":{"type":"http","url":"https://mcp.ybug.io/mcp"}}}Open in VS Code{"mcpServers":{"ybug":{"type":"http","url":"https://mcp.ybug.io/mcp"}}}{"mcpServers":{"ybug":{"serverUrl":"https://mcp.ybug.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
12| Parameter | Type | Required | Description |
|---|---|---|---|
| query | string | No | Optional case-insensitive substring to match against project names. |
| page | integer | No | Page number (1-based). Defaults to 1. |
| page_size | integer | No | Items per page (1–100). Defaults to 25. |
Details
From the project README
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
- Add
https://mcp.ybug.io/mcpas a remote MCP server in your client. - Sign in with your Ybug account when asked. There’s no API key.
- 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
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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.