[DOCS] `claude_code.pull_request.count` docs omit MCP-tool and merge-request coverage

Open 💬 2 comments Opened May 6, 2026 by coygeek

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/monitoring-usage

Section/Topic

Metrics table and Pull request counter subsection

Current Documentation

The docs currently say:

| claude_code.pull_request.count | Number of pull requests created | count | #### Pull request counter Incremented when creating pull requests via Claude Code.

What's Wrong or Missing?

This is outdated as of v2.1.129.

The v2.1.129 changelog says:

The claude_code.pull_request.count OTel metric now counts PRs/MRs created via MCP tools, not just shell commands

But the monitoring docs still describe this metric only as pull requests created via Claude Code. That misses two behavior details that now affect interpretation of exported telemetry:

A. Merge requests are included

The current wording says only "pull requests," but the metric now also counts merge requests.

B. MCP-tool creation paths are included

The current wording does not explain that the counter increments when PRs/MRs are created through MCP tools, not only through shell-command-based flows.

Users reading the current page can undercount or misclassify development activity when they interpret this metric in dashboards or alerts.

Suggested Improvement

Update the metric description and detail text to reflect the v2.1.129 behavior explicitly.

Before:

Number of pull requests created Incremented when creating pull requests via Claude Code.

After:

Number of pull requests and merge requests created Incremented when Claude Code creates a pull request or merge request, including creations performed through MCP tools.

If the metric name must stay claude_code.pull_request.count for compatibility, add a short note that the historical name still covers merge requests.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/monitoring-usage | 393, 422-429 | Metric description and pull-request counter details |

Total scope: 1 page affected

Cross-reference:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/changelog | v2.1.129 release note says the metric now counts PRs/MRs created via MCP tools |

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗