Log inSubmit server
Postmancer logo

Postmancer

by hijaz

Manage REST API requests, collections, templates, variables, and response tests through an MCP-compatible AI assistant.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Postmancer

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "hijaz-postmancer": {
      "command": "npx",
      "args": [
        "-y",
        "postmancer"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 7 tools correctly (1mo ago).

Overview

The hijaz/postmancer MCP server lets AI assistants send HTTP requests, organize reusable API requests into collections, and test REST API responses. It exposes MCP tools for direct requests, collection management, saved-request execution, and environment-variable handling. Requests can use Basic, Bearer, API key, or OAuth2 authentication, with configurable encryption for stored credentials and secret variables. Reach for it when an AI assistant needs a Postman- or Insomnia-style workflow for API testing and management.

Use cases

  • Send exploratory requests to REST endpoints
  • Organize reusable API calls into collections
  • Execute saved requests during API checks
  • Set variables for request templates
  • Test API responses through an AI assistant

Key features

  • Direct HTTP requests to arbitrary URLs
  • Saved API request collections
  • Environment-variable substitution
  • Basic, Bearer, API key, and OAuth2 authentication
  • Configurable encryption for credentials and secrets
  • Docker and npm-based local setup

Tools7

What Postmancer lets your agent do. Expand a tool for its parameters.

Verified live~1.2k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/20 checks healthy over the last 85d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · postmancer (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars29Stargazers on the source repository.
npm downloads39Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed7Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Postmancer works

What hijaz/postmancer MCP server does

The hijaz/postmancer MCP server gives AI assistants an MCP interface for working with REST APIs. It can send a request directly to any URL, or execute a request saved in a named collection. Collections provide a way to organize reusable API calls instead of rebuilding each request during a conversation.

The server also supports request templates that use environment variables. An assistant can list existing variables, set new values, and reuse those values when working with saved requests. It also lists request and response history and testing among the available capabilities.

How it works

An MCP-compatible client starts Postmancer as a local process and communicates with it through the server's exposed tools. The direct request tool accepts a URL and sends the HTTP request. Collection-oriented tools let the assistant inspect available collections, enumerate the requests in one collection, save a new request, and run a saved request later.

Collection data is stored under the configured collections directory. If no directory is specified, the default location is ~/.postmancer. Environment variables are available for request templating, and variables marked as secrets can be encrypted. Credentials and tokens use a separate encryption setting. The server generates random encryption keys when the relevant settings are absent, although the documentation recommends explicitly configuring keys in production.

This workflow suits API exploration, repeatable endpoint checks, and assistants that need to retain request definitions across sessions. It does not describe a hosted API or a remote service; the supplied setup runs the MCP server locally through npm or Docker.

Setup and configuration

The hijaz/postmancer MCP server can be installed globally with npm using npm install -g postmancer, or started directly with npx postmancer. The documented non-interactive Claude Desktop configuration uses npx with -y and the postmancer package. Claude Desktop configuration files are located at %USERPROFILE%\.claude\claude_desktop_config.json on Windows and ~/.claude/claude_desktop_config.json on macOS and Linux.

Docker is also supported. The example uses a placeholder host path, which must be replaced when configuring a real mount.

Configuration options include COLLECTIONS_PATH for collection storage and LOG_LEVEL for debug, info, warn, or error logging. POSTMANCER_ENCRYPTION_KEY protects credentials and tokens, while ENCRYPTION_KEY protects secret environment variables. Both logging and storage settings have defaults; the encryption settings also have fallback behavior when omitted.

Tools and capabilities

  • Send HTTP requests to any URL with http_request.
  • List saved collections with list_collections.
  • Inspect requests inside a collection with list_requests.
  • Store a request with save_request.
  • Execute a saved request with request_from_collection.
  • Set template variables with set_environment_variable.
  • Read available variables with get_environment_variables.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Postmancer

Install it globally with `npm install -g postmancer`, or run it directly with `npx postmancer`. Docker is also supported.

Yes. The README provides Claude Desktop configuration using `npx`, the `postmancer` package, and the `-y` flag.

It supports `COLLECTIONS_PATH`, `LOG_LEVEL`, `POSTMANCER_ENCRYPTION_KEY`, and `ENCRYPTION_KEY`. Defaults are available when these variables are not set.

Yes. It can create collections, save requests, list requests in a collection, and execute saved requests.

Related MCP servers

All in Developer Tools All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewPostmancer AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/hijaz-postmancer?style=directory)](https://allmcps.com/mcp/hijaz-postmancer)
HTML Embed
<a href="https://allmcps.com/mcp/hijaz-postmancer"><img src="https://allmcps.com/api/badge/hijaz-postmancer?style=directory" alt="Postmancer on AllMCPs" /></a>