[DOCS] `claude_code.pull_request.count` docs omit MCP-tool and merge-request coverage
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 |
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗