list_forges
List the forges komrad is connected to and the account komrad uses on each.
read-onlyidempotentMCP toolForge
Tokens are never returned.
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/ListForges \
-H 'Content-Type: application/json' \
-d '{}'komrad rpc list-forges{
"name": "list_forges",
"arguments": {}
}Offered by the komrad MCP server to orchestrator agents.
Request#
Empty#
No fields.
Response#
ListForgesResponse#
Types#
Forge#
Forge is komrad's connection to one forge host and the credential komrad uses there.
| Field | Type | Description |
|---|---|---|
id | uuid* | The connection's id. |
kind | Kind | The kind of forge the host runs. |
host | string | The host that git remotes name, such as |
api_url | string | The address of an enterprise host's API. Empty for the public forge. |
method | CredentialMethod | How the credential was given. |
login | string | The account the forge says the credential belongs to, a user login or an App's name. |
verified_at | timestamp | When the forge last accepted the credential. Unset once the forge refuses it. |
has_credential | bool | Whether this machine still has the credential. A |
created_at | timestamp | When the connection was created. |
Kind#
Kind is the kind of forge a host runs.
CredentialMethod#
CredentialMethod is how a forge connection's credential is given.
| Value | Description |
|---|---|
token | A token the person supplied. |
rotating-token | A GitLab token that komrad rotates before it expires. |
github-app | A token minted from the GitHub App in the server's config. |