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

Install dependencies:

npm install

Build the server:

npm run build

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

Install dependencies:

npm install

Make changes to src/index.ts
Build the server:

npm run build

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.

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

generate_ai_tool

Related Resources

Reddit Discussion about this server

Related MCP Servers

Scrapling Fetch MCP
cyberchitta
-
security
A
license
-
quality
An MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.
Last updated -
1
Python
Apache 2.0
systemprompt-mcp-reddit
Ejb503
-
security
F
license
-
quality
A specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.
Last updated -
71
5
TypeScript
ServiceTitan MCP Server
JordanDalton
A
security
F
license
A
quality
An MCP server that allows AI assistants to interact with the ServiceTitan API, requiring client credentials for authentication.
Last updated -
454
TypeScript
Notion MCP Serverofficial
makenotion
A
security
A
license
A
quality
An MCP server that enables AI assistants to interact with the Notion API, allowing them to search, read, comment on, and create content in Notion workspaces through natural language commands.
Last updated -
19
13,722
1,775
TypeScript
MIT License

View all related MCP servers

Postman Tool Generation MCP Server