# List Pull Requests

> List and filter repository pull requests

- Skill: `xiaobai1017/list-pull-requests` (Agent Skill)
- Install (CLI): `npx skillmds@latest add xiaobai1017/list-pull-requests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xiaobai1017/list-pull-requests/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xiaobai1017 (https://skillmd.com/u/xiaobai1017)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/xiaobai1017/list-pull-requests

---


# list_pull_requests

List and filter repository pull requests

## Purpose

This skill provides access to the MCP tool `list_pull_requests`. It allows you to list and filter repository pull requests.

## Parameters

The tool accepts the following parameters:

### `owner`
**Required**
- **Type**: `string`
- **Description**: Repository owner (username or organization)

### `repo`
**Required**
- **Type**: `string`
- **Description**: Repository name

### `state`
*Optional*
- **Type**: `string`
- **Description**: State of the pull requests to return
- **Allowed values**: open, closed, all

### `head`
*Optional*
- **Type**: `string`
- **Description**: Filter by head user or head organization and branch name

### `base`
*Optional*
- **Type**: `string`
- **Description**: Filter by base branch name

### `sort`
*Optional*
- **Type**: `string`
- **Description**: What to sort results by
- **Allowed values**: created, updated, popularity, long-running

### `direction`
*Optional*
- **Type**: `string`
- **Description**: The direction of the sort
- **Allowed values**: asc, desc

### `per_page`
*Optional*
- **Type**: `number`
- **Description**: Results per page (max 100)

### `page`
*Optional*
- **Type**: `number`
- **Description**: Page number of the results


## Usage Instructions

To use this tool:

1. **Prepare the parameters** according to the schema above
2. **Invoke the MCP tool** `list_pull_requests` with the prepared parameters
3. **Process the result** returned by the tool

## Example

```json
{
  "owner": "example_value",
  "repo": "example_value",
  "state": "example_value",
  "head": "example_value",
  "base": "example_value",
  "sort": "example_value",
  "direction": "example_value",
  "per_page": 123,
  "page": 123
}
```


## Notes

- This skill requires an active MCP connection to the server providing the `list_pull_requests` tool
- Ensure the MCP server is properly configured and running before attempting to use this tool
- Review the parameter requirements carefully to avoid errors