list_pull_requests

List pull requests (merge requests) in a project. Requires at least Viewer role. state filter: ‘open’ (default), ‘closed’, or ‘all’. Results are capped at limit (default 25, max 50). When there are more PRs than limit, truncated=true is returned.

read-only · idempotent

Parameters

Name	Type	Required	Default	Description
project_name	Annotated[str, Field(description='Name of the Bridge Town project.')]	Yes	—
state	Annotated[Literal['open', 'closed', 'all'], Field(description="Filter by state: 'open' (default), 'closed', or 'all'.")]	No	'open'
limit	Annotated[int, Field(description='Maximum number of PRs to return. Defaults to 25, clamped to [1, 50]. When the project has more PRs than limit, truncated=true is set.')]	No	25

Returns

Returns a structured object. Top-level fields:

• project (string)
• state (string)
• pull_requests (array<object>)
• count (integer)

See the response example below for the full payload shape.

Example

Tool Call

{
  "name": "list_pull_requests",
  "arguments": {
    "project_name": "forecasts",
    "state": "open"
  }
}

Response

{
  "project": "forecasts",
  "state": "open",
  "pull_requests": [
    {
      "id": 42,
      "title": "Aggressive growth scenario",
      "head_branch": "scenario/aggressive-growth",
      "base_branch": "main",
      "state": "open",
      "author": "alice@example.com",
      "created_at": "2026-04-28T10:00:00+00:00"
    }
  ],
  "count": 1
}

Notes

• Module: Pull Requests
• Requires authentication via API token or Auth0 JWT.