npm mailpal-mcpstdioupdated 24d ago
The honest API client for VS Code. Collections, variables, unlimited history, an MCP server for AI agents, and a free tier that stays free.
What can you do with mailpal?

Why MailPal exists
The most popular REST client for VS Code has 7.4 million installs and a 2.5 star rating, because its free tier slowly moved everything, including your own request history, behind a paywall.
MailPal makes the opposite promise, and treats it like a contract:
- The free tier is fully usable for a single user, forever.
- Unlimited requests, unlimited collections, unlimited local history.
- Pro adds new value only. It never gates access to your own data.
- If a license lapses, Pro features stop. Everything else keeps working.
Highlights
- Full request builder with a Postman-style editor: auto-growing key/value rows, header autocomplete, color-coded JSON editing with format and validation
- Auto headers surfaced, so you see and control everything sent on the wire
- Syntax-highlighted responses (JSON and XML), HTML raw/preview toggle, resizable request/response split
- Per-collection variables with
{{VAR}}placeholders; secret values live in your OS keychain, never in files - Unlimited local history with one-click re-send
- Import Postman v2.1, Thunder Client, OpenAPI 3.x, and curl; export Postman and curl
- Assertions per request with pass/fail on every send
- A bundled MCP server, registered with VS Code agent mode automatically, so AI agents can list, run, and (with Pro) create requests
For AI agents (MCP)
The MCP server also ships standalone on npm as mailpal-mcp:
claude mcp add mailpal -- npx -y mailpal-mcp
Works with any MCP client (Cursor, Claude Desktop, and friends) via npx -y mailpal-mcp.
Support
Questions, bugs, and feature requests: open an issue.
This repository hosts the project's public home, issues, and media. The extension itself ships through the VS Code Marketplace.
Install
Add mailpal to your client. Pick the one you use.
claude mcp add mailpal-mcp -- npx -y mailpal-mcpcodex mcp add mailpal-mcp -- npx -y mailpal-mcpamp mcp add mailpal-mcp -- npx -y mailpal-mcp{
"mcpServers": {
"mailpal-mcp": {
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"mailpal-mcp": {
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"mailpal-mcp","command":"npx","args":["-y","mailpal-mcp"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"mailpal-mcp": {
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"mailpal-mcp": {
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"mailpal-mcp": {
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"mailpal-mcp": {
"type": "local",
"command": "npx",
"args": [
"-y",
"mailpal-mcp"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"mailpal-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"mailpal-mcp"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y mailpal-mcpRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
Score
39 / 100
Incomplete
- Documentation13/25
- Maintenance19/25
- Trust6/20
- Capability0/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 17 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
Version history
| Versions | Published |
|---|---|
| 0.1.1Latest | Aug 15, 2026 |