Bugsnag MCP Server

1# Bugsnag MCP Server
2 
3A Model Context Protocol (MCP) server for interacting with Bugsnag. This server allows LLM tools like Cursor and Claude to investigate and resolve issues in Bugsnag.
4 
5## ✨ Features
6 
7### Error Monitoring & Analysis
8- **Organization & Project Navigation**: Easily browse your Bugsnag hierarchy
9- **Error & Event Filtering**: Find specific issues with powerful filtering options
10- **Detailed Stacktrace Viewing**: See formatted stacktraces with source code context and highlighted error lines
11- **Exception Chain Visualization**: Understand the root cause by viewing the full exception chain
12 
13### Code Intelligence
14- **Project vs. Library Code Distinction**: Clearly identify your code vs third-party libraries
15- **Source Code Context**: View relevant code snippets around error locations
16- **Error Patterns**: Identify recurring patterns across multiple errors
17 
18### Issue Management
19- **Search Capabilities**: Find issues by error class, message, or app version
20- **Error Details**: Get comprehensive information about each error
21- **Event History**: View all occurrences of a specific error
22 
23## 🚀 Quick Setup
24 
25Setting up the Bugsnag MCP server is simple and doesn't require any installation or downloading source code.
26 
27### For Cursor
28 
291. Add the Bugsnag MCP server configuration:
30   ```json
31   {
32     "mcpServers": {
33       "bugsnag": {
34         "command": "npx",
35         "args": ["-y", "bugsnag-mcp-server"],
36         "env": {
37           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
38         },
39         "disabled": false,
40         "alwaysAllow": []
41       }
42     }
43   }
44   ```
45 
462. Replace `your-bugsnag-api-key` with your Bugsnag API key
47 
48### For Claude Desktop
49 
501. Add the Bugsnag MCP server configuration:
51   ```json
52   {
53     "mcpServers": {
54       "bugsnag": {
55         "command": "npx",
56         "args": ["-y", "bugsnag-mcp-server"],
57         "env": {
58           "BUGSNAG_API_KEY": "your-bugsnag-api-key"
59         },
60         "disabled": false,
61         "alwaysAllow": []
62       }
63     }
64   }
65   ```
66 
672. Replace `your-bugsnag-api-key` with your Bugsnag API key
68 
69## 🔑 Obtaining a Bugsnag API Key
70 
71To use this MCP server, you'll need a Bugsnag API key:
72 
731. Log in to your Bugsnag account at [https://app.bugsnag.com/](https://app.bugsnag.com/)
742. Go to **Settings** > **Organization settings** > **Access tokens**
753. Create a new personal access token with the following permissions:
76   - Read projects
77   - Read and write errors
78   - Read and write comments
794. Copy the generated token for use with the MCP server
80 
81## 📋 Usage Examples
82 
83Once configured, you can use the Bugsnag MCP server with your LLM tool. Here are some example prompts:
84 
85### Exploring Your Bugsnag Account
86 
87```
88List all my Bugsnag organizations
89```
90 
91```
92Show me all projects in organization "org_12345"
93```
94 
95### Finding and Analyzing Errors
96 
97```
98List the open errors in my Bugsnag project "project_12345"
99```
100 
101```
102Show me the details for Bugsnag error ID "error_12345"
103```
104 
105```
106Show me the detailed stacktrace for event "event_12345" in project "project_12345"
107```
108 
109```
110View the exception chain for event "event_12345" in project "project_12345"
111```
112 
113### Searching for Specific Issues
114 
115```
116Search for Bugsnag issues in project "project_12345" related to "NullPointerException"
117```
118 
119```
120List all events for error "error_12345" in project "project_12345"
121```
122 
123## 📚 Available Tools
124 
125The Bugsnag MCP server provides the following tools:
126 
127### Organization & Project Management
128 
129#### list_organizations
130 
131Lists available Bugsnag organizations.
132 
133Parameters:
134- None required
135 
136#### list_projects
137 
138Lists projects in an organization.
139 
140Parameters:
141- `organization_id` (required): Bugsnag organization ID
142 
143### Error & Event Management
144 
145#### list_errors
146 
147Lists errors in a project with filtering options.
148 
149Parameters:
150- `project_id` (required): Bugsnag project ID
151- `status`: Filter by error status ("open", "fixed", "ignored")
152- `sort`: Sort order for errors ("newest", "oldest", "priority")
153- `limit`: Maximum number of errors to return
154 
155#### view_error
156 
157Gets detailed information about a specific error.
158 
159Parameters:
160- `error_id` (required): Bugsnag error ID
161 
162#### list_error_events
163 
164Lists events (occurrences) for a specific error.
165 
166Parameters:
167- `project_id` (required): Bugsnag project ID
168- `error_id` (required): Bugsnag error ID
169- `limit`: Maximum number of events to return
170 
171#### view_latest_event
172 
173Views the latest event for an error.
174 
175Parameters:
176- `error_id` (required): Bugsnag error ID
177 
178#### view_event
179 
180Views detailed information about a specific event.
181 
182Parameters:
183- `project_id` (required): Bugsnag project ID
184- `event_id` (required): Bugsnag event ID
185 
186### Stacktrace Analysis
187 
188#### view_stacktrace
189 
190Extracts and formats stacktrace information from an event.
191 
192Parameters:
193- `project_id` (required): Bugsnag project ID
194- `event_id` (required): Bugsnag event ID
195- `include_code`: Include source code context if available (default: true)
196 
197#### view_exception_chain
198 
199Views the full chain of exceptions for an event.
200 
201Parameters:
202- `project_id` (required): Bugsnag project ID
203- `event_id` (required): Bugsnag event ID
204 
205### Issue Management
206 
207#### search_issues
208 
209Searches for issues using various criteria.
210 
211Parameters:
212- `project_id` (required): Bugsnag project ID
213- `query`: Search query
214- `error_class`: Filter by error class
215- `app_version`: Filter by app version
216 
217## 🛠️ Advanced Usage
218 
219### Testing Your API Key
220 
221You can test if your Bugsnag API key is valid using:
222 
223```bash
224npx bugsnag-mcp-server test-api-key your-bugsnag-api-key
225```
226 
227If your API key is valid, this will display a list of your Bugsnag projects with their IDs.
228 
229### Installation Options
230 
231While using `npx` is recommended for most users, you can also install the package globally if you prefer:
232 
233```bash
234npm install -g bugsnag-mcp-server
235```
236 
237### For Developers
238 
239If you're interested in contributing or modifying the code:
240 
2411. Clone the repository:
242   ```bash
243   git clone https://github.com/yourusername/bugsnag-mcp.git
244   cd bugsnag-mcp
245   ```
246 
2472. Install dependencies:
248   ```bash
249   npm install
250   ```
251 
2523. Build the project:
253   ```bash
254   npm run build
255   ```
256 
2574. Run tests:
258   ```bash
259   npm test
260   ```
261 
2625. Run tests with coverage:
263   ```bash
264   npm run test:coverage
265   ```
266 
2676. Format code:
268  ```bash
269  npm run format
270  ```
271 
2727. Check code formatting:
273  ```bash
274  npm run format:check
275  ```
276 
277### Continuous Integration
278 
279This project uses GitHub Actions for continuous integration. The workflows automatically:
280 
281- Runs on push to the main branch and on pull requests
282- Tests against multiple Node.js versions (18.x and 20.x)
283- Runs the test suite
284- Generates and uploads test coverage reports
285- Checks code formatting with Prettier
286 
287You can view the workflow configurations in:
288- `.github/workflows/test.yml` - For running tests
289- `.github/workflows/prettier.yml` - For checking code formatting
290 
291## License
292 
293MIT
294