# list\_forges

List the forges komrad is connected to and the account komrad uses on each.

read-only · idempotent · MCP tool · [Forge](https://komrad.dev/latest/api/forge.md)

Tokens are never returned.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/ListForges \
  -H 'Content-Type: application/json' \
  -d '{}'
```

```bash
komrad rpc list-forges
```

```json
{
  "name": "list_forges",
  "arguments": {}
}
```

Offered by the komrad MCP server to orchestrator agents.

## Request

### Empty

No fields.

## Response

### ListForgesResponse

| Field | Type | Description |
| --- | --- | --- |
| [`forges`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-ListForgesResponse-forges) | [Forge\[\]](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge) | Every connection, by host. |

## Types

### Forge

Forge is komrad's connection to one forge host and the credential komrad uses there.

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-id) | uuid\* | The connection's id. |
| [`kind`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-kind) | [Kind](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Kind) | The kind of forge the host runs. |
| [`host`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-host) | string | The host that git remotes name, such as `github.com`. |
| [`api_url`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-api_url) | string | The address of an enterprise host's API. Empty for the public forge. |
| [`method`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-method) | [CredentialMethod](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-CredentialMethod) | How the credential was given. |
| [`login`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-login) | string | The account the forge says the credential belongs to, a user login or an App's name. |
| [`verified_at`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-verified_at) | timestamp | When the forge last accepted the credential. Unset once the forge refuses it. |
| [`has_credential`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-has_credential) | bool | Whether this machine still has the credential. A `token` connection needs its token file, and a `github_app` connection always has its credential. |
| [`created_at`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Forge-created_at) | timestamp | When the connection was created. |

### Kind

Kind is the kind of forge a host runs.

| Value | Description |
| --- | --- |
| [`github`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Kind-github) | GitHub, or a GitHub Enterprise host. |
| [`gitlab`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-Kind-gitlab) | GitLab, or a self-managed GitLab host. |

### CredentialMethod

CredentialMethod is how a forge connection's credential is given.

| Value | Description |
| --- | --- |
| [`token`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-CredentialMethod-token) | A token the person supplied. |
| [`rotating-token`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-CredentialMethod-rotating-token) | A GitLab token that komrad rotates before it expires. |
| [`github-app`](https://komrad.dev/latest/api/forge/list-forges.md#komrad-forge-v1-CredentialMethod-github-app) | A token minted from the GitHub App in the server's config. |
