Skip to main content
Glama
Sign In

DSAIL

by ai.jaxon
OverviewDiscussionsAdmin

Account status and allowance

dsail_get_account_status
Read-onlyIdempotent

Know how much of this credential's allowance is used before a limit interrupts a check.

Use when an upcoming check could be interrupted by the account's allowance limit and the caller needs to see usage first.

This account's entitlement and usage position. usage is the meter that refuses the next check — used, limit and remaining — and stub: false means it is enforced. Only checks are metered; compiling, editing, saving, loading and approving rulesets are free and stay free at any limit. When the tier is gated the payload carries plans_url, the address of a page describing the available plans. Also reports the current application-domain vocabulary version, whether this account may label rulesets, how many API keys it may still issue, and terms — the terms-of-service version that governs this tier with the URLs of the terms, privacy and data-handling pages. account.project is an internal identifier that names nothing a user would recognise. account.organizations lists the owner of the workspace currently in use (a team id while working in a team), not the teams the user belongs to; the workspace listing is where those are.

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "description": "This account's tier, usage against its allowance, and the terms version that governs it.",
-    "properties": {
-      "ok": {
-        "const": true,
-        "type": "boolean"
-      },
-      "terms": {
-        "type": "object"
-      },
-      "tier": {
-        "type": "string"
-      },
-      "versions": {
-        "description": "Which engine and which wire contract produced this response.",
-        "properties": {
-          "engine": {
-            "example": "dsail-core",
-            "type": "string"
-          },
-          "engine_version": {
-            "type": "string"
-          },
-          "language_version": {
-            "description": "DSAIL language version.",
-            "type": "string"
-          },
-          "service_version": {
-            "type": "string"
-          },
-          "supported_language_versions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "wire_version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "engine",
-          "engine_version",
-          "language_version",
-          "service_version",
-          "wire_version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "error": {
-        "properties": {
-          "actual": {
-            "description": "How much the request used, where that is known. Absent for solver_memory_mb: the solver stops at the limit.",
-            "type": "integer"
-          },
-          "budget": {
-            "type": "string"
-          },
-          "code": {
-            "enum": [
-              "VALIDATION_REJECTED",
-              "COMPILE_FAILED",
-              "BUDGET_EXCEEDED",
-              "RULESET_NOT_FOUND",
-              "ENGINE_ERROR",
-              "ENGINE_BUSY",
-              "BAD_REQUEST",
-              "CREDENTIAL_REQUIRED",
-              "CREDENTIAL_INVALID",
-              "CREDENTIAL_SCOPE",
-              "EVALUATION_LIMIT",
-              "ENTITLEMENT_EXCEEDED",
-              "TIER_UNAVAILABLE"
-            ],
-            "type": "string"
-          },
-          "diagnostics": {
-            "items": {
-              "properties": {
-                "line": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "severity": {
-                  "enum": [
-                    "error",
-                    "warning"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "severity",
-                "message"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "docs": {
-            "description": "The docs-site page that resolves this code (markdown). Fetch it before retrying blind.",
-            "format": "uri",
-            "type": "string"
-          },
-          "failure_count": {
-            "description": "How many fields failed in total. Equal to the length of `failures` unless a very large rejection was truncated, which the message says.",
-            "type": "integer"
-          },
-          "failures": {
-            "description": "EVERY failing field, not the first one.",
-            "items": {
-              "properties": {
-                "expected": {
-                  "type": "string"
-                },
-                "field": {
-                  "type": "string"
-                },
-                "received": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "field",
-                "expected",
-                "received"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "hint": {
-            "description": "The grammar guide, carried on compile failures so the next call can succeed without a human.",
-            "type": "string"
-          },
-          "limit": {
-            "type": "integer"
-          },
-          "message": {
-            "type": "string"
-          },
-          "retry_after_ms": {
-            "description": "ENGINE_BUSY only: when to retry. The REST door also sends it, in seconds, as Retry-After.",
-            "type": "integer"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "ok": {
-        "const": false,
-        "type": "boolean"
-      },
-      "versions": {
-        "description": "Which engine and which wire contract produced this response.",
-        "properties": {
-          "engine": {
-            "example": "dsail-core",
-            "type": "string"
-          },
-          "engine_version": {
-            "type": "string"
-          },
-          "language_version": {
-            "description": "DSAIL language version.",
-            "type": "string"
-          },
-          "service_version": {
-            "type": "string"
-          },
-          "supported_language_versions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "wire_version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "engine",
-          "engine_version",
-          "language_version",
-          "service_version",
-          "wire_version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "error",
-      "versions"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "description": "This account's tier, usage against its allowance, and the terms version that governs it.",
+    "properties": {
+      "account": {
+        "properties": {
+          "organizations": {
+            "description": "The owner of the workspace currently in use (a team id while working in a team). Not the teams the user belongs to: `dsail_list_workspaces` lists those.",
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "ok": {
+        "const": true,
+        "type": "boolean"
+      },
+      "terms": {
+        "type": "object"
+      },
+      "tier": {
+        "type": "string"
+      },
+      "versions": {
+        "description": "Which engine and which wire contract produced this response.",
+        "properties": {
+          "engine": {
+            "example": "dsail-core",
+            "type": "string"
+          },
+          "engine_version": {
+            "type": "string"
+          },
+          "language_version": {
+            "description": "DSAIL language version.",
+            "type": "string"
+          },
+          "service_version": {
+            "type": "string"
+          },
+          "supported_language_versions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "wire_version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "engine",
+          "engine_version",
+          "language_version",
+          "service_version",
+          "wire_version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "error": {
+        "properties": {
+          "actual": {
+            "description": "How much the request used, where that is known. Absent for solver_memory_mb: the solver stops at the limit.",
+            "type": "integer"
+          },
+          "budget": {
+            "type": "string"
+          },
+          "code": {
+            "enum": [
+              "VALIDATION_REJECTED",
+              "COMPILE_FAILED",
+              "BUDGET_EXCEEDED",
+              "RULESET_NOT_FOUND",
+              "ENGINE_ERROR",
+              "ENGINE_BUSY",
+              "BAD_REQUEST",
+              "CREDENTIAL_REQUIRED",
+              "CREDENTIAL_INVALID",
+              "CREDENTIAL_SCOPE",
+              "EVALUATION_LIMIT",
+              "ENTITLEMENT_EXCEEDED",
+              "TIER_UNAVAILABLE"
+            ],
+            "type": "string"
+          },
+          "diagnostics": {
+            "items": {
+              "properties": {
+                "line": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "severity": {
+                  "enum": [
+                    "error",
+                    "warning"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "severity",
+                "message"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "docs": {
+            "description": "The docs-site page that resolves this code (markdown). Fetch it before retrying blind.",
+            "format": "uri",
+            "type": "string"
+          },
+          "failure_count": {
+            "description": "How many fields failed in total. Equal to the length of `failures` unless a very large rejection was truncated, which the message says.",
+            "type": "integer"
+          },
+          "failures": {
+            "description": "EVERY failing field, not the first one.",
+            "items": {
+              "properties": {
+                "expected": {
+                  "type": "string"
+                },
+                "field": {
+                  "type": "string"
+                },
+                "received": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "field",
+                "expected",
+                "received"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "hint": {
+            "description": "The grammar guide, carried on compile failures so the next call can succeed without a human.",
+            "type": "string"
+          },
+          "limit": {
+            "type": "integer"
+          },
+          "message": {
+            "type": "string"
+          },
+          "retry_after_ms": {
+            "description": "ENGINE_BUSY only: when to retry. The REST door also sends it, in seconds, as Retry-After.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "ok": {
+        "const": false,
+        "type": "boolean"
+      },
+      "versions": {
+        "description": "Which engine and which wire contract produced this response.",
+        "properties": {
+          "engine": {
+            "example": "dsail-core",
+            "type": "string"
+          },
+          "engine_version": {
+            "type": "string"
+          },
+          "language_version": {
+            "description": "DSAIL language version.",
+            "type": "string"
+          },
+          "service_version": {
+            "type": "string"
+          },
+          "supported_language_versions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "wire_version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "engine",
+          "engine_version",
+          "language_version",
+          "service_version",
+          "wire_version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "error",
+      "versions"
+    ],
+    "type": "object"
+  }
+]
  2. Changed1 schema field changed
    • changedOutput schema / oneOf
      Previous value: -[
-  {
-    "description": "This account's tier, usage against its allowance, and the terms version that governs it.",
-    "properties": {
-      "ok": {
-        "const": true,
-        "type": "boolean"
-      },
-      "terms": {
-        "type": "object"
-      },
-      "tier": {
-        "type": "string"
-      },
-      "versions": {
-        "description": "Which engine and which wire contract produced this response.",
-        "properties": {
-          "engine": {
-            "example": "dsail-core",
-            "type": "string"
-          },
-          "engine_version": {
-            "type": "string"
-          },
-          "language_version": {
-            "description": "DSAIL language version.",
-            "type": "string"
-          },
-          "service_version": {
-            "type": "string"
-          },
-          "supported_language_versions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "wire_version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "engine",
-          "engine_version",
-          "language_version",
-          "service_version",
-          "wire_version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "error": {
-        "properties": {
-          "actual": {
-            "type": "integer"
-          },
-          "budget": {
-            "type": "string"
-          },
-          "code": {
-            "enum": [
-              "VALIDATION_REJECTED",
-              "COMPILE_FAILED",
-              "BUDGET_EXCEEDED",
-              "RULESET_NOT_FOUND",
-              "ENGINE_ERROR",
-              "BAD_REQUEST",
-              "CREDENTIAL_REQUIRED",
-              "CREDENTIAL_INVALID",
-              "CREDENTIAL_SCOPE",
-              "EVALUATION_LIMIT",
-              "ENTITLEMENT_EXCEEDED",
-              "TIER_UNAVAILABLE"
-            ],
-            "type": "string"
-          },
-          "diagnostics": {
-            "items": {
-              "properties": {
-                "line": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "severity": {
-                  "enum": [
-                    "error",
-                    "warning"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "severity",
-                "message"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "docs": {
-            "description": "The docs-site page that resolves this code (markdown). Fetch it before retrying blind.",
-            "format": "uri",
-            "type": "string"
-          },
-          "failure_count": {
-            "description": "How many fields failed in total. Equal to the length of `failures` unless a very large rejection was truncated, which the message says.",
-            "type": "integer"
-          },
-          "failures": {
-            "description": "EVERY failing field, not the first one.",
-            "items": {
-              "properties": {
-                "expected": {
-                  "type": "string"
-                },
-                "field": {
-                  "type": "string"
-                },
-                "received": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "field",
-                "expected",
-                "received"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "hint": {
-            "description": "The grammar guide, carried on compile failures so the next call can succeed without a human.",
-            "type": "string"
-          },
-          "limit": {
-            "type": "integer"
-          },
-          "message": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "type": "object"
-      },
-      "ok": {
-        "const": false,
-        "type": "boolean"
-      },
-      "versions": {
-        "description": "Which engine and which wire contract produced this response.",
-        "properties": {
-          "engine": {
-            "example": "dsail-core",
-            "type": "string"
-          },
-          "engine_version": {
-            "type": "string"
-          },
-          "language_version": {
-            "description": "DSAIL language version.",
-            "type": "string"
-          },
-          "service_version": {
-            "type": "string"
-          },
-          "supported_language_versions": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "wire_version": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "engine",
-          "engine_version",
-          "language_version",
-          "service_version",
-          "wire_version"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "ok",
-      "error",
-      "versions"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "description": "This account's tier, usage against its allowance, and the terms version that governs it.",
+    "properties": {
+      "ok": {
+        "const": true,
+        "type": "boolean"
+      },
+      "terms": {
+        "type": "object"
+      },
+      "tier": {
+        "type": "string"
+      },
+      "versions": {
+        "description": "Which engine and which wire contract produced this response.",
+        "properties": {
+          "engine": {
+            "example": "dsail-core",
+            "type": "string"
+          },
+          "engine_version": {
+            "type": "string"
+          },
+          "language_version": {
+            "description": "DSAIL language version.",
+            "type": "string"
+          },
+          "service_version": {
+            "type": "string"
+          },
+          "supported_language_versions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "wire_version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "engine",
+          "engine_version",
+          "language_version",
+          "service_version",
+          "wire_version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "error": {
+        "properties": {
+          "actual": {
+            "description": "How much the request used, where that is known. Absent for solver_memory_mb: the solver stops at the limit.",
+            "type": "integer"
+          },
+          "budget": {
+            "type": "string"
+          },
+          "code": {
+            "enum": [
+              "VALIDATION_REJECTED",
+              "COMPILE_FAILED",
+              "BUDGET_EXCEEDED",
+              "RULESET_NOT_FOUND",
+              "ENGINE_ERROR",
+              "ENGINE_BUSY",
+              "BAD_REQUEST",
+              "CREDENTIAL_REQUIRED",
+              "CREDENTIAL_INVALID",
+              "CREDENTIAL_SCOPE",
+              "EVALUATION_LIMIT",
+              "ENTITLEMENT_EXCEEDED",
+              "TIER_UNAVAILABLE"
+            ],
+            "type": "string"
+          },
+          "diagnostics": {
+            "items": {
+              "properties": {
+                "line": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "severity": {
+                  "enum": [
+                    "error",
+                    "warning"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "severity",
+                "message"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "docs": {
+            "description": "The docs-site page that resolves this code (markdown). Fetch it before retrying blind.",
+            "format": "uri",
+            "type": "string"
+          },
+          "failure_count": {
+            "description": "How many fields failed in total. Equal to the length of `failures` unless a very large rejection was truncated, which the message says.",
+            "type": "integer"
+          },
+          "failures": {
+            "description": "EVERY failing field, not the first one.",
+            "items": {
+              "properties": {
+                "expected": {
+                  "type": "string"
+                },
+                "field": {
+                  "type": "string"
+                },
+                "received": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "field",
+                "expected",
+                "received"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "hint": {
+            "description": "The grammar guide, carried on compile failures so the next call can succeed without a human.",
+            "type": "string"
+          },
+          "limit": {
+            "type": "integer"
+          },
+          "message": {
+            "type": "string"
+          },
+          "retry_after_ms": {
+            "description": "ENGINE_BUSY only: when to retry. The REST door also sends it, in seconds, as Retry-After.",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "type": "object"
+      },
+      "ok": {
+        "const": false,
+        "type": "boolean"
+      },
+      "versions": {
+        "description": "Which engine and which wire contract produced this response.",
+        "properties": {
+          "engine": {
+            "example": "dsail-core",
+            "type": "string"
+          },
+          "engine_version": {
+            "type": "string"
+          },
+          "language_version": {
+            "description": "DSAIL language version.",
+            "type": "string"
+          },
+          "service_version": {
+            "type": "string"
+          },
+          "supported_language_versions": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "wire_version": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "engine",
+          "engine_version",
+          "language_version",
+          "service_version",
+          "wire_version"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "ok",
+      "error",
+      "versions"
+    ],
+    "type": "object"
+  }
+]
  3. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "description": "The account's status. On failure `ok` is false and `error` carries `code`, `message` and `docs`, the URL of the page that resolves it.",
+  "oneOf": [
+    {
+      "description": "This account's tier, usage against its allowance, and the terms version that governs it.",
+      "properties": {
+        "ok": {
+          "const": true,
+          "type": "boolean"
+        },
+        "terms": {
+          "type": "object"
+        },
+        "tier": {
+          "type": "string"
+        },
+        "versions": {
+          "description": "Which engine and which wire contract produced this response.",
+          "properties": {
+            "engine": {
+              "example": "dsail-core",
+              "type": "string"
+            },
+            "engine_version": {
+              "type": "string"
+            },
+            "language_version": {
+              "description": "DSAIL language version.",
+              "type": "string"
+            },
+            "service_version": {
+              "type": "string"
+            },
+            "supported_language_versions": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "wire_version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "engine",
+            "engine_version",
+            "language_version",
+            "service_version",
+            "wire_version"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "ok"
+      ],
+      "type": "object"
+    },
+    {
+      "properties": {
+        "error": {
+          "properties": {
+            "actual": {
+              "type": "integer"
+            },
+            "budget": {
+              "type": "string"
+            },
+            "code": {
+              "enum": [
+                "VALIDATION_REJECTED",
+                "COMPILE_FAILED",
+                "BUDGET_EXCEEDED",
+                "RULESET_NOT_FOUND",
+                "ENGINE_ERROR",
+                "BAD_REQUEST",
+                "CREDENTIAL_REQUIRED",
+                "CREDENTIAL_INVALID",
+                "CREDENTIAL_SCOPE",
+                "EVALUATION_LIMIT",
+                "ENTITLEMENT_EXCEEDED",
+                "TIER_UNAVAILABLE"
+              ],
+              "type": "string"
+            },
+            "diagnostics": {
+              "items": {
+                "properties": {
+                  "line": {
+                    "type": [
+                      "integer",
+                      "null"
+                    ]
+                  },
+                  "message": {
+                    "type": "string"
+                  },
+                  "severity": {
+                    "enum": [
+                      "error",
+                      "warning"
+                    ],
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "severity",
+                  "message"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "docs": {
+              "description": "The docs-site page that resolves this code (markdown). Fetch it before retrying blind.",
+              "format": "uri",
+              "type": "string"
+            },
+            "failure_count": {
+              "description": "How many fields failed in total. Equal to the length of `failures` unless a very large rejection was truncated, which the message says.",
+              "type": "integer"
+            },
+            "failures": {
+              "description": "EVERY failing field, not the first one.",
+              "items": {
+                "properties": {
+                  "expected": {
+                    "type": "string"
+                  },
+                  "field": {
+                    "type": "string"
+                  },
+                  "received": {
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "field",
+                  "expected",
+                  "received"
+                ],
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "hint": {
+              "description": "The grammar guide, carried on compile failures so the next call can succeed without a human.",
+              "type": "string"
+            },
+            "limit": {
+              "type": "integer"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "code",
+            "message"
+          ],
+          "type": "object"
+        },
+        "ok": {
+          "const": false,
+          "type": "boolean"
+        },
+        "versions": {
+          "description": "Which engine and which wire contract produced this response.",
+          "properties": {
+            "engine": {
+              "example": "dsail-core",
+              "type": "string"
+            },
+            "engine_version": {
+              "type": "string"
+            },
+            "language_version": {
+              "description": "DSAIL language version.",
+              "type": "string"
+            },
+            "service_version": {
+              "type": "string"
+            },
+            "supported_language_versions": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "wire_version": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "engine",
+            "engine_version",
+            "language_version",
+            "service_version",
+            "wire_version"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "ok",
+        "error",
+        "versions"
+      ],
+      "type": "object"
+    }
+  ],
+  "type": "object"
+}
  4. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already cover safety (readOnly, idempotent, non-destructive). The description adds real behavioral context beyond that: which operations are metered (only checks; compiling/editing/saving/loading/approving are free), what `stub: false` semantics mean, that `plans_url` appears only when gated, and that `account.project` is internal/not user-recognisable. With an output schema present, the remaining descriptive burden is lower, and the added metering semantics are genuinely useful.

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

Conciseness3/5

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

Front-loads the key use case and meter concept well, but the back half is a dense run-on packing many assorted fields (vocabulary version, API key allowance, terms URLs, project identifier, organizations) into long sentences. Some of that detail is useful, but the structure makes it hard to scan and a few items (e.g. the extended disclaimer on organizations) could be trimmed.

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?

The output schema exists so return values needn't be fully explained, yet the description adds helpful semantics for several fields (meter enforcement via `stub`, gated `plans_url`, internal `account.project`, `account.organizations` disambiguation). For a complex status response this is fairly complete, missing mainly a note on what to do when the limit is reached.

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

Parameters4/5

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

Zero parameters, so baseline is 4. The description doesn't need to explain parameters and doesn't waste effort doing so.

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 clearly states the tool reports the account's entitlement and usage position, plus ancillary fields like vocabulary version, labeling permission, API key allowance, and terms. It's a substantive account-status read, though it doesn't explicitly distinguish itself from siblings like dsail_list_workspaces — it only implicitly references that tool when disclaiming what `account.organizations` contains.

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?

The opening two sentences provide clear when-to-use guidance: before an upcoming check that might be interrupted by the allowance limit. It doesn't explicitly say when NOT to use it or name alternatives, but the pre-check scenario is a concrete trigger. The caveat about `account.organizations` and workspace listing hints at routing without stating it explicitly.

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

All DSAIL toolsInspect
Try in Browser
Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources