Postmancer

Name: Postmancer
Author: hijaz

@hijaz

Repository

About Postmancer

An experimental MCP server Rest Client intended to be a replacement of tools postman & insomnia

#mcp #postman #rest-client #insomnia

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "postmancer": {
      "command": "npx",
      "args": [
        "postmancer"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Postmancer?

Postmancer is a standalone MCP server for API testing and management, allowing AI assistants like Claude to make HTTP requests, manage collections of API endpoints, and test API responses through natural language. It offers similar functionality to tools like Postman or Insomnia but is designed specifically for AI assistants.

How to use Postmancer?

Install globally with npm install -g postmancer or run directly with npx postmancer. For Claude Desktop, add a configuration entry with "command": "npx", "args": ["-y", "postmancer"] to the MCP server list. Alternatively, run with Docker using docker run -i --rm --mount type=bind,src=/path/to/collections,dst=/data/collections postmancer.

Key features of Postmancer

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

Use cases of Postmancer

AI assistant testing and debugging REST APIs via natural language
Managing a collection of reusable API endpoints
Running saved requests with environment variable substitution
Using different authentication methods for API testing
Maintaining request/response history for auditing or debugging

FAQ from Postmancer

What is Postmancer used for?

Postmancer allows AI assistants to make HTTP requests, manage API endpoint collections, and test API responses, functioning like a Postman for AI agents.

How do I install Postmancer?

Install globally with npm install -g postmancer or run on the fly with npx postmancer. It can also be run via Docker.

Where does Postmancer store data?

Collections and environment variables are stored in the path specified by the COLLECTIONS_PATH environment variable (default: ~/.postmancer).

What authentication methods are supported?

Postmancer supports Basic, Bearer, API Key, and OAuth2 authentication methods.

How can I secure sensitive data in Postmancer?

Set POSTMANCER_ENCRYPTION_KEY to encrypt credentials and tokens, and ENCRYPTION_KEY to encrypt environment variables marked as secrets. If not provided, random or default keys are used, which is less secure.