Skip to main content
Glama
Postman Tool Generation MCP Server

Postman Tool Generation MCP Server

Postman Tool Generation MCP Server

An MCP server that generates AI agent tools from Postman collections and requests. This server integrates with the Postman API to convert API endpoints into type-safe code that can be used with various AI frameworks.

Model Context Protocol (MCP) is a new, standardized protocol for managing context between large language models (LLMs) and external systems. In this repository, we provide an installer as well as an MCP Server for Postman Tool Generation API.

This lets you use Claude Desktop, or any MCP Client like Cline, to use natural language to accomplish things on your Postman account, e.g.:

  • Create an AI tool for: collectionID: 12345-abcde requestID: 67890-fghij typescript openai

Features

  • Generate TypeScript/JavaScript code from Postman collections

  • Support for multiple AI frameworks (OpenAI, Mistral, Gemini, Anthropic, LangChain, AutoGen)

  • Type-safe code generation

  • Error handling and response validation

Related MCP server: Postman MCP Generator

Demo

Setup

  1. Install dependencies:

npm install
  1. Build the server:

npm run build
  1. Configure the MCP settings by adding the following to your Claude settings file (cline_mcp_settings.json):

{
  "mcpServers": {
    "postman-ai-tools": {
      "command": "node",
      "args": [
        "/path/to/postman-tool-generation-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Usage

The server provides a single tool called generate_ai_tool with the following parameters:

{
  collectionId: string;    // The Public API Network collection ID
  requestId: string;       // The public request ID
  language: "javascript" | "typescript";  // Programming language to use
  agentFramework: "openai" | "mistral" | "gemini" | "anthropic" | "langchain" | "autogen";  // AI framework
}

Example

// Using the tool through MCP
const result = await use_mcp_tool({
  server_name: "postman-ai-tools",
  tool_name: "generate_ai_tool",
  arguments: {
    collectionId: "your-collection-id",
    requestId: "your-request-id",
    language: "typescript",
    agentFramework: "openai"
  }
});

Generated Code

The tool generates type-safe code that includes:

  • Type definitions for request/response

  • Error handling

  • API integration

  • OpenAI function definitions

  • Documentation and examples

Development

  1. Install dependencies:

npm install
  1. Make changes to src/index.ts

  2. Build the server:

npm run build
  1. Restart the Claude app to load the updated server

Environment Variables

  • POSTMAN_API_KEY: Your Postman API key (required)

Error Handling

The server includes comprehensive error handling for:

  • Invalid parameters

  • API failures

  • JSON parsing errors

  • Network issues

Error responses include detailed messages to help diagnose issues.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

Available Tools

1 tool
generate_ai_toolB

Generate code for an AI agent tool using a Postman collection and request

Inputs: collectionId (required), requestId (required), language (required), agentFramework (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of ambiguity or overlap with other tools. The tool's purpose is clearly defined and distinct by default.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against for patterns or conventions.

    Tool Count2/5

    One tool is too few for the server's stated purpose of 'Postman Tool Generation,' which implies a broader scope like generating, managing, or testing tools. A single generation tool feels thin and incomplete for this domain.

    Completeness2/5

    The tool surface is severely incomplete for the inferred domain of Postman-based tool generation. There are obvious gaps, such as no tools for listing, editing, deleting, or testing generated tools, which limits agent workflows to a single action.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Automatically converts Postman API collections into MCP-compatible tools for AI assistants. Enables users to interact with any API through natural language by generating JavaScript tools from Postman requests.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Generates MCP servers from Postman API requests, automatically creating JavaScript tools that enable LLMs to interact with any API documented in Postman collections. Supports authentication configuration and deployment via STDIO or SSE.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that converts Postman API requests into executable tools for LLMs using the Postman Runtime. It supports complex authentication types and enables seamless integration between Postman collections and MCP clients like Claude Desktop.
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      A Model Context Protocol (MCP) server that provides seamless integration with the Postman API, enabling AI assistants and applications to interact with Postman workspaces, collections, requests, environments, and folders programmatically.
      19
      27 npm
      31
      MIT