list_pull_requests
Retrieve pull requests for one repository with number, title, author, draft and merged status, branch details, and total counts; filter by open, closed, or all to review what needs attention.
Instructions
List the pull requests (PRs) of ONE repository: number, title, author, draft flag, branches, and whether it was merged, plus the total that match. Filter by open, closed or all. Use for 'open PRs', 'what is waiting for review', or 'which PRs were merged'. Do NOT use for issues (use list_open_issues or search_issues) or for the commit history of a branch (use get_recent_commits).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"repo": "<repo>"
},
"name": "list_pull_requests"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| repo | Yes | Repository as 'owner/name' (e.g. 'octocat/hello-world'). A bare name like 'hello-world' is resolved against the authenticated user's account. | |
| limit | No | Maximum number of items to return (1-50). Totals are reported separately, so a small limit is fine when only a count is needed. | |
| state | No | 'open' (default), 'closed' (merged or rejected) or 'all'. | open |