Skip to main content
Glama
Sign In

aictrl

by dev.aictrl
OverviewDiscussionsAdmin

Check aictrl account readiness

get_started
Read-only

Use this when a user wants to start using aictrl, asks what they can do with their account, or attempts a repository action whose setup prerequisites are unknown. Returns current readiness and the single best next action. Do not use for general product questions or when repository readiness is already known in the current turn.

Input Schema

NameRequiredDescriptionDefault
intentNoOptional allow-listed intent recorded for setup action selection only.
connection_idNoOptional exact repository connection read selection; requires organization_id.
organization_idNoOptional organization read selection; current membership is checked.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "$schema": "http://json-schema.org/draft-07/schema#",
-    "additionalProperties": false,
-    "properties": {
-      "next_action": {
-        "enum": [
-          "choose_organization",
-          "connect_repository",
-          "choose_repository",
-          "view_execution",
-          "view_result",
-          "retry_status",
-          "resolve_blocker",
-          "review_pull_request",
-          "open_pull_request",
-          "automatic_review_ready",
-          "manage_automatic_review",
-          "choose_task"
-        ],
-        "type": "string"
-      },
-      "recommended_action": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false,
-                "type": "boolean"
-              },
-              "label": {
-                "maxLength": 160,
-                "minLength": 1,
-                "type": "string"
-              },
-              "reason": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": {
-                "const": "link",
-                "type": "string"
-              },
-              "url": {
-                "format": "uri",
-                "maxLength": 5000,
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "url",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false,
-                "type": "boolean"
-              },
-              "label": {
-                "maxLength": 160,
-                "minLength": 1,
-                "type": "string"
-              },
-              "organization_id": {
-                "pattern": "^[A-Za-z0-9_-]{1,128}$",
-                "type": "string"
-              },
-              "reason": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "repository_full_name": {
-                "pattern": "^(?!\\.{1,2}\\/)[A-Za-z0-9_.-]+\\/(?!\\.{1,2}$)[A-Za-z0-9_.-]+$",
-                "type": "string"
-              },
-              "tool": {
-                "const": "list_tasks",
-                "type": "string"
-              },
-              "type": {
-                "const": "tool",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "tool",
-              "organization_id",
-              "repository_full_name",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false,
-                "type": "boolean"
-              },
-              "label": {
-                "maxLength": 160,
-                "minLength": 1,
-                "type": "string"
-              },
-              "reason": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": {
-                "const": "retry",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false,
-                "type": "boolean"
-              },
-              "label": {
-                "maxLength": 160,
-                "minLength": 1,
-                "type": "string"
-              },
-              "reason": {
-                "maxLength": 500,
-                "minLength": 1,
-                "type": "string"
-              },
-              "type": {
-                "const": "information",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "schema_version": {
-        "const": 1,
-        "type": "number"
-      },
-      "status": {
-        "const": "onboarding",
-        "type": "string"
-      },
-      "summary": {
-        "maxLength": 500,
-        "minLength": 1,
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "schema_version",
-      "summary",
-      "next_action",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "onboarding_link"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "url",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "setup_required"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ready_repositories": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "display_name": {
-              "type": "string"
-            },
-            "executor_ready": {
-              "type": "boolean"
-            },
-            "organization_name": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "organization_name",
-            "display_name",
-            "executor_ready"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "minItems": 1,
-        "type": "array"
-      },
-      "ready_repository_count": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "recommended_action": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "organization_id": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "tool": {
-                "const": "query_context"
-              },
-              "type": {
-                "const": "tool"
-              }
-            },
-            "required": [
-              "type",
-              "tool",
-              "organization_id",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "organization_id": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "repository_full_name": {
-                "type": "string"
-              },
-              "tool": {
-                "const": "list_tasks"
-              },
-              "type": {
-                "const": "tool"
-              }
-            },
-            "required": [
-              "type",
-              "tool",
-              "organization_id",
-              "repository_full_name",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "type": {
-                "const": "retry"
-              }
-            },
-            "required": [
-              "type",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "type": {
-                "const": "onboarding_link"
-              },
-              "url": {
-                "format": "uri",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "url",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "status": {
-        "const": "ready"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "ready_repository_count",
-      "ready_repositories",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "repair_link"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "url",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "action_required"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "retry"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "retryable": {
-        "const": true
-      },
-      "status": {
-        "const": "temporarily_unavailable"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "retryable",
-      "recommended_action"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "additionalProperties": false,
+    "properties": {
+      "next_action": {
+        "enum": [
+          "choose_organization",
+          "connect_repository",
+          "choose_repository",
+          "view_execution",
+          "view_result",
+          "retry_status",
+          "resolve_blocker",
+          "automatic_review_ready",
+          "manage_automatic_review"
+        ],
+        "type": "string"
+      },
+      "recommended_action": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "link",
+                "type": "string"
+              },
+              "url": {
+                "format": "uri",
+                "maxLength": 5000,
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "url",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "retry",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "information",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "schema_version": {
+        "const": 1,
+        "type": "number"
+      },
+      "status": {
+        "const": "onboarding",
+        "type": "string"
+      },
+      "summary": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "schema_version",
+      "summary",
+      "next_action",
+      "recommended_action"
+    ],
+    "type": "object"
+  },
+  {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "additionalProperties": false,
+    "properties": {
+      "recommended_action": {
+        "additionalProperties": false,
+        "properties": {
+          "after_completion": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "automatic_changes": {
+            "const": false,
+            "type": "boolean"
+          },
+          "label": {
+            "maxLength": 160,
+            "minLength": 1,
+            "type": "string"
+          },
+          "reason": {
+            "maxLength": 500,
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": {
+            "const": "retry",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "reason",
+          "after_completion",
+          "automatic_changes"
+        ],
+        "type": "object"
+      },
+      "retryable": {
+        "const": true,
+        "type": "boolean"
+      },
+      "status": {
+        "const": "temporarily_unavailable",
+        "type": "string"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "summary",
+      "retryable",
+      "recommended_action"
+    ],
+    "type": "object"
+  }
+]
  2. Changed3 schema fields changed
    • addedInput schema / properties / connection_id
      Added value: +{
+  "description": "Optional exact repository connection read selection; requires organization_id.",
+  "pattern": "^[A-Za-z0-9_-]{1,128}$",
+  "type": "string"
+}
    • addedInput schema / properties / organization_id
      Added value: +{
+  "description": "Optional organization read selection; current membership is checked.",
+  "pattern": "^[A-Za-z0-9_-]{1,128}$",
+  "type": "string"
+}
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "onboarding_link"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "url",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "setup_required"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "ready_repositories": {
-        "items": {
-          "additionalProperties": false,
-          "properties": {
-            "display_name": {
-              "type": "string"
-            },
-            "executor_ready": {
-              "type": "boolean"
-            },
-            "organization_name": {
-              "type": "string"
-            }
-          },
-          "required": [
-            "organization_name",
-            "display_name",
-            "executor_ready"
-          ],
-          "type": "object"
-        },
-        "maxItems": 3,
-        "minItems": 1,
-        "type": "array"
-      },
-      "ready_repository_count": {
-        "minimum": 1,
-        "type": "integer"
-      },
-      "recommended_action": {
-        "oneOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "organization_id": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "tool": {
-                "const": "query_context"
-              },
-              "type": {
-                "const": "tool"
-              }
-            },
-            "required": [
-              "type",
-              "tool",
-              "organization_id",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "organization_id": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "repository_full_name": {
-                "type": "string"
-              },
-              "tool": {
-                "const": "list_tasks"
-              },
-              "type": {
-                "const": "tool"
-              }
-            },
-            "required": [
-              "type",
-              "tool",
-              "organization_id",
-              "repository_full_name",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "type": {
-                "const": "retry"
-              }
-            },
-            "required": [
-              "type",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          },
-          {
-            "additionalProperties": false,
-            "properties": {
-              "after_completion": {
-                "type": "string"
-              },
-              "automatic_changes": {
-                "const": false
-              },
-              "label": {
-                "type": "string"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "type": {
-                "const": "onboarding_link"
-              },
-              "url": {
-                "format": "uri",
-                "type": "string"
-              }
-            },
-            "required": [
-              "type",
-              "url",
-              "label",
-              "reason",
-              "after_completion",
-              "automatic_changes"
-            ],
-            "type": "object"
-          }
-        ]
-      },
-      "status": {
-        "const": "ready"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "ready_repository_count",
-      "ready_repositories",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "repair_link"
-          },
-          "url": {
-            "format": "uri",
-            "type": "string"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "url",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "const": "action_required"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "recommended_action"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "recommended_action": {
-        "additionalProperties": false,
-        "properties": {
-          "after_completion": {
-            "type": "string"
-          },
-          "automatic_changes": {
-            "const": false
-          },
-          "label": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "type": {
-            "const": "retry"
-          }
-        },
-        "required": [
-          "type",
-          "label",
-          "reason",
-          "after_completion",
-          "automatic_changes"
-        ],
-        "type": "object"
-      },
-      "retryable": {
-        "const": true
-      },
-      "status": {
-        "const": "temporarily_unavailable"
-      },
-      "summary": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "summary",
-      "retryable",
-      "recommended_action"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "$schema": "http://json-schema.org/draft-07/schema#",
+    "additionalProperties": false,
+    "properties": {
+      "next_action": {
+        "enum": [
+          "choose_organization",
+          "connect_repository",
+          "choose_repository",
+          "view_execution",
+          "view_result",
+          "retry_status",
+          "resolve_blocker",
+          "review_pull_request",
+          "open_pull_request",
+          "automatic_review_ready",
+          "manage_automatic_review",
+          "choose_task"
+        ],
+        "type": "string"
+      },
+      "recommended_action": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "link",
+                "type": "string"
+              },
+              "url": {
+                "format": "uri",
+                "maxLength": 5000,
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "url",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "organization_id": {
+                "pattern": "^[A-Za-z0-9_-]{1,128}$",
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "repository_full_name": {
+                "pattern": "^(?!\\.{1,2}\\/)[A-Za-z0-9_.-]+\\/(?!\\.{1,2}$)[A-Za-z0-9_.-]+$",
+                "type": "string"
+              },
+              "tool": {
+                "const": "list_tasks",
+                "type": "string"
+              },
+              "type": {
+                "const": "tool",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "tool",
+              "organization_id",
+              "repository_full_name",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "retry",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false,
+                "type": "boolean"
+              },
+              "label": {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              "reason": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "type": {
+                "const": "information",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "schema_version": {
+        "const": 1,
+        "type": "number"
+      },
+      "status": {
+        "const": "onboarding",
+        "type": "string"
+      },
+      "summary": {
+        "maxLength": 500,
+        "minLength": 1,
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "schema_version",
+      "summary",
+      "next_action",
+      "recommended_action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "recommended_action": {
+        "additionalProperties": false,
+        "properties": {
+          "after_completion": {
+            "type": "string"
+          },
+          "automatic_changes": {
+            "const": false
+          },
+          "label": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "type": {
+            "const": "onboarding_link"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "url",
+          "reason",
+          "after_completion",
+          "automatic_changes"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "setup_required"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "summary",
+      "recommended_action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "ready_repositories": {
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "display_name": {
+              "type": "string"
+            },
+            "executor_ready": {
+              "type": "boolean"
+            },
+            "organization_name": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "organization_name",
+            "display_name",
+            "executor_ready"
+          ],
+          "type": "object"
+        },
+        "maxItems": 3,
+        "minItems": 1,
+        "type": "array"
+      },
+      "ready_repository_count": {
+        "minimum": 1,
+        "type": "integer"
+      },
+      "recommended_action": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false
+              },
+              "label": {
+                "type": "string"
+              },
+              "organization_id": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "tool": {
+                "const": "query_context"
+              },
+              "type": {
+                "const": "tool"
+              }
+            },
+            "required": [
+              "type",
+              "tool",
+              "organization_id",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false
+              },
+              "label": {
+                "type": "string"
+              },
+              "organization_id": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "repository_full_name": {
+                "type": "string"
+              },
+              "tool": {
+                "const": "list_tasks"
+              },
+              "type": {
+                "const": "tool"
+              }
+            },
+            "required": [
+              "type",
+              "tool",
+              "organization_id",
+              "repository_full_name",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false
+              },
+              "label": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "type": {
+                "const": "retry"
+              }
+            },
+            "required": [
+              "type",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "after_completion": {
+                "type": "string"
+              },
+              "automatic_changes": {
+                "const": false
+              },
+              "label": {
+                "type": "string"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "type": {
+                "const": "onboarding_link"
+              },
+              "url": {
+                "format": "uri",
+                "type": "string"
+              }
+            },
+            "required": [
+              "type",
+              "url",
+              "label",
+              "reason",
+              "after_completion",
+              "automatic_changes"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "status": {
+        "const": "ready"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "summary",
+      "ready_repository_count",
+      "ready_repositories",
+      "recommended_action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "recommended_action": {
+        "additionalProperties": false,
+        "properties": {
+          "after_completion": {
+            "type": "string"
+          },
+          "automatic_changes": {
+            "const": false
+          },
+          "label": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "type": {
+            "const": "repair_link"
+          },
+          "url": {
+            "format": "uri",
+            "type": "string"
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "url",
+          "reason",
+          "after_completion",
+          "automatic_changes"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "const": "action_required"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "summary",
+      "recommended_action"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "recommended_action": {
+        "additionalProperties": false,
+        "properties": {
+          "after_completion": {
+            "type": "string"
+          },
+          "automatic_changes": {
+            "const": false
+          },
+          "label": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "type": {
+            "const": "retry"
+          }
+        },
+        "required": [
+          "type",
+          "label",
+          "reason",
+          "after_completion",
+          "automatic_changes"
+        ],
+        "type": "object"
+      },
+      "retryable": {
+        "const": true
+      },
+      "status": {
+        "const": "temporarily_unavailable"
+      },
+      "summary": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "summary",
+      "retryable",
+      "recommended_action"
+    ],
+    "type": "object"
+  }
+]
  3. First observed

TDQS

A3.9/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true, destructiveHint=false and openWorldHint=true, so safety is covered. The description adds real behavioral context beyond that: it is a diagnostic that evaluates prerequisites and collapses the result into a single recommended next action, and it warns against redundant calls. It stops short of describing latency, caching, or auth requirements.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences, all load-bearing: trigger conditions first, return shape second, exclusions last. The opening sentence is a long run-on list but carries only necessary conditions, with no filler or restatement of the title.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present, return values need not be spelled out, and the description still summarizes the return ('readiness and the single best next action'). Parameters are fully covered by the schema, so the only gap is the absence of a named fallback tool for the excluded cases.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% with only three optional parameters, each already documented in the schema including the intent enum and the organization_id dependency for connection_id. The description adds no parameter-level meaning, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a concrete resource and outcome: it 'Returns current readiness and the single best next action' for an aictrl account. That is specific enough to separate it from workflow/task siblings, though it never names a sibling tool explicitly to sharpen the contrast.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Three concrete triggers are given (user wants to start, asks what the account can do, or hits an action with unknown setup prerequisites) plus two exclusions (general product questions, readiness already known this turn). The only missing piece is naming the alternative tool to use instead of this one.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All aictrl toolsInspect
Try in Browser
Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources