Skip to main content
Glama

set_status

Set status key-value pairs for AI agents in terminal multiplexer workspaces to display agent states and progress indicators.

Instructions

Set a sidebar status key-value pair

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
keyYesStatus key
valueYesStatus value
workspaceNoTarget workspace ref
surfaceNoTarget surface ref
iconNoIcon name
colorNoHex color

Implementation Reference

  • The handler function for the 'set_status' MCP tool in src/server.ts, which validates the key and calls the underlying client.setStatus method.
    async (args) => {
      try {
        parseReservedModeKey(args.key, args.value);
        await client.setStatus(args.key, args.value, {
          icon: args.icon,
          color: args.color,
          workspace: args.workspace,
          surface: args.surface,
        });
        return ok({
          key: args.key,
          value: args.value,
          applied: "set_status",
        });
      } catch (e) {
        return err(e);
  • Input validation schema for the 'set_status' MCP tool.
    {
      key: z.string().describe("Status key"),
      value: z.string().describe("Status value"),
      workspace: z.string().optional().describe("Target workspace ref"),
      surface: z.string().optional().describe("Target surface ref"),
      icon: z.string().max(8).optional().describe("Icon name"),
      color: z
        .string()
        .regex(/^#[0-9a-fA-F]{6}$/)
        .optional()
        .describe("Hex color"),
    },
  • src/server.ts:424-426 (registration)
    Registration of the 'set_status' tool using the server.tool method.
    server.tool(
      "set_status",
      "Set a sidebar status key-value pair",

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/EtanHey/cmuxlayer'

If you have feedback or need assistance with the MCP directory API, please join our Discord server