Pinpoint MCP Server

Give your AI coding assistant full access to Pinpoint through the Model Context Protocol. Manage projects, test requests, reports, and bugs without leaving the editor.

v1.1.3 npm

Setup

Select your editor below for step-by-step instructions. The server runs through npx, so there is no global install required.

1Create or open .mcp.json in your project root
2Paste the configuration below
3Replace your-api-token with the token from your Pinpoint dashboard
4Restart Claude Code to pick up the new server

.mcp.json

Place this file in your project root or home directory. The server automatically discovers your account details when you connect.

{
  "mcpServers": {
    "pinpoint": {
      "command": "npx",
      "args": [
        "-y",
        "pinpointmcp"
      ],
      "env": {
        "PINPOINT_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Once connected, your AI assistant gains access to 13 tool calls grouped across four categories. Each one maps directly to the Pinpoint API.

Bug Management

list_bugs

Filter bug reports by status, project, and page through results

get_bug

Retrieve the full report for a specific bug including reproduction steps

update_bug_status

Mark a bug as in_progress or complete with optional resolution notes

configure

Set or rotate your API token at runtime without editing config files

Project Management

list_projects

List all projects in your account

create_project

delete_project

Remove a project by ID

Project creation beyond your plan's included limit returns an error directing you to the dashboard for billing confirmation. This prevents unintended charges when used by AI agents.

Test Requests

list_requests

List test requests for your account

create_request

Create a new test request for a project

get_request

Retrieve details for a specific test request

Reports

get_report

Retrieve metadata for a specific bug report

download_report

Get a presigned download URL for a report PDF

list_dispatch_reports

List all reports generated for a test request

Resources

MCP resources let your assistant read Pinpoint data as structured context without making explicit tool calls.

pinpoint://projects

JSON list of active projects

pinpoint://projects/{id}

Markdown-formatted project details

pinpoint://requests/{id}

Markdown-formatted request details

pinpoint://bugs

JSON list of open bugs

pinpoint://bugs/{id}

Markdown-formatted bug details

Prompts

Pre-built prompt templates that structure multi-step analysis workflows for your AI assistant.

review_request

Analyze test request results and associated reports. Accepts a request ID, fetches the dispatch details and all reports, and builds a structured analysis prompt.

Usage

Here is what the workflow looks like in practice. Ask your assistant in plain language and Pinpoint handles the rest.

List open bugsAsk your assistant to pull every unresolved report for a project

Show me all open bugs for the payments project

Found 3 open bugs for payments:

  #421  Stripe webhook timeout on retry        (high)
  #419  Currency rounding error in checkout     (medium)
  #418  Missing null check in refund handler    (medium)

Inspect a bugRetrieve the full report with reproduction steps and severity

Get the details for bug #418

Bug #418 — Missing null check in refund handler

Status:      open
Severity:    medium
Found in:    v2.4.1

Reproduction steps:
  1. Initiate a refund for an order with no payment method
  2. Observe a NullPointerException at refund.ts:47

Expected: Graceful error message returned to the caller
Actual:   Unhandled exception crashes the request

Fix and mark completeLet your assistant locate the issue, apply a fix, and mark the bug complete for Pinpoint to verify

Fix bug #418 and mark it complete

Reading bug #418...
Located null check issue in src/payments/refund.ts:47

Applied fix — added guard clause before accessing
payment method. Marking bug #418 as complete with
note "Added null check for missing payment method."
Pinpoint will verify the fix during the next test round.

Update bug statusTransition a bug through the workflow without leaving the editor

Mark bug #421 as in_progress, I'm starting on it now

Updated bug #421 "Stripe webhook timeout on retry"
from open → in_progress.

Configure at runtimeRotate your API token or point to a different project without editing config files

Configure Pinpoint with my new API token abc-xyz-123

Pinpoint API token updated successfully.
Connected to testwithpinpoint.com, ready to go.

Manage projectsList the projects registered in your Pinpoint account

List my projects

Found 2 projects:

  My App        (UI, active)
  Backend API   (API, active)

Create test requestSubmit a new test request for a project and track its progress

Create a test request for the My App project

Created test request req-abc-123 for project My App.
Status: pending. You'll receive results within your
SLA window.

Review test resultsRetrieve the reports generated for a completed test request

Show me the reports for request req-abc-123

Found 2 reports for req-abc-123:

  #1  Login timeout on mobile              (high)
  #2  Form validation skipped on Safari    (medium)

Use get_report or download_report for full details.