DocsMCP Server

MCP Server

Connect AI agents to BugsPulse via the Model Context Protocol. Query crash reports, sessions, and analytics — all from your AI assistant or agent workflow.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI agents call tools on external services over HTTP. Once you connect the BugsPulse MCP server to your AI assistant (Claude, Cursor, VS Code Copilot, or any MCP-compatible client), it can directly query your crash reports, analyse session data, update issue statuses, and more — without you copying and pasting anything.

Connection

Details

Endpointhttps://api.bugspulse.com/mcp

ProtocolMCP 2024-11-05 — Streamable HTTP (JSON mode)

MethodPOST

Content-Typeapplication/json

Discoveryhttps://bugspulse.com/.well-known/mcp/server-card.json

Authentication

The MCP server uses BugsPulse session authentication. Sign in first to get a session cookie, then include it with every MCP request.

# 1. Sign in and save the session cookie

curl -c cookies.txt -X POST https://api.bugspulse.com/api/auth/sign-in/email \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","password":"••••••••"}'

# 2. Use the cookie on MCP requests

curl -b cookies.txt -X POST https://api.bugspulse.com/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Quick Start

After signing in, initialise the MCP session then start calling tools:

// Initialize
{ "jsonrpc": "2.0", "id": 1, "method": "initialize",
  "params": { "protocolVersion": "2024-11-05",
              "capabilities": {},
              "clientInfo": { "name": "my-agent", "version": "1.0" } } }

// List your projects
{ "jsonrpc": "2.0", "id": 2, "method": "tools/call",
  "params": { "name": "list_projects", "arguments": {} } }

// Get open crashes for a project
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
  "params": { "name": "list_crashes",
              "arguments": { "projectId": "<id>", "status": "open" } } }

// Mark a crash as resolved
{ "jsonrpc": "2.0", "id": 4, "method": "tools/call",
  "params": { "name": "update_crash_status",
              "arguments": { "crashId": "<id>", "status": "resolved" } } }

Available Tools

list_projectsArray of project objects

List all projects the authenticated user has access to.

list_crashes{ crashes, total, page, limit }

List crash reports for a project with optional filters.

Argument	Type	Required	Description
`projectId`	string	Yes	Target project ID
`status`	string	No	open \| acknowledged \| resolved \| ignored
`from`	string	No	ISO date — filter from this date
`to`	string	No	ISO date — filter to this date
`page`	number	No	Page number (default 1)
`limit`	number	No	Results per page, max 50 (default 25)

get_crashCrash object with stack trace, device info, and occurrence count

Get full details of a crash report by ID.

Argument	Type	Required	Description
`crashId`	string	Yes	Crash report ID

update_crash_statusUpdated crash object

Change the status of a crash report.

Argument	Type	Required	Description
`crashId`	string	Yes	Crash report ID
`status`	string	Yes	open \| acknowledged \| resolved \| ignored

get_analytics{ sessions: { total, avgDuration, crashedCount }, crashes: { total, open } }

Get session and crash analytics totals for a project.

Argument	Type	Required	Description
`projectId`	string	Yes	Target project ID

list_sessions{ sessions, total, page, limit }

List mobile sessions for a project with optional date filters.

Argument	Type	Required	Description
`projectId`	string	Yes	Target project ID
`from`	string	No	ISO date
`to`	string	No	ISO date
`page`	number	No	Page number (default 1)
`limit`	number	No	Results per page, max 50 (default 25)

get_session{ session, events[], networkLogs[] }

Get full session details including all events and network logs.

Argument	Type	Required	Description
`sessionId`	string	Yes	Session ID

Connect to Claude Desktop

Add BugsPulse to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "bugspulse": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.bugspulse.com/mcp"],
      "env": {}
    }
  }
}

You will be prompted to authenticate the first time. After that, Claude can directly query your crash reports and sessions in conversation.