`gh_list_pulls`

Pack: github_private · Endpoint: https://gateway.pipeworx.io/github_private/mcp

List pull requests in a repository. Specify owner and repo name (e.g., owner=‘octocat’, repo=‘Hello-World’). Returns titles, numbers, status, reviewers, and merge state.

Parameters

Name	Type	Required	Description
`owner`	string	yes	Repository owner
`repo`	string	yes	Repository name
`state`	string	no	Filter: open, closed, all (default: open)
`per_page`	number	no	Results per page (max 100)

Example call

Arguments

{
  "owner": "octocat",
  "repo": "Hello-World",
  "state": "open"
}

curl

curl -X POST https://gateway.pipeworx.io/github_private/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"gh_list_pulls","arguments":{"owner":"octocat","repo":"Hello-World","state":"open"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('gh_list_pulls', {
  "owner": "octocat",
  "repo": "Hello-World",
  "state": "open"
});

More examples

{
  "owner": "octocat",
  "repo": "Hello-World",
  "state": "all",
  "per_page": 30
}

Response shape

Full JSON Schema

{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "id": {
        "type": "number",
        "description": "Pull request ID"
      },
      "number": {
        "type": "number",
        "description": "Pull request number"
      },
      "title": {
        "type": "string",
        "description": "Pull request title"
      },
      "state": {
        "type": "string",
        "description": "Pull request state (open or closed)"
      },
      "body": {
        "type": [
          "string",
          "null"
        ],
        "description": "Pull request description"
      },
      "user": {
        "type": "object",
        "properties": {
          "login": {
            "type": "string",
            "description": "User login"
          },
          "id": {
            "type": "number",
            "description": "User ID"
          }
        }
      },
      "head": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "description": "Branch name"
          },
          "sha": {
            "type": "string",
            "description": "Commit SHA"
          }
        }
      },
      "base": {
        "type": "object",
        "properties": {
          "ref": {
            "type": "string",
            "description": "Base branch name"
          },
          "sha": {
            "type": "string",
            "description": "Base commit SHA"
          }
        }
      },
      "merged": {
        "type": "boolean",
        "description": "Whether PR is merged"
      },
      "mergeable": {
        "type": [
          "boolean",
          "null"
        ],
        "description": "Whether PR can be merged"
      },
      "created_at": {
        "type": "string",
        "description": "ISO timestamp of creation"
      },
      "updated_at": {
        "type": "string",
        "description": "ISO timestamp of last update"
      },
      "html_url": {
        "type": "string",
        "description": "Pull request web URL"
      }
    }
  }
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "github_private": {
      "url": "https://gateway.pipeworx.io/github_private/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

gh_list_pulls