check_forges
Check that each connected forge still accepts its credential, and record the result on the connection.
writesnot idempotentMCP toolForge
Calling it#
curl -X POST http://127.0.0.1:8787/komrad.forge.v1.ForgeService/CheckForges \
-H 'Content-Type: application/json' \
-d '{}'komrad rpc check-forges{
"name": "check_forges",
"arguments": {}
}Offered by the komrad MCP server to orchestrator agents.
Request#
Empty#
No fields.
Response#
CheckForgesResponse#
| Field | Type | Description |
|---|---|---|
checks | ForgeCheck[] | One check for each connection, in the order |
Types#
ForgeCheck#
ForgeCheck is what one forge said about komrad's credential.
| Field | Type | Description |
|---|---|---|
forge | Forge | The connection checked. |
problem | string | What the forge said was wrong. Empty when the forge accepted the credential. |
problem_kind | ProblemKind | The kind of problem. Unspecified when there is none. |
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. |
ProblemKind#
ProblemKind is the kind of problem a check found with a forge connection.
| Value | Description |
|---|---|
refused | The forge refused the credential. |
no-credential | This machine no longer has the credential. |
unreachable | The forge could not be reached. |
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. |