Postman Tool Generation MCP Server

by MCP-Mirror

305 downloads
Not rated
GitHub

About

This MCP server generates AI agent tools from Postman collections and requests. It integrates with the Postman API to convert API endpoints into type-safe code that can be used with various AI frameworks. It is designed for developers using AI assistants like Claude Desktop or…

Details

Author
MCP-Mirror
Downloads
305
Categories
Other

- Generate TypeScript/JavaScript code from Postman collections
- Supports multiple AI frameworks (OpenAI, Mistral, Gemini, Anthropic, LangChain, AutoGen)
- Type-safe code generation with error handling and response validation
- Generates type definitions, API integration, and documentation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Postman Tool Generation MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies (npm install), build the server (npm run build), then configure the MCP settings in your Claude settings file (cline_mcp_settings.json) with the server command, path, and POSTMAN_API_KEY environment variable. The server provides a single tool called generate_ai_tool, which accepts parameters: collectionId, requestId, language (javascript or typescript), and agentFramework (openai, mistral, gemini, anthropic, langchain, or autogen).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "postman tool generation mcp server": {
            "postman-ai-tools": {
                "command": "node",
                "args": [
                    "/path/to/postman-tool-generation-server/build/index.js"
                ],
                "env": {
                    "POSTMAN_API_KEY": ""
                }
            }
        }
    }
}

McpServers

{
    "postman-ai-tools": {
        "command": "node",
        "args": [
            "/path/to/postman-tool-generation-server/build/index.js"
        ],
        "env": {
            "POSTMAN_API_KEY": ""
        }
    }
}

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.

<a href="https://www.producthunt.com/posts/mcp-server-for-postman-ai-tool-generator?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-mcp&#0045;server&#0045;for&#0045;postman&#0045;ai&#0045;tool&#0045;generator" target="_blank">MCP&#0032;Server&#0032;for&#0032;Postman&#0032;AI&#0032;Tool&#0032;Generator - Convert&#0032;Postman&#0032;APIs&#0032;into&#0032;type&#0045;safe&#0032;AI&#0032;tools&#0032;seamlessly&#0046; | Product Hunt</a>

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

<a href="https://glama.ai/mcp/servers/36hxinm405">Postman Tool Generation Server MCP server</a>

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

<div align="center">
<a href="https://youtu.be/G1O9ECYRk1M" alt="Demonstrating the newly-released MCP server to explore Postman Tool Generation API">
Demonstrating the newly-released MCP server to explore Postman Tool Generation API
</a>
</div>

Setup

1. Install dependencies:

npm install

2. Build the server:

npm run build

3. 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

2. Make changes to src/index.ts

3. Build the server:

npm run build

4. 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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.