Glama
Sign In

Postman Tool Generation MCP Server

by giovannicocco
Verified
GitHub
JavaScript
MIT License
7
RedditDiscord
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Supports JavaScript code generation for AI tools created from Postman collections, including API integration and error handling.

  • Generates LangChain-compatible tool implementations from Postman API collections, enabling integration with the LangChain framework.

  • Creates OpenAI-compatible function definitions and tool implementations from Postman API collections, with proper error handling and response validation.

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

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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Features
    1. Demo
      1. Setup
        1. Usage
          1. Example
          2. Generated Code
        2. Development
          1. Environment Variables
            1. Error Handling
              1. Contributing
                1. License

                  Related Resources