Postman Tool Generation

by giovannicocco

13 stars

308 downloads

Not rated

GitHub

About

Integrates with Postman Tool Generation API to convert API collections into type-safe code for AI frameworks, enabling rapid development of AI-powered tools from existing API documentation.

Details

Author: giovannicocco
Repository: giovannicocco/mcp-server-postman-tool-generation
GitHub stars: 13
Downloads: 308
License: MIT License
Categories: Developer Tools, API, Automation, Productivity, Design, Workplace, File Management, AI, Knowledge Base, Other
Tags: #integration

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name Postman Tool Generation

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /path/to/postman-tool-generation-server/build/index.js
Environment
- POSTMAN_API_KEY your-postman-api-key
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install dependencies with npm install, build the server with npm run build, then configure the MCP settings file (e.g., cline_mcp_settings.json) with a postman-ai-tools entry pointing to the built index.js and providing a POSTMAN_API_KEY environment variable. The server exposes a single tool called generate_ai_tool, which accepts collectionId, requestId, language ("javascript" or "typescript"), and agentFramework (one of "openai", "mistral", "gemini", "anthropic", "langchain", "autogen").

`generate_ai_tool`

Generates type-safe code from Postman collections. Parameters: collectionId (string), requestId (string), language (string - 'javascript' or 'typescript'), agentFramework (string - '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": {
            "env": {
                "POSTMAN_API_KEY": "your-postman-api-key"
            },
            "args": [
                "/path/to/postman-tool-generation-server/build/index.js"
            ],
            "command": "node"
        }
    }
}

Linux

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

Macos

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

Windows

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

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 anew, standardized protocolfor 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

- 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
- 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": [] } } }

The server provides a single tool calledgenerate_ai_toolwith 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 }

// 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" } });

The tool generates type-safe code that includes:

- Type definitions for request/response
- Error handling
- API integration
- OpenAI function definitions
- Documentation and examples
- Restart the Claude app to load the updated server

- POSTMAN_API_KEY: Your Postman API key (required)

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.

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

This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.

The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.

One remote MCP server for 500+ production APIs — Stripe, HubSpot, Postgres, Gmail, and more. OAuth and API key auth, credential management, and a CLI.

Single tool to control all 100+ API integrations, and UI components

Agent-native developer Q&A API with MCP + A2A endpoints for citations, job pickup, and answer submission.

Self-hosted MCP gateway: convert REST/SOAP/GraphQL/SQL APIs into MCP tools with 29 pre-built adapters, OAuth2, RBAC and audit log.

A universal bridge to convert any web API into an MCP server, supporting multiple transport types.

Dynamically creates MCP servers from web API configurations, integrating any REST API, GraphQL endpoint, or web service into MCP-compatible tools.

Hosted MCP server and coordination layer for AI coding agents — live API contracts, database schema, frontend/backend mismatch detection, and shared handoff tickets for Claude Code, Cursor, Codex, and Lovable.

An MCP server that dynamically loads tools from an external JSON file configured via an environment variable.

A lightweight server exposing Axone's capabilities through the Model-Context Protocol.

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

generate_ai_tool

Claude Desktop / Cursor

Linux

Macos

Windows

Install

More like this

@mendableai/firecrawl Mcp Server

Umut Naci

Playwright

Sentry

Github

Fetch

`generate_ai_tool`