set_agent_metadata

Record one fact about an agent's work under a key of your choosing, keyed by the agent's id, or clear that key by omitting the value.

AgentwritesidempotentMCP tool

Use this on yourself as you work, whenever you learn something a person would want to jump to later: the Linear issue you are implementing, the branch you are on. Your own id is in the KOMRAD_AGENT_ID environment variable. Store the full URL rather than a bare number, since the panel shows the value as it is. Keys are lowercase letters, digits, underscores, and dashes; call this once per key, which leaves every other key on the agent untouched. The key pr is refused: pull requests are read from the forge and shown on the row, so there is nothing to record. Do not record what the agent is currently doing, which is already its state, and do not paste findings here, which belong in your reply.

Calling it#

curl -X POST http://127.0.0.1:8787/agent.v1.AgentService/SetMetadata \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>"
}'

komrad rpc set-agent-metadata \
  --id <string>

{
  "name": "set_agent_metadata",
  "arguments": {
    "id": "<id>"
  }
}

Offered by the komrad MCP server to implementer, reviewer, orchestrator agents.

Request#

SetMetadataRequest#

Field Type Description

Field	Type	Description
`id`	string	Which agent the fact is about, which an agent recording its own work reads from KOMRAD_AGENT_ID. required
`key`	string	What to file it under, leaving every other key on the agent untouched. at most 64 characters
`value`	string	The fact as the panel will show it, left out to clear the key.

id

string

Which agent the fact is about, which an agent recording its own work reads from KOMRAD_AGENT_ID.

required

key

string

What to file it under, leaving every other key on the agent untouched.

at most 64 characters

value

string

The fact as the panel will show it, left out to clear the key.

Response#

Empty#

No fields.