Skip to main content
Glama

Run a Postman Collection Folder

run_folder

Execute all requests in a Postman collection folder, resolve variables, run pre-request scripts, and return structured test results.

Instructions

Execute every request in a collection folder and return structured results. Resolves {{variables}}, runs the collection + item pre-request scripts (so token auth works), fires each request, and evaluates the embedded pm.test scripts. Target the folder by folderName (typically the Jira ticket key, e.g. 'JIRA-12345') or folderId.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
folderIdNoExplicit folder id (use when folder names are ambiguous).
collectionYesPostman collection v2.1 JSON (the `collection` object from the Postman API / connector's getCollection).
folderNameNoFolder name to run (typically the Jira ticket key).
allowWritesNoExplicitly allow POST/PUT/PATCH/DELETE requests for this exact run.
environmentNoOptional Postman environment JSON (the `environment` object from getEnvironment) supplying base URL, auth and variables.
approvalNoteNoShort note naming who/what approved the target and methods.
allowProductionNoExplicitly allow production-like target URLs/auth URLs for this exact run.
timeoutRequestMsNoPer-request timeout in ms (default 30000).
Behavior4/5

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

The description adds valuable behavior beyond annotations: it resoles variables, runs pre-request scripts for token auth, fires requests, and evaluates pm.test scripts. Annotations are sparse (readOnlyHint false, destructiveHint false), and the description enriches the safety profile without contradicting it.

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

Conciseness5/5

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

The description is two concise sentences. The first sentence front-loads the purpose and behavior, the second explains targeting. No fluff or repetition of schema details.

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 description covers the core workflow (execution, scripts, return of structured results) and leverages rich schema annotations. It does not detail return structure (no output schema) or safety workflow, but the parameter schema covers those gaps adequately.

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 the baseline is 3. The description adds useful semantic context for folderName (typically a Jira ticket key) and folderId (for ambiguous names), going beyond the schema descriptions.

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?

The description states a specific verb ('Execute') and resource ('collection folder'), and clearly distinguishes from siblings by noting it runs every request and evaluates pm.test scripts. This is a clear, non-tautological purpose statement.

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 description implies the tool is for running a full folder and provides targeting guidance (folderName typically a Jira key, or folderId). It does not explicitly state exclusions or alternatives, but the context is unambiguous for choosing between this and run_request.

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tezaswiraj7222/mcp-postman-runner'

If you have feedback or need assistance with the MCP directory API, please join our Discord server