Ybug MCP server
Commit Oct 8, 2026Lets an AI assistant read, filter, and triage website feedback and bug reports including screenshots, console logs, and network requests.
Also known as Ybug-io/mcp-server, mcp-server
- Stars
- 0
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Oct 8, 2026
- License
- MIT
What is Ybug MCP?
Ybug lets an AI assistant read, filter, and triage website feedback and bug reports including screenshots, console logs, and network requests. It exposes 12 tools, such as list_projects, get_project, list_tags.
Summary generated from the project's README
About Ybug MCP server
Ybug provides a remote MCP server that connects your website feedback and bug reports directly to AI assistants. This tool allows developers to use clients like Claude, ChatGPT, Cursor, and VS Code to examine visual feedback, including screenshots, console logs, and network requests, without manual copying. It functions as a hosted service via a specific URL, requiring users to sign in with a Ybug account through OAuth 2.1 rather than using an API key.
Users can interact with their data using specific tools such as list_feedback to find reports by priority or date, and get_feedback_console_logs to inspect technical errors. While the BASIC plan allows for reading projects and feedback, the STARTUP plan is required to use triage tools like update_feedback or add_comment. The assistant operates within the permissions of your specific Ybug team, meaning it can only access projects and perform actions that your account is authorized to handle in the dashboard.
What you can do with it
- 1Summarize recent project feedbackAsk your AI assistant to group all feedback received for a specific project during the current week by page.
- 2Identify unassigned high priority bugsRequest a list of urgent, open bugs that have not yet been assigned to a team member.
- 3Debug code using report dataProvide a report link to a coding agent to help it find the root cause of an issue within your repository.
- 4Automate bug triage and prioritizationHave the assistant review recent reports to suggest duplicates and priorities, then apply those changes to the reports.
Written from the project's README. Every use case is checked against a quote from it.
How to install Ybug MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Ybug MCP in Claude Code
$ claude mcp add --transport http mcp-server https://mcp.ybug.io/mcpInstall Ybug MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.ybug.io/mcp"
}
}
}Install Ybug MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.ybug.io/mcp"
}
}
}Install Ybug MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.ybug.io/mcp"}'Install Ybug MCP in Codex
$ codex mcp add mcp-server --url https://mcp.ybug.io/mcpInstall Ybug MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.ybug.io/mcp"
Install Ybug MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp-server https://mcp.ybug.io/mcpInstall Ybug MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.ybug.io/mcp",
"type": "http"
}
}
}Ybug MCP tools 12
Detected from the READMElist_projectsget_projectlist_tagslist_project_memberslist_feedbackget_feedbackget_feedback_console_logsget_feedback_network_requestslist_commentsupdate_feedbackadd_commentcreate_tag
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableybug-io/mcp-server is public and reachablegithub.com/ybug-io/mcp-server ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-08github.com/ybug-io/mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubYbug 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.
Ybug MCP questions
How do I add Ybug MCP to Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.ybug.io/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Ybug MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Ybug MCP provide?
It exposes 12 tools, including list_projects, get_project, list_tags, list_project_members, list_feedback.
Do I need an API key to use the Ybug MCP server?
No, there is no API key required; the server uses OAuth 2.1 with PKCE.
Can the AI assistant delete bug reports?
No, the assistant is limited to specific actions and cannot delete anything or change settings.
What features are available in the BASIC plan?
The BASIC plan includes read access tools such as listing projects, getting project details, listing tags, and reading feedback or console logs.