Skip to main content
Glama

Count Security Playbooks

count_security_playbooks
Read-only

Count Security Playbooks, all or those a filter matches.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "count_security_playbooks"
  }
}

Input Schema

NameRequiredDescriptionDefault
queryNoA field's value, or an operator such as {"_type":"GreaterThan","value":...}. Fields and operators: oneuptime_describe_resource.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / query / description
      Previous value: -"Filter. Each field takes a value (exact match) or an operator, such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."New value: +"A field's value, or an operator such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."
  2. Changed3 schema fields changed
    • changedInput schema / properties / query / additionalProperties
      Previous value: -falseNew value: +true
    • changedInput schema / properties / query / description
      Previous value: -"Optional filter criteria. If omitted, counts all Security Playbooks. Each field accepts a direct value (exact match) or an operator object {\"_type\": \"<Operator>\", \"value\": ...}. Operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween (numbers/dates), Search (partial text), Includes (array of values). Example — items from the last 24 hours: {\"createdAt\": {\"_type\": \"GreaterThan\", \"value\": \"2026-01-01T00:00:00.000Z\"}}."New value: +"Filter. Each field takes a value (exact match) or an operator, such as {\"_type\":\"GreaterThan\",\"value\":...}. Fields and operators: oneuptime_describe_resource."
    • removedInput schema / properties / query / properties
      Removed value: -{
      -  "_id": {
      -    "description": "Query operators for _id field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      -    },
      -    "type": "object"
      -  },
      -  "createdAt": {
      -    "description": "Query operators for createdAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "2023-01-01T00:00:00.000Z"
      -    },
      -    "type": "object"
      -  },
      -  "createdByUserId": {
      -    "description": "Query operators for createdByUserId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      -    },
      -    "type": "object"
      -  },
      -  "deletedAt": {
      -    "description": "Query operators for deletedAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "2023-01-01T00:00:00.000Z"
      -    },
      -    "type": "object"
      -  },
      -  "deletedByUserId": {
      -    "description": "Query operators for deletedByUserId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      -    },
      -    "type": "object"
      -  },
      -  "description": {
      -    "description": "Query operators for description field of type Long Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "example_value_1"
      -    },
      -    "type": "object"
      -  },
      -  "detectionRuleIds": {
      -    "description": "Query operators for detectionRuleIds field of type JSON. Supported operators: EqualTo, NotEqual, IsNull, NotNull",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "example_value_1"
      -    },
      -    "type": "object"
      -  },
      -  "detectionSource": {
      -    "description": "Query operators for detectionSource field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "John Doe"
      -    },
      -    "type": "object"
      -  },
      -  "isEnabled": {
      -    "description": "Query operators for isEnabled field of type Boolean. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": true
      -    },
      -    "type": "object"
      -  },
      -  "lastRunAt": {
      -    "description": "Query operators for lastRunAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "2023-01-01T00:00:00.000Z"
      -    },
      -    "type": "object"
      -  },
      -  "minimumSecurityCasePriorityId": {
      -    "description": "Query operators for minimumSecurityCasePriorityId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      -    },
      -    "type": "object"
      -  },
      -  "name": {
      -    "description": "Query operators for name field of type Name. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "John Doe"
      -    },
      -    "type": "object"
      -  },
      -  "projectId": {
      -    "description": "Query operators for projectId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      -    },
      -    "type": "object"
      -  },
      -  "runCount": {
      -    "description": "Query operators for runCount field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": 50
      -    },
      -    "type": "object"
      -  },
      -  "steps": {
      -    "description": "Query operators for steps field of type JSON. Supported operators: EqualTo, NotEqual, IsNull, NotNull",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "example_value_1"
      -    },
      -    "type": "object"
      -  },
      -  "trigger": {
      -    "description": "Query operators for trigger field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "John Doe"
      -    },
      -    "type": "object"
      -  },
      -  "updatedAt": {
      -    "description": "Query operators for updatedAt field of type Date. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": "2023-01-01T00:00:00.000Z"
      -    },
      -    "type": "object"
      -  },
      -  "version": {
      -    "description": "Query operators for version field of type Number. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, InBetween",
      -    "example": {
      -      "_type": "EqualTo",
      -      "value": 50
      -    },
      -    "type": "object"
      -  }
      -}
  3. Changed2 schema fields changed
    • removedInput schema / properties / query / properties / minimumPriority
      Removed value: -{
      -  "description": "Query operators for minimumPriority field of type Text. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Search, Includes",
      -  "example": {
      -    "_type": "EqualTo",
      -    "value": "John Doe"
      -  },
      -  "type": "object"
      -}
    • addedInput schema / properties / query / properties / minimumSecurityCasePriorityId
      Added value: +{
      +  "description": "Query operators for minimumSecurityCasePriorityId field of type Object ID. Supported operators: EqualTo, NotEqual, IsNull, NotNull, EqualToOrNull, Includes",
      +  "example": {
      +    "_type": "EqualTo",
      +    "value": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa"
      +  },
      +  "type": "object"
      +}
  4. First observed

TDQS

B3.2/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so safety is covered structurally. The description adds only the fact that the filter is optional and that counting over the full set is possible; it says nothing about return shape, cost, or pagination limits.

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?

One short sentence, front-loaded with the verb and resource, with the qualifier ('all or those a filter matches') earning its place. Nothing is wasted, though it is terse to the point of being under-specified rather than over-written.

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

Completeness3/5

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

There is no output schema, so the description should say what a count returns (a bare number versus an object with metadata), and it does not. For a single-parameter, annotation-covered read tool this is a modest but real gap.

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% and the single 'query' parameter already documents its operator form and points to oneuptime_describe_resource for field names. The description's phrase 'those a filter matches' only restates that the parameter is a filter, adding no new semantics.

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?

States a specific verb and resource ('Count Security Playbooks') plus the scope ('all or those a filter matches'), which is enough to distinguish it from a get/list at a glance. It does not explicitly contrast with the sibling list_security_playbooks, so it stops short of 5.

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

Usage Guidelines2/5

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

No when-to-use or when-not guidance is given, and no alternative is named. The agent must infer from the name alone that this is the cardinality variant versus list_security_playbooks for full records.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.