Postmancer

Postmancer

A standalone MCP server for API testing and management via AI assistants.

28
Stars
4
Forks
28
Watchers
1
Issues
Postmancer is a Model Context Protocol (MCP) server designed to facilitate API testing and management through natural language interactions with AI assistants. It enables HTTP requests, organizes API endpoints into collections, and provides tools for managing environment variables, authentication, and request history. Postmancer is particularly aimed at integrating with AI platforms like Claude for seamless, automated API workflows.

Key Features

Send HTTP requests to any REST API
Organize and save requests in collections
Variable substitution via environment variables
Supports multiple authentication methods (Basic, Bearer, API Key, OAuth2)
Request and response history tracking
CLI and Docker deployment options
Integration with AI assistants like Claude
Encrypted credential and token storage
Collection and request listing
Execute saved requests from collections

Use Cases

Automated API testing through AI assistants
Managing and organizing complex API workflows
Natural language control over API endpoints for developers
Secured handling of API credentials and secrets
Environment variable management for API requests
Collaborating on API collections within teams
API request and collection history tracking
Script-less API automation by non-technical users
Integrating with Claude Desktop for conversational API management
Rapid prototyping and testing of RESTful services

README

MseeP.ai Security Assessment Badge

Postmancer

Trust Score

Postmancer

A standalone MCP server for API testing and management, allowing AI assistants to interact with RESTful APIs through natural language.

Overview

Postmancer is an MCP (Model Context Protocol) server that enables AI assistants like Claude to make HTTP requests, manage collections of API endpoints, and test API responses. It provides similar functionality to tools like Postman or Insomnia but designed specifically for AI assistants.

Features

  • Make HTTP requests to any REST API
  • Save and organize requests in collections
  • Set and use environment variables with variable substitution
  • Multiple authentication methods (Basic, Bearer, API Key, OAuth2)
  • Request/response history and testing

Quick Start

Installation

bash
# Install globally
npm install -g postmancer

# Or run directly with npx
npx postmancer

Using with Claude Desktop

Add this to your Claude Desktop configuration file:

  • Windows: %USERPROFILE%\.claude\claude_desktop_config.json
  • macOS/Linux: ~/.claude/claude_desktop_config.json
json
{
  "mcpServers": {
    "postmancer": {
      "command": "npx",
      "args": ["-y", "postmancer"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

Using with Docker

bash
docker run -i --rm \
  --mount type=bind,src=/path/to/collections,dst=/data/collections \
  postmancer

Available Tools

Postmancer provides the following tools to AI assistants:

  1. http_request - Send HTTP requests to any URL
  2. list_collections - View all your saved API collections
  3. list_requests - View all requests in a collection
  4. save_request - Save a request to a collection
  5. request_from_collection - Execute a saved request
  6. set_environment_variable - Set variables for request templates
  7. get_environment_variables - View all environment variables

Configuration

Configure Postmancer with these environment variables:

  • COLLECTIONS_PATH: Path to store collections (default: ~/.postmancer)
  • LOG_LEVEL: Logging level (debug, info, warn, error) (default: info)
  • POSTMANCER_ENCRYPTION_KEY: Secret key used to encrypt credentials and tokens (generates a random key if not provided)
  • ENCRYPTION_KEY: Secret key used to encrypt environment variables marked as secrets (uses default key if not provided)

For security in production environments, it's strongly recommended to set these encryption keys rather than using the defaults.

License

MIT

Star History

Star History Chart

Repository Owner

hijaz
hijaz

User

Repository Details

Language TypeScript
Default Branch main
Size 151 KB
Contributors 3
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

TypeScript
81.64%
JavaScript
18.02%
Dockerfile
0.27%
Shell
0.07%

Tags

Topics

insomnia mcp postman rest-client

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • Pica MCP Server

    Pica MCP Server

    A Model Context Protocol (MCP) server for seamless integration with 100+ platforms via Pica.

    Pica MCP Server provides a standardized Model Context Protocol (MCP) interface for interaction with a wide range of third-party services through Pica. It enables direct platform integrations, action execution, and intelligent intent detection while prioritizing secure environment variable management. The server also offers features such as code generation, form and data handling, and robust documentation for platform actions. It supports multiple deployment methods, including standalone, Docker, Vercel, and integration with tools like Claude Desktop and Cursor.

    • 8
    • MCP
    • picahq/mcp
  • Stape MCP Server

    Stape MCP Server

    An MCP server implementation for integrating Stape with AI model context protocols.

    Stape MCP Server provides an implementation of the Model Context Protocol server tailored for the Stape platform. It enables secure and standardized access to model context capabilities, allowing integration with tools such as Claude Desktop and Cursor AI. Users can easily configure and authenticate MCP connections using provided configuration samples, while managing context and credentials securely. The server is open source and maintained by the Stape Team under the Apache 2.0 license.

    • 4
    • MCP
    • stape-io/stape-mcp-server
  • OpenAI MCP Server

    OpenAI MCP Server

    Bridge between Claude and OpenAI models using the MCP protocol.

    OpenAI MCP Server enables direct querying of OpenAI language models from Claude via the Model Context Protocol (MCP). It provides a configurable Python server that exposes OpenAI APIs as MCP endpoints. The server is designed for seamless integration, requiring simple configuration updates and environment variable setup. Automated testing is supported to verify connectivity and response from the OpenAI API.

    • 77
    • MCP
    • pierrebrunelle/mcp-server-openai
  • Make MCP Server (legacy)

    Make MCP Server (legacy)

    Enable AI assistants to utilize Make automation workflows as callable tools.

    Make MCP Server (legacy) provides a Model Context Protocol (MCP) server that connects AI assistants with Make scenarios configured for on-demand execution. It parses and exposes scenario parameters, allowing AI systems to invoke automation workflows and receive structured JSON outputs. The server supports secure integration through API keys and facilitates seamless communication between AI and Make's automation platform.

    • 142
    • MCP
    • integromat/make-mcp-server
  • mcp-server-atlassian-confluence

    mcp-server-atlassian-confluence

    Seamlessly connect AI assistants to your Atlassian Confluence knowledge base.

    Enables integration of AI assistants like Claude and Cursor AI directly with Atlassian Confluence, allowing users to interact with their documentation and knowledge base using natural language queries. Supports instant answers, search across all spaces, and access to specific Confluence content and discussions. Follows the Model Context Protocol (MCP) for standardized model context management and easy configuration with various AI assistants via STDIO transport or config files.

    • 39
    • MCP
    • aashari/mcp-server-atlassian-confluence
  • QuantConnect MCP Server

    QuantConnect MCP Server

    Official bridge for secure AI access to QuantConnect's algorithmic trading cloud platform

    QuantConnect MCP Server enables artificial intelligence systems such as Claude and OpenAI to interface with QuantConnect's cloud platform through an official, secure, and dockerized implementation of the Model Context Protocol (MCP). It facilitates automated project management, strategy writing, backtesting, and live deployment by exposing a comprehensive suite of API tools for users with valid access credentials. As the maintained official version, it ensures security, easy deployment, and cross-platform compatibility for advanced algorithmic trading automation.

    • 50
    • MCP
    • QuantConnect/mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results