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>"
}'komrad rpc list-forge-pull-requests \
--remote-url '<string>'{
"name": "list_forge_pull_requests",
"arguments": {
"remote_url": "<remote_url>"
}
}Offered by the komrad MCP server to orchestrator agents.
Request#
ListForgePullRequestsRequest#
| Field | Type | Description |
|---|---|---|
remote_url | string* at most 2048 characters | The repository's git remote, such as |
branch | string at most 512 characters | The branch whose pull requests to list, in any state. Empty lists the repository's open pull requests. |
pagination | Pagination | The page to read. The page size defaults to twenty and is at most a hundred. |
Response#
ListForgePullRequestsResponse#
| Field | Type | Description |
|---|---|---|
pull_requests | ForgePullRequest[] | One page of pull requests, in the forge's order. |
next_page_token | string | The cursor for the next page. Unset on the last page. |
Types#
Pagination#
Pagination selects one page of a listing.
ForgePullRequest#
ForgePullRequest is a pull request as the forge describes it, read live and not kept.
| Field | Type | Description |
|---|---|---|
forge | Kind | The kind of forge the pull request is on. |
provider_id | string | The forge's own stable id for the pull request, such as GitHub's |
url | string | The pull request's web address. |
repository_url | string | The web address of the repository the pull request merges into. |
head_repository_url | string | The web address of the repository the pull request's branch is in. Empty when the forge no longer has that repository. |
number | int32 | The pull request's number, unique within its repository. |
title | string | The pull request's title. |
head_branch | string | The branch the pull request merges from. |
head_sha | string | The commit at the tip of the pull request's branch. |
base_branch | string | The branch the pull request merges into. |
base_sha | string | The commit at the tip of the branch the pull request merges into. |
draft | bool | Whether the pull request is a draft. |
state | string | The state the forge reports, |
created_at | timestamp | When the pull request was opened. |
updated_at | timestamp | When the pull request last changed on the forge. |
merged_at | timestamp | When the pull request merged. Unset until the pull request merges. |
closed_at | timestamp | 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.