komrad

list_forge_pull_requests

List a repository's pull requests from its forge: every one from a branch, or the open ones.

read-onlyidempotentMCP toolForge

list_pull_requests lists the ones komrad has recorded instead.

Calling it#

curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/ListForgePullRequests \
  -H 'Content-Type: application/json' \
  -d '{
  "remote_url": "<remote_url>"
}'

Request#

ListForgePullRequestsRequest#

FieldTypeDescription
remote_urlstring*

at most 2048 characters

The repository's git remote, such as git@github.com:owner/repo.git or https://github.com/owner/repo. The remote's host picks the forge connection.

branchstring

at most 512 characters

The branch whose pull requests to list, in any state. Empty lists the repository's open pull requests.

paginationPagination

The page to read. The page size defaults to twenty and is at most a hundred.

Response#

ListForgePullRequestsResponse#

FieldTypeDescription
pull_requestsForgePullRequest[]

One page of pull requests, in the forge's order.

next_page_tokenstring

The cursor for the next page. Unset on the last page.

Types#

Pagination#

Pagination selects one page of a listing.

FieldTypeDescription
limitint32

at least 0

How many records to return. Komrad caps the value, and picks one when unset.

cursorstring

at most 2048 characters

The next_page_token from the previous response. Unset to start from the first page.

ForgePullRequest#

ForgePullRequest is a pull request as the forge describes it, read live and not kept.

FieldTypeDescription
forgeKind

The kind of forge the pull request is on.

provider_idstring

The forge's own stable id for the pull request, such as GitHub's node_id.

urlstring

The pull request's web address.

repository_urlstring

The web address of the repository the pull request merges into.

head_repository_urlstring

The web address of the repository the pull request's branch is in. Empty when the forge no longer has that repository.

numberint32

The pull request's number, unique within its repository.

titlestring

The pull request's title.

head_branchstring

The branch the pull request merges from.

head_shastring

The commit at the tip of the pull request's branch.

base_branchstring

The branch the pull request merges into.

base_shastring

The commit at the tip of the branch the pull request merges into.

draftbool

Whether the pull request is a draft.

statestring

The state the forge reports, OPEN, CLOSED or MERGED.

created_attimestamp

When the pull request was opened.

updated_attimestamp

When the pull request last changed on the forge.

merged_attimestamp

When the pull request merged. Unset until the pull request merges.

closed_attimestamp

When the pull request closed, merged or not. Unset while the pull request is open.

Kind#

Kind is the kind of forge a host runs.

ValueDescription
github

GitHub, or a GitHub Enterprise host.

gitlab

GitLab, or a self-managed GitLab host.