Skip to main content
Glama

Analyze resource

analyze_resource
Read-onlyIdempotent

Check whether a resource and everything it depends on is sound — the deployability question. Pass 'hypothetical' to preview a change instead: hypothetical='delete' or 'unpublish' reports what would break WITHOUT changing anything (run it before deleting something other resources may use), and hypothetical='publish' checks whether the draft you are about to publish actually resolves. An APP is the usual subject: it walks every root the app contains (endpoints, schedules, domains) to the end of each chain and reports what would break. Returns findings {resource, path, severity, check, message}: errors are broken now (a reference that does not resolve, a dependency never published, a declared domain that routes elsewhere, a step naming a resource outside its workflow's scope, a call to a workflow that continues, which cannot run as a sub-workflow), warnings are risks (a published resource following @latest, a sub-workflow call cycle, a domain not yet verified, a sub-workflow step that the scope it runs under for one caller will refuse), info is advisory. deployable is true when there are no errors. Also reports incomplete_nodes: resources whose references are built at run time and so cannot be checked statically. For a non-root subject like a workflow, analysis starts there rather than from whatever reaches it, so severities are not weighted by reachability.

Input Schema

NameRequiredDescriptionDefault
kindYesthe kind of resource to analyze: app, dynamic_endpoint, schedule, custom_domain, workflow, api_template, datafile, schema, secret. An app is the usual subject
resourceYesslug of the resource, optionally with a version suffix (e.g. 'shop/storefront' or 'shop/storefront@latest'); a bare slug means @published. For a custom_domain this is the hostname
hypotheticalNoinstead of checking the resource as it is, evaluate a change you are considering: 'delete' or 'unpublish' report what would break (nothing is changed — this is a preview), 'publish' checks whether the DRAFT resolves and flags what already follows this at @published. Run this before a delete or a publish

Output Schema

NameRequiredDescriptionDefault
infosYes
errorsYes
subjectYes
findingsYes
warningsYes
deployableYes
incomplete_nodesYes
reachability_knownYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.7/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, and the description goes well beyond them: it enumerates what counts as error vs warning vs info, states deployable is true only with no errors, notes incomplete_nodes for run-time-built references, and warns that severities for non-root subjects are not weighted by reachability. No contradiction with readOnlyHint — the hypothetical modes explicitly change nothing.

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-loaded and dense with useful content, but the middle sentence is a single run-on enumeration of parenthetical examples that is hard to scan. The severity taxonomy would be far more usable as a short list; some examples (domain routing elsewhere, @latest following) earn their place, others pad the sentence.

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?

Covers subject scope, the hypothetical modes, the findings shape, severity semantics, the deployable flag, incomplete_nodes, and the reachability caveat for non-root subjects. Combined with an output schema, an agent has everything needed to call this correctly and interpret results.

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?

Schema coverage is 100%, so baseline is 3; the description still adds meaning by framing hypothetical='delete'/'unpublish' as a no-op preview and 'publish' as a draft-resolution check, and by calling out app as the usual kind. It adds context but does not restate the slug/version syntax, which the schema already handles.

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+resource+question ('check whether a resource and everything it depends on is sound — the deployability question') and explains the subject kinds, including that an APP is the usual one and that roots are walked to the end of each chain. This is clearly distinguishable from siblings like validate_workflow or get_resource_graph, which are read/get or narrower validation tools.

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

Usage Guidelines5/5

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

Explicit routing: 'Pass hypothetical to preview a change instead', 'run it before deleting something other resources may use', and hypothetical='publish' checks the draft you are about to publish. It also names the condition under which non-root subjects are analyzed, so the agent knows when this tool applies versus a plain get.

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