Postmancer

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/hijaz-postmancer-badge.png)](https://mseep.ai/app/hijaz-postmancer)
2 
3# Postmancer
4[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/hijaz/postmancer)](https://archestra.ai/mcp-catalog/hijaz__postmancer)
5 
6![Postmancer](postmancer.jpg)
7 
8A standalone MCP server for API testing and management, allowing AI assistants to interact with RESTful APIs through natural language.
9 
10## Overview
11 
12Postmancer 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.
13 
14## Features
15 
16- Make HTTP requests to any REST API
17- Save and organize requests in collections
18- Set and use environment variables with variable substitution
19- Multiple authentication methods (Basic, Bearer, API Key, OAuth2)
20- Request/response history and testing
21 
22## Quick Start
23 
24### Installation
25 
26```bash
27# Install globally
28npm install -g postmancer
29 
30# Or run directly with npx
31npx postmancer
32```
33 
34### Using with Claude Desktop
35 
36Add this to your Claude Desktop configuration file:
37- Windows: `%USERPROFILE%\.claude\claude_desktop_config.json`
38- macOS/Linux: `~/.claude/claude_desktop_config.json`
39 
40```json
41{
42  "mcpServers": {
43    "postmancer": {
44      "command": "npx",
45      "args": ["-y", "postmancer"],
46      "env": {
47        "LOG_LEVEL": "info"
48      }
49    }
50  }
51}
52```
53 
54### Using with Docker
55 
56```bash
57docker run -i --rm \
58  --mount type=bind,src=/path/to/collections,dst=/data/collections \
59  postmancer
60```
61 
62## Available Tools
63 
64Postmancer provides the following tools to AI assistants:
65 
661. **http_request** - Send HTTP requests to any URL
672. **list_collections** - View all your saved API collections
683. **list_requests** - View all requests in a collection
694. **save_request** - Save a request to a collection
705. **request_from_collection** - Execute a saved request
716. **set_environment_variable** - Set variables for request templates
727. **get_environment_variables** - View all environment variables
73 
74## Configuration
75 
76Configure Postmancer with these environment variables:
77 
78- `COLLECTIONS_PATH`: Path to store collections (default: ~/.postmancer)
79- `LOG_LEVEL`: Logging level (debug, info, warn, error) (default: info)
80- `POSTMANCER_ENCRYPTION_KEY`: Secret key used to encrypt credentials and tokens (generates a random key if not provided)
81- `ENCRYPTION_KEY`: Secret key used to encrypt environment variables marked as secrets (uses default key if not provided)
82 
83For security in production environments, it's strongly recommended to set these encryption keys rather than using the defaults.
84 
85## License
86 
87MIT