Skip to main content
Glama

The policies a decision can be made under

list_policies
Read-onlyIdempotent

The policies evaluate_action can be run under, in full: every rule, its id and the sentence it checks. Published deliberately, including to the agents being evaluated — a rule nobody can read is a rule nobody can correct. Free.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault

No arguments

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesEach policy with its slug, version, intent, ceiling, coverage floor and rules.
saysNoWhat these policies are and are not. They are rules a decision is checked against, never a ranking of the agents evaluated under them.
defaultNoThe slug of the policy used when a call names none. Read it rather than assume: the default is an operator setting and can change without any tool changing.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / default / description
      Added value: +"The slug of the policy used when a call names none. Read it rather than assume: the default is an operator setting and can change without any tool changing."
    • addedOutput schema / properties / says / description
      Added value: +"What these policies are and are not. They are rules a decision is checked against, never a ranking of the agents evaluated under them."
  2. Added

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent and non-destructive, so the safety profile is covered. The description adds genuine context beyond them: the disclosure is uncensored ('in full', ids plus the sentence each rule checks), deliberately published even to evaluated agents, and carries no cost.

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?

It is short and front-loads the essential fact (what the policies are and that all are returned). The closing aphorism about unreadable rules is rhetorical justification rather than operational information, a minor bit of flourish.

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?

For a zero-parameter, read-only listing with an output schema that already documents the returned structure, the description supplies everything needed: scope (full set), trust semantics, and cost. Only the absence of any tie-in guidance for evaluate_action keeps it from the top.

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?

There are zero parameters, so the baseline is 4. The description correctly implies a parameterless, whole-set read rather than a filtered one, and adds nothing misleading about inputs.

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 concretely identifies the resource (the policies evaluate_action runs under) and the payload shape ('every rule, its id and the sentence it checks'), which clearly separates it from the evaluate_action sibling. It never says the verb 'list'/'return', but the meaning is unmistakable.

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

Usage Guidelines3/5

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

Usage is only implied through the reference to evaluate_action — an agent can infer you read this to understand what rules will be applied before deciding. There is no explicit when-to-use, when-not, or named alternative, and 'Free' is the only operational hint.

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.

Resources