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.3.1 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
3Restart Claude Code to pick up the new server
4The server will prompt you to log in on first use

.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@latest"
      ]
    }
  }
}

Available Tools

Once connected, your AI assistant gains access to 25 tool calls grouped across seven 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

update_project

Update a project's name, description, or type

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.

Environments

add_environment

Add a new environment to a project with a name and base URL

list_environments

List environments for a project

update_environment

Update an environment's name, base URL, or default status

remove_environment

Remove an environment from a project

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

Spectre Scan

list_scan_runs

List Spectre scan runs showing commit, branch, and finding counts

list_scan_findings

List findings for a project filtered by category, severity, or status

get_scan_finding

Get detailed information about a finding including location and suggested fix

update_finding_status

Update a finding's status to acknowledged, resolved, or false positive

Dependency Insights

get_blast_radius

Compute the proportion of the dependency graph reachable from a given component

get_dependency_chain

Traverse the dependency chain from a component with relationship labels

get_test_coverage

Calculate test coverage for a scope by examining tested-by edge ratios

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://projects/{id}/scans

JSON summary of latest scan run and finding counts

pinpoint://requests/{id}

Markdown-formatted request details

pinpoint://bugs

JSON list of open bugs

pinpoint://bugs/{id}

Markdown-formatted bug details

pinpoint://findings/{id}

Markdown-formatted scan finding details

Prompts

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

solve_bug

Structured prompt for analyzing and fixing a specific bug. Fetches the full bug report and builds a step-by-step resolution workflow.

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.

fix_finding

Structured prompt for fixing a specific Spectre scan finding. Includes location, description, suggested action, and related components.

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.