SnagRelay for coding agents
Your users find the bugs. Your agent fixes them. Give Cursor, Claude Code or Codex a ticket key and it reads the evidence a human debugger would open: the broken element, console errors with file and line, failing requests with their request and response bodies, repro steps and a short replay.
This repo is the listing and distribution repo for the SnagRelay MCP server. It holds the plugin manifests for each agent platform, the shared skills and the registry entry. The MCP server itself is hosted by SnagRelay at https://mcp.snagrelay.com/v1.
Connect
Sign-in is OAuth. A SnagRelay page opens in your browser, you click Allow, and there is no token to copy.
| Client | Install |
|---|
| Cursor | Open Customize → Marketplace, search SnagRelay, install, then click Needs authentication on the snagrelay MCP server |
| Claude Code | claude plugin marketplace add snagrelay/agent-plugin then claude plugin install snagrelay@snagrelay. Run /mcp and authenticate snagrelay |
| Codex | codex plugin marketplace add snagrelay/agent-plugin then codex plugin add snagrelay@snagrelay. Sign in with codex mcp login snagrelay |
| Lovable | Settings → Connectors → search SnagRelay, or add a custom MCP server with the URL below |
| Bolt | Add a custom remote MCP connector with the URL below |
| Replit | Add a custom MCP server with the URL below |
| Anything else | Point any Streamable HTTP MCP client at https://mcp.snagrelay.com/v1 |
Lovable, Bolt and Replit guides are being written; the custom-connector route works today.
For CI, scripts and other headless clients, create an API token in SnagRelay (Settings → API tokens) and send Authorization: Bearer <token> to the same URL.
Which URL?
All four share one server and one sign-in. Pick the narrowest one that fits.
| URL | Use it when |
|---|
https://mcp.snagrelay.com/v1 | You work across projects. The default |
https://mcp.snagrelay.com/v1/readonly | You want the agent to read issues but never write. The write tools (report_progress, mark_issue_resolved) are removed and blocked. Good for security-conscious teams and shared machines |
https://mcp.snagrelay.com/v1/{projectId} | This repo belongs to one SnagRelay project. Hard-scoped, so the agent cannot see other projects |
https://mcp.snagrelay.com/v1/{projectId}/readonly | Both of the above |
{projectId} is the number from whoami, or from the project's URL in SnagRelay.
| Tool | Access | What it does |
|---|
get_issue_context | read | Full context of one issue by key: the element, repro steps, console errors with file and line, requests with bodies, and a screenshot resource link |
get_issue_payload | read | One full request or response body, or one console entry, by the index from get_issue_context |
get_related_history | read | Earlier resolved issues on the same screen or endpoint, with the PR that fixed them |
find_issues | read | List or search issues when you have no key |
whoami | read | Signed-in account, plan and accessible projects |
report_progress | write | Tells SnagRelay which file the agent is editing |
mark_issue_resolved | write | Marks an issue resolved with the PR, commit and branch. Optionally emails the reporter |
One resource: screenshot, the issue's screenshot, read with resources/read.
Every tool carries MCP annotations (readOnlyHint, destructiveHint, idempotentHint, openWorldHint). None is destructive. The agent is instructed not to call mark_issue_resolved before you have reviewed the fix.
Usage
fix PROJ-123
-> get_issue_context("PROJ-123")
-> reads the failing request and its response body, the console error with file and line, the repro steps
-> get_related_history: has this broken before, and what fixed it?
-> proposes a targeted fix on feature/PROJ-123-<summary>
Skills
Six skills, written once in skills/ and used by every client.
| Skill | What it does |
|---|
fix-issue | Load context and fix a SnagRelay issue on a branch, then stop for your review |
open-pr | Branch feature/{key}-{summary}, PR title [{key}] {type}: {description}, full description |
resolve-issue | Commit and open a PR if needed, then mark the issue resolved |
triage | List open issues so you can pick one |
connect | Diagnose a broken MCP connection |
scope | When the agent may (and may not) call SnagRelay |
Cursor also gets rules/snagrelay-context.mdc, which tells the agent to load an issue's context before proposing a fix.
Claude Code namespaces plugin skills: run /snagrelay:fix-issue PROJ-123. In Cursor and Codex, say fix PROJ-123 or use /fix-issue.
Data and privacy
The agent receives what your users' widget captured on the page: element, console, network, replay and screenshot. Secrets are stripped on the server before anything reaches the agent: authorization and cookie headers, API keys, tokens, passwords, CSRF values, secret-looking query and form parameters, bearer tokens, JWTs and long hex or base64 strings. Issues are visible to the agent only as long as your plan's history window (history_days) allows. See TELEMETRY.md for the full list and SECURITY.md to report a vulnerability.
This repo contains no code that runs on your machine: only manifests, skills, a rule and a remote MCP URL.
Requirements
- A SnagRelay account. The free plan includes the MCP server, network bodies and 1 project. See pricing
- Cursor, Claude Code, Codex, or any MCP client that supports Streamable HTTP with OAuth
Links
Website · Docs · Pricing · Support · Privacy · Terms
Contributing
Edit skills/ and rules/, never the manifests by hand: see AGENTS.md. MIT licensed.