Connect AI assistants to BugSmash to create visual review projects, manage versions, and resolve feedback. The hosted MCP server uses OAuth.
Quick Install
Automated & IDE SetupCopy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.
Manual Client & Custom JSON ConfigExpand JSON ▾
No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for BugSmash, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.
Documentation Overview
BugSmash AI Plugin
Connect any MCP-compatible AI assistant — including Claude, ChatGPT, Cursor, and Codex — to BugSmash, the visual review and feedback platform for agencies, product, design, and marketing teams.
With this plugin your AI assistant can create review projects, upload versions, read and summarize feedback, reply to comments, organize folders, and manage webhooks — all from the chat you already work in.
What is BugSmash?
BugSmash is a review layer for the internet. Share any digital content — live websites, dashboards, videos, PDFs, images, audio, even mobile apps — and let clients and stakeholders comment directly on it. Comments are pinned exactly where the context is, so feedback, progress, and approvals live in one place instead of scattered screenshots and email threads.
What this plugin does
This plugin packages BugSmash's hosted MCP server for AI coding assistants. Once installed, you can ask your assistant to:
| Area | What you can do |
|---|---|
| Projects | List, read, create, update, and delete review projects |
| Versions | List, read, create, and delete versions of a project |
| Folders | List, read, create, update, and delete folders |
| Comments | List, read, create, update, and delete feedback comments |
| Replies | List, create, and delete replies on a comment |
| Webhooks | List, update, test, and delete webhooks |
| Uploads | Attach local files and chat attachments as projects, versions, or comment updates |
The plugin talks to BugSmash's hosted MCP endpoint:
Nothing runs locally and there is no server to host. This repository contains only the plugin manifests and a skill that teaches the assistant how to work with BugSmash safely.
Requirements
- A BugSmash account
Authentication
BugSmash uses OAuth 2.1 with PKCE. The first time your assistant calls a BugSmash tool, your browser opens a sign-in page where you approve access. That's it.
- No API keys to copy, paste, or store
- The plugin never requests, stores, or proxies a BugSmash API key
- Access follows the same roles, plan, and usage limits as the BugSmash app
- Revoke the connection at any time from BugSmash; the assistant loses access immediately
Installation
Claude Code
Add the marketplace and install the plugin:
Run /reload-plugins if Claude Code asks you to, then /mcp to sign in to BugSmash when prompted.
Claude (web and desktop)
You can connect BugSmash directly as a custom connector — no plugin required:
- Open Customize → Connectors.
- Click + and choose Add custom connector.
- Enter
https://api.bugsmash.io/mcpas the remote MCP server URL. Leave the OAuth client fields empty — BugSmash supports dynamic client registration. - Click Add, then Connect and approve access in the BugSmash sign-in page.
- Enable BugSmash in a new chat.
Cursor
Add this repository as a marketplace: go to Dashboard → Plugins & MCPs, choose Add Marketplace under Team Marketplaces, select Import from Repo, and paste https://github.com/solutionwise/bugsmash-ai-plugin. The plugin then appears under Customize in the Cursor sidebar, where you can select Install at the user or project scope.
To try it on a single machine instead, clone this repository and link the plugin into Cursor's local plugin folder, then reload Cursor (Developer: Reload Window):
Codex
From the Codex CLI:
Start a new task after installing; the first BugSmash tool call opens the sign-in flow.
Any other MCP client
Point your client at https://api.bugsmash.io/mcp using the streamable HTTP transport. The server supports OAuth discovery, dynamic client registration, PKCE (S256), token refresh, and revocation.
Example prompts
Safety
The bundled skill instructs the assistant to:
- Read current state before writing when the target isn't exact
- State the exact target and ask for confirmation before any delete
- Warn that deleting a folder also deletes its nested folders and every project inside them
- Tell you when a write creates or changes a public review link
- Never display OAuth tokens, webhook signing secrets, or private upload URLs
- Never retry a write automatically after a timeout
Troubleshooting
| Symptom | What to do |
|---|---|
401 Unauthorized | Reconnect BugSmash through the browser sign-in flow (/mcp in Claude Code). |
403 Forbidden | Your workspace role, plan, usage limit, or OAuth scope doesn't allow the action. Guests and collaborators can't use MCP. |
404 Not Found | Check the ID and confirm you connected the right workspace. |
| BugSmash tools don't appear | Run /reload-plugins (Claude Code), reload the window (Cursor), or start a new session (Codex). |
429 Too Many Requests | You've hit a BugSmash rate or usage limit. Wait for it to reset. |
Repository layout
Development
To test changes locally, add this repository as a local marketplace in your client of choice. See docs/client-setup.md for step-by-step instructions for each client and a suggested functional test order.
Validate the manifests before opening a pull request:
Links
Found a problem with the plugin? Open an issue.
License
This plugin package is released under the MIT License. The license covers the files in this repository only, not the hosted BugSmash service.
Related MCP Servers
Reviews
No reviews yet — be the first to share how this listing worked for you.
Frequently Asked Questions about BugSmash
AllMCPs Directory Badge
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
Badge Style:
Live Dynamic SVG Preview
Markdown (GitHub README)
[](https://allmcps.com/mcp/bugsmash)HTML Embed
<a href="https://allmcps.com/mcp/bugsmash"><img src="https://allmcps.com/api/badge/bugsmash?style=directory" alt="BugSmash on AllMCPs" /></a>Technical Specs & Signals
CategoryProduct Management
35Quality signal: Fair · 35/100How this signal is calculated ▾
Server availabilityNot measured
Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.
Verified ownership8/20
Documentation & tools17/30
Adoption & activity1/15
Community engagement0/10
A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.
Own this project?
This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.
Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.
Claim & get free dofollowShare & Embed
Add our SVG badge (dark/light directory styles) or embeddable widget to your site.