Skip to main content
Glama

List release policies

list_policies
Read-onlyIdempotent

List the release policies that evaluate every publish of an organization, and the checkers it can configure: Valet's own, and the organization's, which set_checker adds. An organization checker shows its URL, its headers (a credential header shows only its references), the release files it was approved to receive, and why it is unavailable or what its last call got wrong. Each policy shows its checker, its enforcement (monitor, or block at a severity), its settings, and how its evaluations came out over the last 30 days. A secret setting shows as (set), never its value. Call it before publishing to see what will be evaluated, and fix what you can first. A blocking policy refuses a release with a finding at or above its severity; a monitor policy reports and never refuses. Requires connecting a Valet account.

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": "list_policies"
  }
}

Input Schema

NameRequiredDescriptionDefault
org_nameNoThe Valet organization whose release policies to list. Omit to use the organization the account joined first.

Output Schema

NameRequiredDescriptionDefault
orgYesName of the Valet organization the call acted in.
checkersYesThe checkers a policy can run: Valet's own and the organization's.
policiesYesThe organization's release policies. Empty when it has none, so no publish is evaluated.
redactionsYesHow many credentials were replaced with [redacted] in the text this answer was built from: secret values the service holds, and strings shaped like an API key, a private key, a token, or a password in a URL or header. Redaction is best effort, so 0 does not prove the text holds no credential.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedOutput schema / properties / policies / items / properties / read_only
      Added value: +{
      +  "description": "True for installation policies; only a Valet administrator can change them.",
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / policies / items / properties / scope
      Added value: +{
      +  "description": "installation or org; installation policies apply to every org.",
      +  "type": "string"
      +}
    • changedOutput schema / properties / policies / items / required
      Previous value: -[
      -  "name",
      -  "checker",
      -  "enforcement",
      -  "applies_to",
      -  "settings",
      -  "recent"
      -]New value: +[
      +  "scope",
      +  "read_only",
      +  "name",
      +  "checker",
      +  "enforcement",
      +  "applies_to",
      +  "settings",
      +  "recent"
      +]
  2. Changed4 schema fields changed
    • changedOutput schema / properties / checkers / items / properties / last_error / description
      Previous value: -"What the organization checker's last call got wrong. Absent when nothing is recorded."New value: +"What the organization checker's last call got wrong, with credentials redacted as [redacted]. Absent when nothing is recorded."
    • changedOutput schema / properties / policies / items / properties / recent / properties / last_error / description
      Previous value: -"Why the latest errored evaluation could not run. Empty when none errored."New value: +"Why the latest errored evaluation could not run, with credentials redacted as [redacted]. Empty when none errored."
    • addedOutput schema / properties / redactions
      Added value: +{
      +  "description": "How many credentials were replaced with [redacted] in the text this answer was built from: secret values the service holds, and strings shaped like an API key, a private key, a token, or a password in a URL or header. Redaction is best effort, so 0 does not prove the text holds no credential.",
      +  "type": "integer"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "org",
      -  "policies",
      -  "checkers"
      -]New value: +[
      +  "org",
      +  "policies",
      +  "checkers",
      +  "redactions"
      +]
  3. Changed32 schema fields changed
    • addedOutput schema / properties / checkers / description
      Added value: +"The checkers a policy can run: Valet's own and the organization's."
    • addedOutput schema / properties / checkers / items / properties / described_at / description
      Added value: +"When Valet last tried to describe an organization checker endpoint, as an RFC 3339 time, whether or not it worked. Absent for a Valet checker."
    • addedOutput schema / properties / checkers / items / properties / description / description
      Added value: +"What the checker does."
    • addedOutput schema / properties / checkers / items / properties / display_name / description
      Added value: +"The name a person reads. Empty when the checker declares none."
    • addedOutput schema / properties / checkers / items / properties / fields / description
      Added value: +"The settings a policy can give this checker."
    • addedOutput schema / properties / checkers / items / properties / fields / items / properties / description / description
      Added value: +"What the setting is for. Empty when the checker gives none."
    • addedOutput schema / properties / checkers / items / properties / fields / items / properties / name / description
      Added value: +"The setting's name, which set_policy takes as a key of settings."
    • addedOutput schema / properties / checkers / items / properties / fields / items / properties / required / description
      Added value: +"True when a policy must give this setting."
    • addedOutput schema / properties / checkers / items / properties / fields / items / properties / secret / description
      Added value: +"True when a person enters the value on a request page, not in settings."
    • addedOutput schema / properties / checkers / items / properties / headers / description
      Added value: +"An organization checker's headers, by name. A credential header shows only its {{NAME}} references and scheme word. Absent when there are none."
    • addedOutput schema / properties / checkers / items / properties / inputs / description
      Added value: +"The release files an organization checker was approved to receive: source, build, or both. Absent when it asked for none."
    • addedOutput schema / properties / checkers / items / properties / last_error / description
      Added value: +"What the organization checker's last call got wrong. Absent when nothing is recorded."
    • addedOutput schema / properties / checkers / items / properties / name / description
      Added value: +"The checker's name as a policy spells it, such as catalog:secrets or org:snyk."
    • addedOutput schema / properties / checkers / items / properties / origin / description
      Added value: +"Who provides the checker: valet for Valet's own, organization for one the organization added with set_checker."
    • addedOutput schema / properties / checkers / items / properties / unavailable / description
      Added value: +"Why a policy cannot use the checker now. Absent when it can."
    • addedOutput schema / properties / checkers / items / properties / url / description
      Added value: +"An organization checker's base URL. Absent for a Valet checker, or when the stored checkers could not be read."
    • addedOutput schema / properties / org / description
      Added value: +"Name of the Valet organization the call acted in."
    • addedOutput schema / properties / policies / description
      Added value: +"The organization's release policies. Empty when it has none, so no publish is evaluated."
    • addedOutput schema / properties / policies / items / properties / applies_to / description
      Added value: +"Which releases the policy evaluates. every_release means every publish."
    • addedOutput schema / properties / policies / items / properties / block_at / description
      Added value: +"The lowest severity that blocks: info, low, medium, high, or critical. Absent for a monitor policy."
    • addedOutput schema / properties / policies / items / properties / checker / description
      Added value: +"The checker the policy runs, spelled as set_policy takes it, such as catalog:secrets or org:snyk."
    • addedOutput schema / properties / policies / items / properties / enforcement / description
      Added value: +"monitor records findings and never refuses a release. block refuses a release with a finding at or above block_at."
    • addedOutput schema / properties / policies / items / properties / name / description
      Added value: +"The policy's name, which destroy_policy takes."
    • addedOutput schema / properties / policies / items / properties / recent / description
      Added value: +"How this policy's evaluations came out over the last 30 days."
    • addedOutput schema / properties / policies / items / properties / recent / properties / at_or_above / description
      Added value: +"Evaluations that found a finding at or above each severity, keyed by info, low, medium, high, and critical."
    • addedOutput schema / properties / policies / items / properties / recent / properties / blocked / description
      Added value: +"Evaluations that refused the release."
    • addedOutput schema / properties / policies / items / properties / recent / properties / errored / description
      Added value: +"Evaluations that could not run to a decision."
    • addedOutput schema / properties / policies / items / properties / recent / properties / evaluations / description
      Added value: +"Evaluations of releases in the last 30 days."
    • addedOutput schema / properties / policies / items / properties / recent / properties / in_progress / description
      Added value: +"Evaluations still pending or running."
    • addedOutput schema / properties / policies / items / properties / recent / properties / last_error / description
      Added value: +"Why the latest errored evaluation could not run. Empty when none errored."
    • addedOutput schema / properties / policies / items / properties / recent / properties / passed / description
      Added value: +"Evaluations that let the release go ahead."
    • addedOutput schema / properties / policies / items / properties / settings / description
      Added value: +"The policy's checker settings, by field name. A secret field shows (set), never its value."
  4. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "checkers": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "described_at": {
      +            "type": "string"
      +          },
      +          "description": {
      +            "type": "string"
      +          },
      +          "display_name": {
      +            "type": "string"
      +          },
      +          "fields": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "description": {
      +                  "type": "string"
      +                },
      +                "name": {
      +                  "type": "string"
      +                },
      +                "required": {
      +                  "type": "boolean"
      +                },
      +                "secret": {
      +                  "type": "boolean"
      +                }
      +              },
      +              "required": [
      +                "name",
      +                "description",
      +                "required",
      +                "secret"
      +              ],
      +              "type": "object"
      +            },
      +            "type": [
      +              "null",
      +              "array"
      +            ]
      +          },
      +          "headers": {
      +            "additionalProperties": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          },
      +          "inputs": {
      +            "items": {
      +              "type": "string"
      +            },
      +            "type": [
      +              "null",
      +              "array"
      +            ]
      +          },
      +          "last_error": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "origin": {
      +            "type": "string"
      +          },
      +          "unavailable": {
      +            "type": "string"
      +          },
      +          "url": {
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "display_name",
      +          "description",
      +          "fields",
      +          "origin"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    },
      +    "org": {
      +      "type": "string"
      +    },
      +    "policies": {
      +      "items": {
      +        "additionalProperties": false,
      +        "properties": {
      +          "applies_to": {
      +            "type": "string"
      +          },
      +          "block_at": {
      +            "type": "string"
      +          },
      +          "checker": {
      +            "type": "string"
      +          },
      +          "enforcement": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "recent": {
      +            "additionalProperties": false,
      +            "properties": {
      +              "at_or_above": {
      +                "additionalProperties": {
      +                  "type": "integer"
      +                },
      +                "type": "object"
      +              },
      +              "blocked": {
      +                "type": "integer"
      +              },
      +              "errored": {
      +                "type": "integer"
      +              },
      +              "evaluations": {
      +                "type": "integer"
      +              },
      +              "in_progress": {
      +                "type": "integer"
      +              },
      +              "last_error": {
      +                "type": "string"
      +              },
      +              "passed": {
      +                "type": "integer"
      +              }
      +            },
      +            "required": [
      +              "evaluations",
      +              "passed",
      +              "blocked",
      +              "errored",
      +              "in_progress",
      +              "last_error",
      +              "at_or_above"
      +            ],
      +            "type": "object"
      +          },
      +          "settings": {
      +            "additionalProperties": {
      +              "type": "string"
      +            },
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "name",
      +          "checker",
      +          "enforcement",
      +          "applies_to",
      +          "settings",
      +          "recent"
      +        ],
      +        "type": "object"
      +      },
      +      "type": [
      +        "null",
      +        "array"
      +      ]
      +    }
      +  },
      +  "required": [
      +    "org",
      +    "policies",
      +    "checkers"
      +  ],
      +  "type": "object"
      +}
  5. Added

TDQS

A4.4/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive/closed-world, but the description adds substantive behavior beyond them: secret values are masked as '(set)', an unavailable checker reports why and what its last call got wrong, and a credential header exposes only references. It also discloses an auth prerequisite ('Requires connecting a Valet account') and explains the blocking-vs-monitor enforcement distinction, which determines what the returned policies actually mean.

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?

The purpose is front-loaded and every sentence carries information, but the body is a single dense paragraph packing checker behavior, masking, enforcement semantics, and auth into one block. Splitting the return-shape details from the usage guidance would make it easier to scan; nothing is genuinely redundant.

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

Completeness5/5

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

For a read-only, zero-required-param list tool with an output schema present, the description covers what an agent needs: when to call it, what each policy entry contains, how secrets are handled, and that a Valet account connection is required. Return format details are correctly left to the output schema.

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 coverage is 100% and the single org_name parameter is fully documented in the schema, including the omit-to-use-default behavior. The description never mentions org_name or adds scoping nuance beyond the schema, so the baseline 3 applies rather than a higher score.

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

Purpose5/5

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

States a specific verb and resource ('List the release policies that evaluate every publish of an organization') and immediately scopes what those policies contain: checkers, enforcement, settings, and 30-day evaluation outcomes. It even distinguishes the two checker sources (Valet's own vs. the organization's, added by set_checker), so an agent can tell this apart from sibling tools such as destroy_policy or set_checker.

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?

Gives explicit timing guidance: 'Call it before publishing to see what will be evaluated, and fix what you can first.' That is a clear actionable context plus the reason to use it. It stops short of naming an alternative tool or stating when not to call it, which keeps it from a 5.

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